SOAPMessage
* object. All messages are required to have a SOAP part, so when a
* SOAPMessage object is created, it will automatically
* have a SOAPPart object.
*
* A SOAPPart object is a MIME part and has the MIME headers
* Content-Id, Content-Location, and Content-Type. Because the value of
* Content-Type must be "text/xml", a SOAPPart object automatically
* has a MIME header of Content-Type with its value set to "text/xml".
* The value must be "text/xml" because content in the SOAP part of a
* message must be in XML format. Content that is not of type "text/xml"
* must be in an AttachmentPart object rather than in the
* SOAPPart object.
*
* When a message is sent, its SOAP part must have the MIME header Content-Type * set to "text/xml". Or, from the other perspective, the SOAP part of any * message that is received must have the MIME header Content-Type with a * value of "text/xml". *
* A client can access the SOAPPart object of a
* SOAPMessage object by
* calling the method SOAPMessage.getSOAPPart. The
* following line of code, in which message is a
* SOAPMessage object, retrieves the SOAP part of a message.
*
* SOAPPart soapPart = message.getSOAPPart();
*
*
* A SOAPPart object contains a SOAPEnvelope object,
* which in turn contains a SOAPBody object and a
* SOAPHeader object.
* The SOAPPart method getEnvelope can be used
* to retrieve the SOAPEnvelope object.
*
*/
// @ts-ignore
abstract class SOAPPart extends java.lang.Object implements org.w3c.dom.Document, javax.xml.soap.Node {
// @ts-ignore
constructor()
/**
* Gets the SOAPEnvelope object associated with this
* SOAPPart object. Once the SOAP envelope is obtained, it
* can be used to get its contents.
* @return the SOAPEnvelope object for this
* SOAPPart object
* @exception SOAPException if there is a SOAP error
*/
// @ts-ignore
public abstract getEnvelope(): javax.xml.soap.SOAPEnvelope
/**
* Retrieves the value of the MIME header whose name is "Content-Id".
* @return a String giving the value of the MIME header
* named "Content-Id"
* @see #setContentId
*/
// @ts-ignore
public getContentId(): string
/**
* Retrieves the value of the MIME header whose name is "Content-Location".
* @return a String giving the value of the MIME header whose
* name is "Content-Location"
* @see #setContentLocation
*/
// @ts-ignore
public getContentLocation(): string
/**
* Sets the value of the MIME header named "Content-Id"
* to the given String.
* @param contentId a String giving the value of the MIME
* header "Content-Id"
* @exception IllegalArgumentException if there is a problem in
* setting the content id
* @see #getContentId
*/
// @ts-ignore
public setContentId(contentId: java.lang.String | string): void
/**
* Sets the value of the MIME header "Content-Location"
* to the given String.
* @param contentLocation a String giving the value
* of the MIME
* header "Content-Location"
* @exception IllegalArgumentException if there is a problem in
* setting the content location.
* @see #getContentLocation
*/
// @ts-ignore
public setContentLocation(contentLocation: java.lang.String | string): void
/**
* Removes all MIME headers that match the given name.
* @param header a String giving the name of the MIME header(s) to
* be removed
*/
// @ts-ignore
public abstract removeMimeHeader(header: java.lang.String | string): void
/**
* Removes all the MimeHeader objects for this
* SOAPEnvelope object.
*/
// @ts-ignore
public abstract removeAllMimeHeaders(): void
/**
* Gets all the values of the MimeHeader object
* in this SOAPPart object that
* is identified by the given String.
* @param name the name of the header; example: "Content-Type"
* @return a String array giving all the values for the
* specified header
* @see #setMimeHeader
*/
// @ts-ignore
public abstract getMimeHeader(name: java.lang.String | string): string[]
/**
* Changes the first header entry that matches the given header name
* so that its value is the given value, adding a new header with the
* given name and value if no
* existing header is a match. If there is a match, this method clears
* all existing values for the first header that matches and sets the
* given value instead. If more than one header has
* the given name, this method removes all of the matching headers after
* the first one.
*
* Note that RFC822 headers can contain only US-ASCII characters.
* @param name a String giving the header name
* for which to search
* @param value a String giving the value to be set.
* This value will be substituted for the current value(s)
* of the first header that is a match if there is one.
* If there is no match, this value will be the value for
* a new MimeHeader object.
* @exception IllegalArgumentException if there was a problem with
* the specified mime header name or value
* @see #getMimeHeader
*/
// @ts-ignore
public abstract setMimeHeader(name: java.lang.String | string, value: java.lang.String | string): void
/**
* Creates a MimeHeader object with the specified
* name and value and adds it to this SOAPPart object.
* If a MimeHeader with the specified name already
* exists, this method adds the specified value to the already
* existing value(s).
*
* Note that RFC822 headers can contain only US-ASCII characters.
* @param name a String giving the header name
* @param value a String giving the value to be set
* or added
* @exception IllegalArgumentException if there was a problem with
* the specified mime header name or value
*/
// @ts-ignore
public abstract addMimeHeader(name: java.lang.String | string, value: java.lang.String | string): void
/**
* Retrieves all the headers for this SOAPPart object
* as an iterator over the MimeHeader objects.
* @return an Iterator object with all of the Mime
* headers for this SOAPPart object
*/
// @ts-ignore
public abstract getAllMimeHeaders(): java.util.IteratorMimeHeader objects that match a name in
* the given array.
* @param names a String array with the name(s) of the
* MIME headers to be returned
* @return all of the MIME headers that match one of the names in the
* given array, returned as an Iterator object
*/
// @ts-ignore
public abstract getMatchingMimeHeaders(names: java.lang.String[] | string[]): java.util.IteratorMimeHeader objects whose name does
* not match a name in the given array.
* @param names a String array with the name(s) of the
* MIME headers not to be returned
* @return all of the MIME headers in this SOAPPart object
* except those that match one of the names in the
* given array. The nonmatching MIME headers are returned as an
* Iterator object.
*/
// @ts-ignore
public abstract getNonMatchingMimeHeaders(names: java.lang.String[] | string[]): java.util.IteratorSOAPEnvelope object with the data
* from the given Source object. This Source
* must contain a valid SOAP document.
* @param source the javax.xml.transform.Source object with the
* data to be set
* @exception SOAPException if there is a problem in setting the source
* @see #getContent
*/
// @ts-ignore
public abstract setContent(source: javax.xml.transform.Source): void
/**
* Returns the content of the SOAPEnvelope as a JAXP Source
* object.
* @return the content as a javax.xml.transform.Source object
* @exception SOAPException if the implementation cannot convert
* the specified Source object
* @see #setContent
*/
// @ts-ignore
public abstract getContent(): javax.xml.transform.Source
}
}
}
}