An object representing the contents in a SOAPBody object, the contents in a
SOAPHeader object, the content that can follow the SOAPBody object in a
SOAPEnvelope object, or what can follow the detail element in a
SOAPFault object. It is the base class for all of the classes that represent the
SOAP objects as defined in the SOAP specification.
addChildElement(Name name) Creates a new SOAPElement object initialized with the given Name
object and adds the new element to this SOAPElement object.
addChildElement(String localName) Creates a new SOAPElement object initialized with the given String
object and adds the new element to this SOAPElement object.
addChildElement(String localName, String prefix) Creates a new SOAPElement object initialized with the specified local name and
prefix and adds the new element to this SOAPElement object.
addChildElement(String localName, String prefix, String uri) Creates a new SOAPElement object initialized with the specified local name,
prefix, and URI and adds the new element to this SOAPElement object.
removeContents() Detaches all children of this SOAPElement.
This method is useful for rolling back the construction of partially completed
SOAPHeaders and SOAPBodys in reparation for sending a fault when an
error condition is detected.
Adds an attribute with the specified name and value to this SOAPElement object.
Parameters: name - a Name object with the name of the attribute Parameters: value - a String giving the value of the attribute the SOAPElement object into which the attribute was inserted throws: SOAPException - if there is an error in creating the Attribute
Creates a new SOAPElement object initialized with the given Name
object and adds the new element to this SOAPElement object.
Parameters: name - a Name object with the XML name for the new element the new SOAPElement object that was created throws: SOAPException - if there is an error in creating the SOAPElement object
Creates a new SOAPElement object initialized with the given String
object and adds the new element to this SOAPElement object.
Parameters: localName - a String giving the local name for the element the new SOAPElement object that was created throws: SOAPException - if there is an error in creating the SOAPElement object
Creates a new SOAPElement object initialized with the specified local name and
prefix and adds the new element to this SOAPElement object.
Parameters: localName - a String giving the local name for the new element Parameters: prefix - a String giving the namespace prefix for the new element the new SOAPElement object that was created throws: SOAPException - if there is an error in creating the SOAPElement object
Creates a new SOAPElement object initialized with the specified local name,
prefix, and URI and adds the new element to this SOAPElement object.
Parameters: localName - a String giving the local name for the new element Parameters: prefix - a String giving the namespace prefix for the new element Parameters: uri - a String giving the URI of the namespace to which the newelement belongs the new SOAPElement object that was created throws: SOAPException - if there is an error in creating the SOAPElement object
Add a SOAPElement as a child of this SOAPElement instance. The
SOAPElement is expected to be created by a SOAPElementFactory.
Callers should not rely on the element instance being added as is into the XML tree.
Implementations could end up copying the content of the SOAPElement passed into
an instance of a different SOAPElement implementation. For instance if
addChildElement() is called on a SOAPHeader, element
will be copied into an instance of a SOAPHeaderElement.
The fragment rooted in element is either added as a whole or not at all, if
there was an error.
The fragment rooted in element cannot contain elements named "Envelope",
"Header" or "Body" and in the SOAP namespace. Any namespace prefixes present in the fragment
should be fully resolved using appropriate namespace declarations within the fragment
itself.
Parameters: element - the SOAPElement to be added as a new child an instance representing the new SOAP element that was actually added to the tree. throws: SOAPException - if there was an error in adding this element as a child
Adds a namespace declaration with the specified prefix and URI to this
SOAPElement object.
Parameters: prefix - a String giving the prefix of the namespace Parameters: uri - a String giving the prefix of the namespace the SOAPElement object into which this namespace declaration wasinserted. throws: SOAPException - if there is an error in creating the namespace
Creates a new Text object initialized with the given String and
adds it to this SOAPElement object.
Parameters: text - a String object with the textual content to be added the SOAPElement object into which the new Text object wasinserted throws: SOAPException - if there is an error in creating the new Text object
Returns an iterator over all of the attribute names in this SOAPElement object.
The iterator can be used to get the attribute names, which can then be passed to the method
getAttributeValue to retrieve the value of each attribute.
an iterator over the names of the attributes
Returns the value of the attribute with the specified name.
Parameters: name - a Name object with the name of the attribute a String giving the value of the specified attribute
Returns an iterator over all the immediate content of this element. This includes
Text objects as well as SOAPElement objects.
an iterator with the content of this SOAPElement object
Returns an iterator over all the child elements with the specified name.
Parameters: name - a Name object with the name of the child elements to be returned an Iterator object over all the elements in thisSOAPElement object with the specified name
Returns the encoding style for this SOAPElement object.
a String giving the encoding style See Also:SOAPElement.setEncodingStyle(String) See Also: setEncodingStyle(java.lang.String)
Returns an iterator of namespace prefixes. The iterator can be used to get the namespace
prefixes, which can then be passed to the method getNamespaceURI to retrieve the
URI of each namespace.
an iterator over the namespace prefixes in this SOAPElement object
Returns the URI of the namespace that has the given prefix.
Parameters: prefix - a String giving the prefix of the namespace for which to search a String with the uri of the namespace that has the given prefix
Returns an Iterator over the namespace prefix Strings visible to
this element. The prefixes returned by this iterator can be passed to the method
getNamespaceURI() to retrieve the URI of each namespace.
an iterator over the namespace prefixes are within scope of thisSOAPElement object
Removes the attribute with the specified name.
Parameters: name - the Name object with the name of the attribute to be removed true if the attribute was removed successfully; false if itwas not
Detaches all children of this SOAPElement.
This method is useful for rolling back the construction of partially completed
SOAPHeaders and SOAPBodys in reparation for sending a fault when an
error condition is detected. It is also useful for recycling portions of a document within a
SOAP message.
Removes the namespace declaration corresponding to the given prefix.
Parameters: prefix - a String giving the prefix for which to search true if the namespace declaration was removed successfully;false if it was not
Sets the encoding style for this SOAPElement object to one specified.
Parameters: encodingStyle - a String giving the encoding style throws: IllegalArgumentException - if there was a problem in the encoding style being set. See Also:SOAPElement.getEncodingStyle() See Also: getEncodingStyle()