< prev index next >
src/java.xml.ws/share/classes/javax/xml/soap/SAAJResult.java
Print this page
@@ -1,7 +1,7 @@
/*
- * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2015, 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
@@ -38,81 +38,81 @@
* @since 1.6, SAAJ 1.3
*/
public class SAAJResult extends DOMResult {
/**
- * Creates a <code>SAAJResult</code> that will present results in the form
+ * Creates a {@code SAAJResult} that will present results in the form
* of a SAAJ tree that supports the default (SOAP 1.1) protocol.
* <p>
- * This kind of <code>SAAJResult</code> is meant for use in situations where the
+ * This kind of {@code 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 <code>SOAPElement</code>, is drawn from the SAAJ
+ * whose type, such as {@code SOAPElement}, is drawn from the SAAJ
* API. When used in a transformation, the results are populated into the
- * <code>SOAPPart</code> of a <code>SOAPMessage</code> that is created internally.
- * The <code>SOAPPart</code> returned by {@link DOMResult#getNode()}
+ * {@code SOAPPart} of a {@code SOAPMessage} that is created internally.
+ * The {@code SOAPPart} returned by {@link DOMResult#getNode()}
* is not guaranteed to be well-formed.
*
- * @throws SOAPException if there is a problem creating a <code>SOAPMessage</code>
+ * @throws SOAPException if there is a problem creating a {@code SOAPMessage}
*
* @since 1.6, SAAJ 1.3
*/
public SAAJResult() throws SOAPException {
this(MessageFactory.newInstance().createMessage());
}
/**
- * Creates a <code>SAAJResult</code> that will present results in the form
+ * Creates a {@code SAAJResult} that will present results in the form
* of a SAAJ tree that supports the specified protocol. The
- * <code>DYNAMIC_SOAP_PROTOCOL</code> is ambiguous in this context and will
- * cause this constructor to throw an <code>UnsupportedOperationException</code>.
+ * {@code DYNAMIC_SOAP_PROTOCOL} is ambiguous in this context and will
+ * cause this constructor to throw an {@code UnsupportedOperationException}.
* <p>
- * This kind of <code>SAAJResult</code> is meant for use in situations where the
+ * This kind of {@code 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 <code>SOAPElement</code>, is drawn from the SAAJ
+ * whose type, such as {@code SOAPElement}, is drawn from the SAAJ
* API. When used in a transformation the results are populated into the
- * <code>SOAPPart</code> of a <code>SOAPMessage</code> that is created
- * internally. The <code>SOAPPart</code> returned by {@link DOMResult#getNode()}
+ * {@code SOAPPart} of a {@code SOAPMessage} that is created
+ * internally. The {@code 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 <code>SOAPMessage</code> supporting the
+ * @throws SOAPException if a {@code 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 <code>SAAJResult</code> that will write the results into the
- * <code>SOAPPart</code> of the supplied <code>SOAPMessage</code>.
+ * Creates a {@code SAAJResult} that will write the results into the
+ * {@code SOAPPart} of the supplied {@code SOAPMessage}.
* In the normal case these results will be written using DOM APIs and,
- * as a result, the finished <code>SOAPPart</code> will not be guaranteed
+ * as a result, the finished {@code 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 <code>SOAPMessage</code>
+ * When used in a transformation the validity of the {@code SOAPMessage}
* after the transformation can be guaranteed only by means outside SAAJ
* specification.
*
- * @param message - the message whose <code>SOAPPart</code> will be
+ * @param message - the message whose {@code 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 <code>SAAJResult</code> that will write the results as a
- * child node of the <code>SOAPElement</code> specified. In the normal
+ * Creates a {@code SAAJResult} that will write the results as a
+ * child node of the {@code 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
- * <code>SAAJResult</code> should only be used when the validity of the
+ * {@code 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
*
< prev index next >