-
- All Superinterfaces:
- Node
- All Known Subinterfaces:
- Detail, DetailEntry, SOAPBody, SOAPBodyElement, SOAPElement, SOAPEnvelope, SOAPFault, SOAPFaultElement, SOAPHeader, SOAPHeaderElement, Text
public interface Node extends Node
A representation of a node (element) in an XML document. This interface extnends the standard DOM Node interface with methods for getting and setting the value of a node, for getting and setting the parent of a node, and for removing a node.
-
-
Field Summary
-
Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
-
-
Method Summary
Methods Modifier and Type Method and Description void
detachNode()
Removes thisNode
object from the tree.SOAPElement
getParentElement()
Returns the parent element of thisNode
object.String
getValue()
Returns the value of this node if this is aText
node or the value of the immediate child of this node otherwise.void
recycleNode()
Notifies the implementation that thisNode
object is no longer being used by the application and that the implementation is free to reuse this object for nodes that may be created later.void
setParentElement(SOAPElement parent)
Sets the parent of thisNode
object to the givenSOAPElement
object.void
setValue(String value)
If this is a Text node then this method will set its value, otherwise it sets the value of the immediate (Text) child of this node.-
Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
-
-
-
-
Method Detail
-
getValue
String getValue()
Returns the value of this node if this is aText
node or the value of the immediate child of this node otherwise. If there is an immediate child of thisNode
that it is aText
node then it's value will be returned. If there is more than oneText
node then the value of the firstText
Node will be returned. Otherwisenull
is returned.- Returns:
- a
String
with the text of this node if this is aText
node or the text contained by the first immediate child of thisNode
object that is aText
object if such a child exists;null
otherwise.
-
setValue
void setValue(String value)
If this is a Text node then this method will set its value, otherwise it sets the value of the immediate (Text) child of this node. The value of the immediate child of this node can be set only if, there is one child node and that node is aText
node, or if there are no children in which case a childText
node will be created.- Throws:
IllegalStateException
- if the node is not aText
node and either has more than one child node or has a child node that is not aText
node.- Since:
- SAAJ 1.2
-
setParentElement
void setParentElement(SOAPElement parent) throws SOAPException
Sets the parent of thisNode
object to the givenSOAPElement
object.- Parameters:
parent
- theSOAPElement
object to be set as the parent of thisNode
object- Throws:
SOAPException
- if there is a problem in setting the parent to the given element- See Also:
getParentElement()
-
getParentElement
SOAPElement getParentElement()
Returns the parent element of thisNode
object. This method can throw anUnsupportedOperationException
if the tree is not kept in memory.- Returns:
- the
SOAPElement
object that is the parent of thisNode
object ornull
if thisNode
object is root - Throws:
UnsupportedOperationException
- if the whole tree is not kept in memory- See Also:
setParentElement(javax.xml.soap.SOAPElement)
-
detachNode
void detachNode()
Removes thisNode
object from the tree.
-
recycleNode
void recycleNode()
Notifies the implementation that thisNode
object is no longer being used by the application and that the implementation is free to reuse this object for nodes that may be created later.Calling the method
recycleNode
implies that the methoddetachNode
has been called previously.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/xml/soap/Node.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.