public class SAAJResult extends DOMResult
Acts as a holder for the results of a JAXP transformation or a JAXB marshalling, in the form of a SAAJ tree. These results should be accessed by using the getResult()
method. The DOMResult.getNode()
method should be avoided in almost all cases.
FEATURE
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
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.
SOAPException
- if there is a problem creating a SOAPMessage
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. 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.
protocol
- - the name of the SOAP protocol that the resulting SAAJ tree should supportSOAPException
- if a SOAPMessage
supporting the specified protocol cannot be createdpublic SAAJResult(SOAPMessage message)
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.
message
- - the message whose SOAPPart
will be populated as a result of some transformation or marshalling operationpublic SAAJResult(SOAPElement rootNode)
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.
rootNode
- - the root to which the results will be appendedpublic Node getResult()
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.