SAAJResult JDK 1.6)

Constructors

public SAAJResult () throws SOAPException

Creates a SAAJResult that will present results in the form of a SAAJ tree that supports the default (SOAP 1.1) protocol.

This kind of SAAJResult is meant for use in situations where the results will be used as a parameter to a method that takes a parameter whose type, such as SOAPElement, is drawn from the SAAJ API. When used in a transformation, the results are populated into the SOAPPart of a SOAPMessage that is created internally. The SOAPPart returned by DOMResult.getNode() is not guaranteed to be well-formed.
Throws:
- SOAPException - if there is a problem creating a SOAPMessage
Since: SAAJ 1.3

public SAAJResult (SOAPElement rootNode)

Creates a SAAJResult that will write the results as a child node of the SOAPElement specified.

Creates a SAAJResult that will write the results as a
child node of the SOAPElement specified. In the normal
case these results will be written using DOM APIs and as a result may
invalidate the structure of the SAAJ tree. This kind of
SAAJResult should only be used when the validity of the
incoming data can be guaranteed by means outside of the SAAJ
specification.
Parameters:
- rootNode - - the root to which the results will be appended
Since: SAAJ 1.3

public SAAJResult (SOAPMessage message)

Creates a SAAJResult that will write the results into the SOAPPart of the supplied SOAPMessage.

Creates a SAAJResult that will write the results into the
SOAPPart of the supplied SOAPMessage.
In the normal case these results will be written using DOM APIs and,
as a result, the finished SOAPPart will not be guaranteed
to be well-formed unless the data used to create it is also well formed.
When used in a transformation the validity of the SOAPMessage
after the transformation can be guaranteed only by means outside SAAJ
specification.
Parameters:
- message - - the message whose SOAPPart will be populated as a result of some transformation or marshalling operation
Since: SAAJ 1.3

public SAAJResult (String protocol) throws SOAPException

Creates a SAAJResult that will present results in the form of a SAAJ tree that supports the specified protocol.

Creates a SAAJResult that will present results in the form of a SAAJ tree that supports the specified protocol. The DYNAMIC_SOAP_PROTOCOL is ambiguous in this context and will cause this constructor to throw an UnsupportedOperationException.

This kind of SAAJResult is meant for use in situations where the results will be used as a parameter to a method that takes a parameter whose type, such as SOAPElement, is drawn from the SAAJ API. When used in a transformation the results are populated into the SOAPPart of a SOAPMessage that is created internally. The SOAPPart returned by DOMResult.getNode() is not guaranteed to be well-formed.
Parameters:
- protocol - - the name of the SOAP protocol that the resulting SAAJ tree should support
Throws:
- SOAPException - if a SOAPMessage supporting the specified protocol cannot be created
Since: SAAJ 1.3

Methods

Hide/Show inherited methods

public Node getNextSibling () [Inherited From DOMResult]

Get the child node before which the result nodes will be inserted.

public Node getNode () [Inherited From DOMResult]

Get the node that will contain the result DOM tree.

public Node getResult ()

public String getSystemId () [Inherited From DOMResult]

Get the System Identifier.

public void setNextSibling (Node nextSibling) [Inherited From DOMResult]

Set the child node before which the result nodes will be inserted.

Use nextSibling to specify the child node before which the result nodes should be inserted. If nextSibling is not a descendant of node, then an IllegalArgumentException is thrown. If node is null and nextSibling is not null, then an IllegalStateException is thrown. If nextSibling is null, then the behavior is the same as calling DOMResult.DOMResult(Node node), i.e. append the result nodes as the last child of the specified node.

Parameters:
- nextSibling - The child node before which the result nodes will be inserted.
Throws:
- IllegalArgumentException - If nextSibling is not a descendant of node.
- IllegalStateException - If node is null and nextSibling is not null.
Since: 1.5

public void setNode (Node node) [Inherited From DOMResult]

Set the node that will contain the result DOM tree.

In practice, the node should be a Document node, a DocumentFragment node, or a Element node. In other words, a node that accepts children.

An IllegalStateException is thrown if nextSibling is not null and node is not a parent of nextSibling. An IllegalStateException is thrown if node is null and nextSibling is not null.

Parameters:
- node - The node to which the transformation will be appended.
Throws:
- IllegalStateException - If nextSibling is not null and nextSibling is not a child of node or node is null and nextSibling is not null.

public void setSystemId (String systemId) [Inherited From DOMResult]

Set the systemId that may be used in association with the node.