diff -r 000000000000 -r 373ffda63c9a src/share/jaxws_classes/javax/xml/soap/SAAJResult.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/share/jaxws_classes/javax/xml/soap/SAAJResult.java Wed Apr 27 01:27:09 2016 +0800
@@ -0,0 +1,133 @@
+/*
+ * Copyright (c) 2004, 2012, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation. Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+package javax.xml.soap;
+
+import javax.xml.transform.dom.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 {@link #getResult()} method. The {@link DOMResult#getNode()}
+ * method should be avoided in almost all cases.
+ *
+ * @author XWS-Security Development Team
+ *
+ * @since SAAJ 1.3
+ */
+public class SAAJResult extends DOMResult {
+
+ /**
+ * 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 {@link 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() 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 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 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 SAAJ 1.3
+ */
+ public SAAJResult(SOAPElement rootNode) {
+ super(rootNode);
+ }
+
+
+ /**
+ * @return the resulting Tree that was created under the specified root Node.
+ * @since SAAJ 1.3
+ */
+ public javax.xml.soap.Node getResult() {
+ return (javax.xml.soap.Node)super.getNode().getFirstChild();
+ }
+}