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 {@link DOMResult#getNode()}
- * is not guaranteed to be well-formed.
- *
- * @throws SOAPException if there is a problem creating a SOAPMessage
- *
- * @since 1.6, SAAJ 1.3
- */
- public SAAJResult() throws SOAPException {
- this(MessageFactory.newInstance().createMessage());
- }
-
- /**
- * 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 {@link DOMResult#getNode()}
- * is not guaranteed to be well-formed.
- *
- * @param 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 1.6, SAAJ 1.3
- */
- public SAAJResult(String protocol) throws SOAPException {
- this(MessageFactory.newInstance(protocol).createMessage());
- }
-
- /**
- * 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.
- *
- * @param message - the message whose SOAPPart will be
- * populated as a result of some transformation or
- * marshalling operation
- *
- * @since 1.6, SAAJ 1.3
- */
- public SAAJResult(SOAPMessage message) {
- super(message.getSOAPPart());
- }
-
- /**
- * 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.
- *
- * @param rootNode - the root to which the results will be appended
- *
- * @since 1.6, SAAJ 1.3
- */
- public SAAJResult(SOAPElement rootNode) {
- super(rootNode);
- }
-
-
- /**
- * @return the resulting Tree that was created under the specified root Node.
- * @since 1.6, SAAJ 1.3
- */
- public javax.xml.soap.Node getResult() {
- return (javax.xml.soap.Node)super.getNode().getFirstChild();
- }
-}