--- old/src/java.activation/share/classes/javax/activation/MailcapCommandMap.java 2015-04-21 17:20:10.664098480 +0400
+++ new/src/java.activation/share/classes/javax/activation/MailcapCommandMap.java 2015-04-21 17:20:10.564098481 +0400
@@ -45,14 +45,13 @@
* system for mailcap file entries. When requests are made
* to search for commands in the MailcapCommandMap, it searches
* mailcap files in the following order:
- *
*
*
Programatically added entries to the MailcapCommandMap instance.
- *
The file .mailcap in the user's home directory.
- *
The file <java.home>/lib/mailcap.
- *
The file or resources named META-INF/mailcap.
- *
The file or resource named META-INF/mailcap.default
- * (usually found only in the activation.jar file).
+ *
The file {@code .mailcap} in the user's home directory.
+ *
The file {@literal <}java.home{@literal >}{@code /lib/mailcap}.
+ *
The file or resources named {@code META-INF/mailcap}.
+ *
The file or resource named {@code META-INF/mailcap.default}
+ * (usually found only in the {@code activation.jar} file).
*
*
* Mailcap file format:
@@ -70,46 +69,43 @@
*
* When a mailcap file is
* parsed, the MailcapCommandMap recognizes certain parameter signatures,
- * specifically those parameter names that begin with x-java-.
+ * specifically those parameter names that begin with {@code x-java-}.
* The MailcapCommandMap uses this signature to find
* command entries for inclusion into its registries.
- * Parameter names with the form x-java-<name>
+ * Parameter names with the form {@code x-java-}
* are read by the MailcapCommandMap as identifying a command
- * with the name name. When the name is
- * content-handler the MailcapCommandMap recognizes the class
+ * with the name name. When the name is {@code
+ * content-handler} the MailcapCommandMap recognizes the class
* signified by this parameter as a DataContentHandler.
* All other commands are handled generically regardless of command
* name. The command implementation is specified by a fully qualified
* class name of a JavaBean(tm) component. For example; a command for viewing
- * some data can be specified as: x-java-view=com.foo.ViewBean.
+ * some data can be specified as: {@code x-java-view=com.foo.ViewBean}.
*
- * When the command name is fallback-entry, the value of
- * the command may be true or false. An
+ * When the command name is {@code fallback-entry}, the value of
+ * the command may be {@code true} or {@code false}. An
* entry for a MIME type that includes a parameter of
- * x-java-fallback-entry=true defines fallback commands
+ * {@code x-java-fallback-entry=true} defines fallback commands
* for that MIME type that will only be used if no non-fallback entry
- * can be found. For example, an entry of the form text/*; ;
- * x-java-fallback-entry=true; x-java-view=com.sun.TextViewer
+ * can be found. For example, an entry of the form {@code text/*; ;
+ * x-java-fallback-entry=true; x-java-view=com.sun.TextViewer}
* specifies a view command to be used for any text MIME type. This
* view command would only be used if a non-fallback view command for
* the MIME type could not be found.
*
* MailcapCommandMap aware mailcap files have the
- * following general form:
- *
- * # Comments begin with a '#' and continue to the end of the line.
- * <mime type>; ; <parameter list>
- * # Where a parameter list consists of one or more parameters,
- * # where parameters look like: x-java-view=com.sun.TextViewer
- * # and a parameter list looks like:
+ * following general form:
+ *
{@code
+ * # Comments begin with a '#' and continue to the end of the line.
+ * ; ;
+ * # Where a parameter list consists of one or more parameters,
+ * # where parameters look like: x-java-view=com.sun.TextViewer
+ * # and a parameter list looks like:
* text/plain; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit
- *
- * # Note that mailcap entries that do not contain 'x-java' parameters
- * # and comply to RFC 1524 are simply ignored:
- * image/gif; /usr/dt/bin/sdtimage %s
- *
- *
- *
+ * # Note that mailcap entries that do not contain 'x-java' parameters
+ * # and comply to RFC 1524 are simply ignored:
+ * image/gif; /usr/dt/bin/sdtimage %s
+ * }
*
* @author Bart Calder
* @author Bill Shannon
@@ -451,7 +447,7 @@
}
/**
- * Get the command corresponding to cmdName for the MIME type.
+ * Get the command corresponding to {@code cmdName} for the MIME type.
*
* @param mimeType the MIME type
* @param cmdName the command name
--- old/src/java.activation/share/classes/javax/activation/MimetypesFileTypeMap.java 2015-04-21 17:20:11.044098480 +0400
+++ new/src/java.activation/share/classes/javax/activation/MimetypesFileTypeMap.java 2015-04-21 17:20:10.956098480 +0400
@@ -33,33 +33,32 @@
/**
* This class extends FileTypeMap and provides data typing of files
- * via their file extension. It uses the .mime.types format.
+ * via their file extension. It uses the {@code .mime.types} format.
*
* MIME types file search order:
* The MimetypesFileTypeMap looks in various places in the user's
* system for MIME types file entries. When requests are made
* to search for MIME types in the MimetypesFileTypeMap, it searches
* MIME types files in the following order:
- *
*
*
Programmatically added entries to the MimetypesFileTypeMap instance.
- *
The file .mime.types in the user's home directory.
- *
The file <java.home>/lib/mime.types.
- *
The file or resources named META-INF/mime.types.
- *
The file or resource named META-INF/mimetypes.default
- * (usually found only in the activation.jar file).
+ *
The file {@code .mime.types} in the user's home directory.
+ *
The file {@literal <}java.home{@literal >}{@code /lib/mime.types}.
+ *
The file or resources named {@code META-INF/mime.types}.
+ *
The file or resource named {@code META-INF/mimetypes.default}
+ * (usually found only in the {@code activation.jar} file).
*
*
- * MIME types file format:
+ * MIME types file format:
*
- *
- * # comments begin with a '#'
- * # the format is <mime type> <space separated file extensions>
- * # for example:
- * text/plain txt text TXT
- * # this would map file.txt, file.text, and file.TXT to
- * # the mime type "text/plain"
- *
+ *
{@code
+ * # comments begin with a '#'
+ * # the format is
+ * # for example:
+ * text/plain txt text TXT
+ * # this would map file.txt, file.text, and file.TXT to
+ * # the mime type "text/plain"
+ * }
*
* @author Bart Calder
* @author Bill Shannon
@@ -277,7 +276,7 @@
/**
* Return the MIME type of the file object.
* The implementation in this class calls
- * getContentType(f.getName()).
+ * {@code getContentType(f.getName())}.
*
* @param f the file
* @return the file's MIME type
--- old/src/java.annotations.common/share/classes/javax/annotation/PostConstruct.java 2015-04-21 17:20:11.404098480 +0400
+++ new/src/java.annotations.common/share/classes/javax/annotation/PostConstruct.java 2015-04-21 17:20:11.312098480 +0400
@@ -39,7 +39,6 @@
* method can be annotated with this annotation. The method on which the
* PostConstruct annotation is applied MUST fulfill all of the following
* criteria:
- *
*
*
The method MUST NOT have any parameters except in the case of
* interceptors in which case it takes an InvocationContext object as
--- old/src/java.annotations.common/share/classes/javax/annotation/PreDestroy.java 2015-04-21 17:20:11.756098480 +0400
+++ new/src/java.annotations.common/share/classes/javax/annotation/PreDestroy.java 2015-04-21 17:20:11.668098480 +0400
@@ -38,7 +38,6 @@
* except the application client container in Java EE 5. The method on which
* the PreDestroy annotation is applied MUST fulfill all of the following
* criteria:
- *
*
*
The method MUST NOT have any parameters except in the case of
* interceptors in which case it takes an InvocationContext object as
--- old/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-04-21 17:20:12.124098479 +0400
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-04-21 17:20:12.020098479 +0400
@@ -38,19 +38,16 @@
* functionality. Calling this api repeatedly will have no effect - the
* DatatypeConverter instance passed into the first invocation is the one that
* will be used from then on.
- *
*
*
* This interface defines the parse and print methods. There is one
* parse and print method for each XML schema datatype specified in the
* the default binding Table 5-1 in the JAXB specification.
- *
*
*
* The parse and print methods defined here are invoked by the static parse
* and print methods defined in the {@link DatatypeConverter DatatypeConverter}
* class.
- *
*
*
* A parse method for a XML schema datatype must be capable of converting any
@@ -60,21 +57,23 @@
* If an error is encountered during conversion, then an IllegalArgumentException
* or a subclass of IllegalArgumentException must be thrown by the method.
*
- *
- *
*
* A print method for a XML schema datatype can output any lexical
* representation that is valid with respect to the XML schema datatype.
* If an error is encountered during conversion, then an IllegalArgumentException,
* or a subclass of IllegalArgumentException must be thrown by the method.
- *
* Convert the string argument into a string.
* @param lexicalXSDString
* A lexical representation of the XML Schema datatype xsd:string
@@ -93,91 +91,83 @@
public String parseString( String lexicalXSDString );
/**
- *
* Convert the string argument into a BigInteger value.
* @param lexicalXSDInteger
* A string containing a lexical representation of
* xsd:integer.
* @return
* A BigInteger value represented by the string argument.
- * @throws NumberFormatException lexicalXSDInteger is not a valid string representation of a {@link java.math.BigInteger} value.
+ * @throws NumberFormatException {@code lexicalXSDInteger} is not a valid string representation of a {@link java.math.BigInteger} value.
*/
public java.math.BigInteger parseInteger( String lexicalXSDInteger );
/**
- *
* Convert the string argument into an int value.
* @param lexicalXSDInt
* A string containing a lexical representation of
* xsd:int.
* @return
* An int value represented byte the string argument.
- * @throws NumberFormatException lexicalXSDInt is not a valid string representation of an int value.
+ * @throws NumberFormatException {@code lexicalXSDInt} is not a valid string representation of an {@code int} value.
*/
public int parseInt( String lexicalXSDInt );
/**
- *
* Converts the string argument into a long value.
* @param lexicalXSDLong
* A string containing lexical representation of
* xsd:long.
* @return
* A long value represented by the string argument.
- * @throws NumberFormatException lexicalXSDLong is not a valid string representation of a long value.
+ * @throws NumberFormatException {@code lexicalXSDLong} is not a valid string representation of a {@code long} value.
*/
public long parseLong( String lexicalXSDLong );
/**
- *
* Converts the string argument into a short value.
* @param lexicalXSDShort
* A string containing lexical representation of
* xsd:short.
* @return
* A short value represented by the string argument.
- * @throws NumberFormatException lexicalXSDShort is not a valid string representation of a short value.
+ * @throws NumberFormatException {@code lexicalXSDShort} is not a valid string representation of a {@code short} value.
*/
public short parseShort( String lexicalXSDShort );
/**
- *
* Converts the string argument into a BigDecimal value.
* @param lexicalXSDDecimal
* A string containing lexical representation of
* xsd:decimal.
* @return
* A BigDecimal value represented by the string argument.
- * @throws NumberFormatException lexicalXSDDecimal is not a valid string representation of {@link java.math.BigDecimal}.
+ * @throws NumberFormatException {@code lexicalXSDDecimal} is not a valid string representation of {@link java.math.BigDecimal}.
*/
public java.math.BigDecimal parseDecimal( String lexicalXSDDecimal );
/**
- *
* Converts the string argument into a float value.
* @param lexicalXSDFloat
* A string containing lexical representation of
* xsd:float.
* @return
* A float value represented by the string argument.
- * @throws NumberFormatException lexicalXSDFloat is not a valid string representation of a float value.
+ * @throws NumberFormatException {@code lexicalXSDFloat} is not a valid string representation of a {@code float} value.
*/
public float parseFloat( String lexicalXSDFloat );
/**
- *
* Converts the string argument into a double value.
* @param lexicalXSDDouble
* A string containing lexical representation of
* xsd:double.
* @return
* A double value represented by the string argument.
- * @throws NumberFormatException lexicalXSDDouble is not a valid string representation of a double value.
+ * @throws NumberFormatException {@code lexicalXSDDouble} is not a valid string representation of a {@code double} value.
*/
public double parseDouble( String lexicalXSDDouble );
/**
- *
* Converts the string argument into a boolean value.
* @param lexicalXSDBoolean
* A string containing lexical representation of
@@ -189,20 +179,18 @@
public boolean parseBoolean( String lexicalXSDBoolean );
/**
- *
* Converts the string argument into a byte value.
* @param lexicalXSDByte
* A string containing lexical representation of
* xsd:byte.
* @return
* A byte value represented by the string argument.
- * @throws NumberFormatException lexicalXSDByte does not contain a parseable byte.
+ * @throws NumberFormatException {@code lexicalXSDByte} does not contain a parseable byte.
* @throws IllegalArgumentException if string parameter does not conform to lexical value space defined in XML Schema Part 2: Datatypes for xsd:byte.
*/
public byte parseByte( String lexicalXSDByte );
/**
- *
* Converts the string argument into a QName value.
*
*
* Converts the string argument into a Calendar value.
* @param lexicalXSDDateTime
* A string containing lexical representation of
@@ -234,7 +221,6 @@
public java.util.Calendar parseDateTime( String lexicalXSDDateTime );
/**
- *
* Converts the string argument into an array of bytes.
* @param lexicalXSDBase64Binary
* A string containing lexical representation
@@ -246,7 +232,6 @@
public byte[] parseBase64Binary( String lexicalXSDBase64Binary );
/**
- *
* Converts the string argument into an array of bytes.
* @param lexicalXSDHexBinary
* A string containing lexical representation of
@@ -258,7 +243,6 @@
public byte[] parseHexBinary( String lexicalXSDHexBinary );
/**
- *
* Converts the string argument into a long value.
* @param lexicalXSDUnsignedInt
* A string containing lexical representation
@@ -270,7 +254,6 @@
public long parseUnsignedInt( String lexicalXSDUnsignedInt );
/**
- *
* Converts the string argument into an int value.
* @param lexicalXSDUnsignedShort
* A string containing lexical
@@ -282,7 +265,6 @@
public int parseUnsignedShort( String lexicalXSDUnsignedShort );
/**
- *
* Converts the string argument into a Calendar value.
* @param lexicalXSDTime
* A string containing lexical representation of
@@ -294,7 +276,6 @@
public java.util.Calendar parseTime( String lexicalXSDTime );
/**
- *
* Converts the string argument into a Calendar value.
* @param lexicalXSDDate
* A string containing lexical representation of
@@ -306,7 +287,6 @@
public java.util.Calendar parseDate( String lexicalXSDDate );
/**
- *
* Return a string containing the lexical representation of the
* simple type.
* @param lexicalXSDAnySimpleType
@@ -319,7 +299,6 @@
public String parseAnySimpleType( String lexicalXSDAnySimpleType );
/**
- *
* Converts the string argument into a string.
* @param val
* A string value.
@@ -329,7 +308,6 @@
public String printString( String val );
/**
- *
* Converts a BigInteger value into a string.
* @param val
* A BigInteger value
@@ -340,7 +318,6 @@
public String printInteger( java.math.BigInteger val );
/**
- *
* Converts an int value into a string.
* @param val
* An int value
@@ -351,7 +328,6 @@
/**
- *
* Converts a long value into a string.
* @param val
* A long value
@@ -361,7 +337,6 @@
public String printLong( long val );
/**
- *
* Converts a short value into a string.
* @param val
* A short value
@@ -371,7 +346,6 @@
public String printShort( short val );
/**
- *
* Converts a BigDecimal value into a string.
* @param val
* A BigDecimal value
@@ -382,7 +356,6 @@
public String printDecimal( java.math.BigDecimal val );
/**
- *
* Converts a float value into a string.
* @param val
* A float value
@@ -392,7 +365,6 @@
public String printFloat( float val );
/**
- *
* Converts a double value into a string.
* @param val
* A double value
@@ -402,7 +374,6 @@
public String printDouble( double val );
/**
- *
* Converts a boolean value into a string.
* @param val
* A boolean value
@@ -412,7 +383,6 @@
public String printBoolean( boolean val );
/**
- *
* Converts a byte value into a string.
* @param val
* A byte value
@@ -422,7 +392,6 @@
public String printByte( byte val );
/**
- *
* Converts a QName instance into a string.
* @param val
* A QName value
@@ -437,7 +406,6 @@
javax.xml.namespace.NamespaceContext nsc );
/**
- *
* Converts a Calendar value into a string.
* @param val
* A Calendar value
@@ -448,7 +416,6 @@
public String printDateTime( java.util.Calendar val );
/**
- *
* Converts an array of bytes into a string.
* @param val
* an array of bytes
@@ -459,7 +426,6 @@
public String printBase64Binary( byte[] val );
/**
- *
* Converts an array of bytes into a string.
* @param val
* an array of bytes
@@ -470,7 +436,6 @@
public String printHexBinary( byte[] val );
/**
- *
* Converts a long value into a string.
* @param val
* A long value
@@ -480,7 +445,6 @@
public String printUnsignedInt( long val );
/**
- *
* Converts an int value into a string.
* @param val
* An int value
@@ -490,7 +454,6 @@
public String printUnsignedShort( int val );
/**
- *
* Converts a Calendar value into a string.
* @param val
* A Calendar value
@@ -501,7 +464,6 @@
public String printTime( java.util.Calendar val );
/**
- *
* Converts a Calendar value into a string.
* @param val
* A Calendar value
@@ -512,7 +474,6 @@
public String printDate( java.util.Calendar val );
/**
- *
* Converts a string value into a string.
* @param val
* A string value
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBPermission.java 2015-04-21 17:20:12.488098479 +0400
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBPermission.java 2015-04-21 17:20:12.400098479 +0400
@@ -40,7 +40,6 @@
* The following table lists all the possible {@code JAXBPermission} target names,
* and for each provides a description of what the permission allows
* and a discussion of the risks of granting code the permission.
- *
*
*
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java 2015-04-21 17:20:12.844098479 +0400
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java 2015-04-21 17:20:12.752098479 +0400
@@ -36,7 +36,7 @@
/**
* Maps a JavaBean property to a XML element derived from property name.
*
- *
Usage
+ *
Usage
*
* @XmlElement annotation can be used with the following program
* elements:
@@ -44,8 +44,6 @@
*
a JavaBean property
*
non static, non transient field
*
within {@link XmlElements}
- *
- *
*
*
* The usage is subject to the following constraints:
@@ -79,7 +77,7 @@
*
* //Example: Code fragment
* public class USPrice {
- * @XmlElement(name="itemprice")
+ * {@literal @}XmlElement(name="itemprice")
* public java.math.BigDecimal price;
* }
* {@code
@@ -95,10 +93,9 @@
*
* Example 2: Map a field to a nillable element.
*
- *
* //Example: Code fragment
* public class USPrice {
- * @XmlElement(nillable=true)
+ * {@literal @}XmlElement(nillable=true)
* public java.math.BigDecimal price;
* }
* {@code
@@ -113,10 +110,9 @@
*
* Example 3: Map a field to a nillable, required element.
*
- *
* //Example: Code fragment
* public class USPrice {
- * @XmlElement(nillable=true, required=true)
+ * {@literal @}XmlElement(nillable=true, required=true)
* public java.math.BigDecimal price;
* }
* {@code
@@ -134,7 +130,6 @@
*
Enable JAXB marshalling to optimize storage of binary data.
+ *
Enable JAXB marshalling to optimize storage of binary data.
*
*
This API enables an efficient cooperative creation of optimized
* binary data formats between a JAXB marshalling process and a MIME-based package
* processor. A JAXB implementation marshals the root body of a MIME-based package,
* delegating the creation of referenceable MIME parts to
- * the MIME-based package processor that implements this abstraction.
+ * the MIME-based package processor that implements this abstraction.
*
*
XOP processing is enabled when {@link #isXOPPackage()} is true.
* See {@link #addMtomAttachment(DataHandler, String, String)} for details.
- *
+ *
*
*
WS-I Attachment Profile 1.0 is supported by
* {@link #addSwaRefAttachment(DataHandler)} being called by the
* marshaller for each JAXB property related to
- * {http://ws-i.org/profiles/basic/1.1/xsd}swaRef.
+ * {http://ws-i.org/profiles/basic/1.1/xsd}swaRef.
*
*
* @author Marc Hadley
@@ -60,33 +60,33 @@
public abstract class AttachmentMarshaller {
/**
- *
Consider MIME content data for optimized binary storage as an attachment.
+ *
Consider MIME content {@code data} for optimized binary storage as an attachment.
*
*
* This method is called by JAXB marshal process when {@link #isXOPPackage()} is
- * true, for each element whose datatype is "base64Binary", as described in
+ * {@code true}, for each element whose datatype is "base64Binary", as described in
* Step 3 in
* Creating XOP Packages.
*
*
- * The method implementor determines whether data shall be attached separately
+ * The method implementor determines whether {@code data} shall be attached separately
* or inlined as base64Binary data. If the implementation chooses to optimize the storage
- * of the binary data as a MIME part, it is responsible for attaching data to the
+ * of the binary data as a MIME part, it is responsible for attaching {@code data} to the
* MIME-based package, and then assigning an unique content-id, cid, that identifies
* the MIME part within the MIME message. This method returns the cid,
* which enables the JAXB marshaller to marshal a XOP element that refers to that cid in place
* of marshalling the binary data. When the method returns null, the JAXB marshaller
- * inlines data as base64binary data.
+ * inlines {@code data} as base64binary data.
*
*
* The caller of this method is required to meet the following constraint.
- * If the element infoset item containing data has the attribute
- * xmime:contentType or if the JAXB property/field representing
- * datais annotated with a known MIME type,
- * data.getContentType() should be set to that MIME type.
+ * If the element infoset item containing {@code data} has the attribute
+ * {@code xmime:contentType} or if the JAXB property/field representing
+ * {@code data} is annotated with a known MIME type,
+ * {@code data.getContentType()} should be set to that MIME type.
*
*
- * The elementNamespace and elementLocalName
+ * The {@code elementNamespace} and {@code elementLocalName}
* parameters provide the
* context that contains the binary data. This information could
* be used by the MIME-based package processor to determine if the
@@ -101,7 +101,7 @@
* The local name of the element. Always a non-null valid string.
*
* @return
- * a valid content-id URI (see RFC 2387) that identifies the attachment containing data.
+ * a valid content-id URI (see RFC 2387) that identifies the attachment containing {@code data}.
* Otherwise, null if the attachment was not added and should instead be inlined in the message.
*
* @see XML-binary Optimized Packaging
@@ -110,12 +110,12 @@
public abstract String addMtomAttachment(DataHandler data, String elementNamespace, String elementLocalName);
/**
- *
Consider binary data for optimized binary storage as an attachment.
+ *
Consider binary {@code data} for optimized binary storage as an attachment.
*
- *
Since content type is not known, the attachment's MIME content type must be set to "application/octet-stream".
+ *
Since content type is not known, the attachment's MIME content type must be set to "application/octet-stream".
*
*
- * The elementNamespace and elementLocalName
+ * The {@code elementNamespace} and {@code elementLocalName}
* parameters provide the
* context that contains the binary data. This information could
* be used by the MIME-based package processor to determine if the
@@ -146,21 +146,21 @@
* The local name of the element. Always a non-null valid string.
*
* @return content-id URI, cid, to the attachment containing
- * data or null if data should be inlined.
+ * {@code data} or null if data should be inlined.
*
* @see #addMtomAttachment(DataHandler, String, String)
*/
public abstract String addMtomAttachment(byte[] data, int offset, int length, String mimeType, String elementNamespace, String elementLocalName);
/**
- *
Read-only property that returns true if JAXB marshaller should enable XOP creation.
+ *
Read-only property that returns true if JAXB marshaller should enable XOP creation.
*
*
This value must not change during the marshalling process. When this
- * value is true, the addMtomAttachment(...) method
+ * value is true, the {@code addMtomAttachment(...)} method
* is invoked when the appropriate binary datatypes are encountered by
- * the marshal process.
+ * the marshal process.
*
- *
Marshaller.marshal() must throw IllegalStateException if this value is true
+ *
Marshaller.marshal() must throw IllegalStateException if this value is {@code true}
* and the XML content to be marshalled violates Step 1 in
* Creating XOP Pacakges
* http://www.w3.org/TR/2005/REC-xop10-20050125/#creating_xop_packages.
@@ -168,18 +168,18 @@
* [namespace name] of "http://www.w3.org/2004/08/xop/include" and a [local name] of Include"
*
*
When this method returns true and during the marshal process
- * at least one call to addMtomAttachment(...) returns
+ * at least one call to {@code addMtomAttachment(...)} returns
* a content-id, the MIME-based package processor must label the
* root part with the application/xop+xml media type as described in
* Step 5 of
- * Creating XOP Pacakges.
+ * Creating XOP Pacakges.
*
* @return true when MIME context is a XOP Package.
*/
public boolean isXOPPackage() { return false; }
/**
- *
Add MIME data as an attachment and return attachment's content-id, cid.
+ *
Add MIME {@code data} as an attachment and return attachment's content-id, cid.
*
*
* This method is called by JAXB marshal process for each element/attribute typed as
@@ -188,7 +188,7 @@
* MIME attachment, and generating a content-id, cid, that uniquely identifies the attachment
* within the MIME-based package.
*
- *
Caller inserts the returned content-id, cid, into the XML content being marshalled.
+ *
Caller inserts the returned content-id, cid, into the XML content being marshalled.
*
* @param data
* represents the data to be attached. Must be non-null.
--- old/src/java.xml.ws/share/classes/javax/jws/soap/InitParam.java 2015-04-21 17:20:13.576098478 +0400
+++ new/src/java.xml.ws/share/classes/javax/jws/soap/InitParam.java 2015-04-21 17:20:13.488098478 +0400
@@ -27,7 +27,7 @@
/**
* @since 1.6
- * @Deprecated
+ * @deprecated
*/
@Deprecated public @interface InitParam {
String name();
--- old/src/java.xml.ws/share/classes/javax/jws/soap/SOAPMessageHandler.java 2015-04-21 17:20:13.956098478 +0400
+++ new/src/java.xml.ws/share/classes/javax/jws/soap/SOAPMessageHandler.java 2015-04-21 17:20:13.864098478 +0400
@@ -27,7 +27,7 @@
/**
* @since 1.6
- * @Deprecated
+ * @deprecated
*/
@Deprecated public @interface SOAPMessageHandler {
String name() default "";
--- old/src/java.xml.ws/share/classes/javax/jws/soap/SOAPMessageHandlers.java 2015-04-21 17:20:14.336098477 +0400
+++ new/src/java.xml.ws/share/classes/javax/jws/soap/SOAPMessageHandlers.java 2015-04-21 17:20:14.244098478 +0400
@@ -29,7 +29,7 @@
/**
* @since 1.6
- * @Deprecated
+ * @deprecated
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({TYPE})
--- old/src/java.xml.ws/share/classes/javax/xml/soap/AttachmentPart.java 2015-04-21 17:20:14.756098477 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/AttachmentPart.java 2015-04-21 17:20:14.612098477 +0400
@@ -32,54 +32,53 @@
import javax.activation.DataHandler;
/**
- * A single attachment to a SOAPMessage object. A SOAPMessage
- * object may contain zero, one, or many AttachmentPart objects.
- * Each AttachmentPart object consists of two parts,
+ * A single attachment to a {@code SOAPMessage} object. A {@code SOAPMessage}
+ * object may contain zero, one, or many {@code AttachmentPart} objects.
+ * Each {@code AttachmentPart} object consists of two parts,
* application-specific content and associated MIME headers. The
* MIME headers consists of name/value pairs that can be used to
* identify and describe the content.
*
- * An AttachmentPart object must conform to certain standards.
+ * An {@code AttachmentPart} object must conform to certain standards.
*
The header portion MUST include the following header:
*
- *
Content-Type
+ *
{@code Content-Type}
* This header identifies the type of data in the content of an
- * AttachmentPart object and MUST conform to [RFC2045].
+ * {@code AttachmentPart} object and MUST conform to [RFC2045].
* The following is an example of a Content-Type header:
*
* Content-Type: application/xml
*
- * The following line of code, in which ap is an
- * AttachmentPart object, sets the header shown in
+ * The following line of code, in which {@code ap} is an
+ * {@code AttachmentPart} object, sets the header shown in
* the previous example.
*
- * There are no restrictions on the content portion of an
- * AttachmentPart object. The content may be anything from a
+ * There are no restrictions on the content portion of an {@code
+ * AttachmentPart} object. The content may be anything from a
* simple plain text object to a complex XML document or image file.
*
*
- * An AttachmentPart object is created with the method
- * SOAPMessage.createAttachmentPart. After setting its MIME headers,
- * the AttachmentPart object is added to the message
- * that created it with the method SOAPMessage.addAttachmentPart.
+ * An {@code AttachmentPart} object is created with the method
+ * {@code SOAPMessage.createAttachmentPart}. After setting its MIME headers,
+ * the {@code AttachmentPart} object is added to the message
+ * that created it with the method {@code SOAPMessage.addAttachmentPart}.
*
*
- * The following code fragment, in which m is a
- * SOAPMessage object and contentStringl is a
- * String, creates an instance of AttachmentPart,
- * sets the AttachmentPart object with some content and
- * header information, and adds the AttachmentPart object to
- * the SOAPMessage object.
+ * The following code fragment, in which {@code m} is a
+ * {@code SOAPMessage} object and {@code contentStringl} is a
+ * {@code String}, creates an instance of {@code AttachmentPart},
+ * sets the {@code AttachmentPart} object with some content and
+ * header information, and adds the {@code AttachmentPart} object to
+ * the {@code SOAPMessage} object.
*
* The following code fragment creates and adds a second
- * AttachmentPart instance to the same message. jpegData
+ * {@code AttachmentPart} instance to the same message. {@code jpegData}
* is a binary byte buffer representing the jpeg file.
*
- * The getContent method retrieves the contents and header from
- * an AttachmentPart object. Depending on the
- * DataContentHandler objects present, the returned
- * Object can either be a typed Java object corresponding
- * to the MIME type or an InputStream object that contains the
+ * The {@code getContent} method retrieves the contents and header from
+ * an {@code AttachmentPart} object. Depending on the
+ * {@code DataContentHandler} objects present, the returned
+ * {@code Object} can either be a typed Java object corresponding
+ * to the MIME type or an {@code InputStream} object that contains the
* content as bytes.
*
*
- * The method clearContent removes all the content from an
- * AttachmentPart object but does not affect its header information.
+ * The method {@code clearContent} removes all the content from an
+ * {@code AttachmentPart} object but does not affect its header information.
*
* ap1.clearContent();
*
@@ -120,10 +119,10 @@
public abstract class AttachmentPart {
/**
- * Returns the number of bytes in this AttachmentPart
+ * Returns the number of bytes in this {@code AttachmentPart}
* object.
*
- * @return the size of this AttachmentPart object in bytes
+ * @return the size of this {@code AttachmentPart} object in bytes
* or -1 if the size cannot be determined
* @exception SOAPException if the content of this attachment is
* corrupted of if there was an exception while trying
@@ -132,52 +131,52 @@
public abstract int getSize() throws SOAPException;
/**
- * Clears out the content of this AttachmentPart object.
+ * Clears out the content of this {@code AttachmentPart} object.
* The MIME header portion is left untouched.
*/
public abstract void clearContent();
/**
- * Gets the content of this AttachmentPart object as a Java
+ * Gets the content of this {@code AttachmentPart} object as a Java
* object. The type of the returned Java object depends on (1) the
- * DataContentHandler object that is used to interpret the bytes
- * and (2) the Content-Type given in the header.
+ * {@code DataContentHandler} object that is used to interpret the bytes
+ * and (2) the {@code Content-Type} given in the header.
*
* For the MIME content types "text/plain", "text/html" and "text/xml", the
- * DataContentHandler object does the conversions to and
+ * {@code DataContentHandler} object does the conversions to and
* from the Java types corresponding to the MIME types.
- * For other MIME types,the DataContentHandler object
- * can return an InputStream object that contains the content data
+ * For other MIME types,the {@code DataContentHandler} object
+ * can return an {@code InputStream} object that contains the content data
* as raw bytes.
*
* A SAAJ-compliant implementation must, as a minimum, return a
- * java.lang.String object corresponding to any content
- * stream with a Content-Type value of
- * text/plain, a
- * javax.xml.transform.stream.StreamSource object corresponding to a
- * content stream with a Content-Type value of
- * text/xml, a java.awt.Image object
+ * {@code java.lang.String} object corresponding to any content
+ * stream with a {@code Content-Type} value of
+ * {@code text/plain}, a
+ * {@code javax.xml.transform.stream.StreamSource} object corresponding to a
+ * content stream with a {@code Content-Type} value of
+ * {@code text/xml}, a {@code java.awt.Image} object
* corresponding to a content stream with a
- * Content-Type value of image/gif or
- * image/jpeg. For those content types that an
- * installed DataContentHandler object does not understand, the
- * DataContentHandler object is required to return a
- * java.io.InputStream object with the raw bytes.
+ * {@code Content-Type} value of {@code image/gif} or
+ * {@code image/jpeg}. For those content types that an
+ * installed {@code DataContentHandler} object does not understand, the
+ * {@code DataContentHandler} object is required to return a
+ * {@code java.io.InputStream} object with the raw bytes.
*
- * @return a Java object with the content of this AttachmentPart
+ * @return a Java object with the content of this {@code AttachmentPart}
* object
*
* @exception SOAPException if there is no content set into this
- * AttachmentPart object or if there was a data
+ * {@code AttachmentPart} object or if there was a data
* transformation error
*/
public abstract Object getContent() throws SOAPException;
/**
- * Gets the content of this AttachmentPart object as an
- * InputStream as if a call had been made to getContent and no
- * DataContentHandler had been registered for the
- * content-type of this AttachmentPart.
+ * Gets the content of this {@code AttachmentPart} object as an
+ * InputStream as if a call had been made to {@code getContent} and no
+ * {@code DataContentHandler} had been registered for the
+ * {@code content-type} of this {@code AttachmentPart}.
*
* Note that reading from the returned InputStream would result in consuming
* the data in the stream. It is the responsibility of the caller to reset
@@ -185,11 +184,11 @@
* of the raw attachment content is required then the {@link #getRawContentBytes} API
* should be used instead.
*
- * @return an InputStream from which the raw data contained by
- * the AttachmentPart can be accessed.
+ * @return an {@code InputStream} from which the raw data contained by
+ * the {@code AttachmentPart} can be accessed.
*
* @throws SOAPException if there is no content set into this
- * AttachmentPart object or if there was a data
+ * {@code AttachmentPart} object or if there was a data
* transformation error.
*
* @since 1.6, SAAJ 1.3
@@ -198,16 +197,16 @@
public abstract InputStream getRawContent() throws SOAPException;
/**
- * Gets the content of this AttachmentPart object as a
- * byte[] array as if a call had been made to getContent and no
- * DataContentHandler had been registered for the
- * content-type of this AttachmentPart.
+ * Gets the content of this {@code AttachmentPart} object as a
+ * byte[] array as if a call had been made to {@code getContent} and no
+ * {@code DataContentHandler} had been registered for the
+ * {@code content-type} of this {@code AttachmentPart}.
*
- * @return a byte[] array containing the raw data of the
- * AttachmentPart.
+ * @return a {@code byte[]} array containing the raw data of the
+ * {@code AttachmentPart}.
*
* @throws SOAPException if there is no content set into this
- * AttachmentPart object or if there was a data
+ * {@code AttachmentPart} object or if there was a data
* transformation error.
*
* @since 1.6, SAAJ 1.3
@@ -215,16 +214,16 @@
public abstract byte[] getRawContentBytes() throws SOAPException;
/**
- * Returns an InputStream which can be used to obtain the
- * content of AttachmentPart as Base64 encoded
+ * Returns an {@code InputStream} which can be used to obtain the
+ * content of {@code AttachmentPart} as Base64 encoded
* character data, this method would base64 encode the raw bytes
* of the attachment and return.
*
- * @return an InputStream from which the Base64 encoded
- * AttachmentPart can be read.
+ * @return an {@code InputStream} from which the Base64 encoded
+ * {@code AttachmentPart} can be read.
*
* @throws SOAPException if there is no content set into this
- * AttachmentPart object or if there was a data
+ * {@code AttachmentPart} object or if there was a data
* transformation error.
*
* @since 1.6, SAAJ 1.3
@@ -233,11 +232,11 @@
/**
* Sets the content of this attachment part to that of the given
- * Object and sets the value of the Content-Type
+ * {@code Object} and sets the value of the {@code Content-Type}
* header to the given type. The type of the
- * Object should correspond to the value given for the
- * Content-Type. This depends on the particular
- * set of DataContentHandler objects in use.
+ * {@code Object} should correspond to the value given for the
+ * {@code Content-Type}. This depends on the particular
+ * set of {@code DataContentHandler} objects in use.
*
*
* @param object the Java object that makes up the content for
@@ -247,7 +246,7 @@
*
* @exception IllegalArgumentException may be thrown if the contentType
* does not match the type of the content object, or if there
- * was no DataContentHandler object for this
+ * was no {@code DataContentHandler} object for this
* content object
*
* @see #getContent
@@ -256,31 +255,31 @@
/**
* Sets the content of this attachment part to that contained by the
- * InputStreamcontent and sets the value of the
- * Content-Type header to the value contained in
- * contentType.
+ * {@code InputStream} {@code content} and sets the value of the
+ * {@code Content-Type} header to the value contained in
+ * {@code contentType}.
*
* A subsequent call to getSize() may not be an exact measure
* of the content size.
*
* @param content the raw data to add to the attachment part
- * @param contentType the value to set into the Content-Type
+ * @param contentType the value to set into the {@code Content-Type}
* header
*
* @exception SOAPException if an there is an error in setting the content
- * @exception NullPointerException if content is null
+ * @exception NullPointerException if {@code content} is null
* @since 1.6, SAAJ 1.3
*/
public abstract void setRawContent(InputStream content, String contentType) throws SOAPException;
/**
* Sets the content of this attachment part to that contained by the
- * byte[] array content and sets the value of the
- * Content-Type header to the value contained in
- * contentType.
+ * {@code byte[]} array {@code content} and sets the value of the
+ * {@code Content-Type} header to the value contained in
+ * {@code contentType}.
*
* @param content the raw data to add to the attachment part
- * @param contentType the value to set into the Content-Type
+ * @param contentType the value to set into the {@code Content-Type}
* header
* @param offset the offset in the byte array of the content
* @param len the number of bytes that form the content
@@ -296,20 +295,20 @@
/**
* Sets the content of this attachment part from the Base64 source
- * InputStream and sets the value of the
- * Content-Type header to the value contained in
- * contentType, This method would first decode the base64
+ * {@code InputStream} and sets the value of the
+ * {@code Content-Type} header to the value contained in
+ * {@code contentType}, This method would first decode the base64
* input and write the resulting raw bytes to the attachment.
*
* A subsequent call to getSize() may not be an exact measure
* of the content size.
*
* @param content the base64 encoded data to add to the attachment part
- * @param contentType the value to set into the Content-Type
+ * @param contentType the value to set into the {@code Content-Type}
* header
*
* @exception SOAPException if an there is an error in setting the content
- * @exception NullPointerException if content is null
+ * @exception NullPointerException if {@code content} is null
*
* @since 1.6, SAAJ 1.3
*/
@@ -318,30 +317,30 @@
/**
- * Gets the DataHandler object for this AttachmentPart
+ * Gets the {@code DataHandler} object for this {@code AttachmentPart}
* object.
*
- * @return the DataHandler object associated with this
- * AttachmentPart object
+ * @return the {@code DataHandler} object associated with this
+ * {@code AttachmentPart} object
*
* @exception SOAPException if there is no data in
- * this AttachmentPart object
+ * this {@code AttachmentPart} object
*/
public abstract DataHandler getDataHandler()
throws SOAPException;
/**
- * Sets the given DataHandler object as the data handler
- * for this AttachmentPart object. Typically, on an incoming
+ * Sets the given {@code DataHandler} object as the data handler
+ * for this {@code AttachmentPart} object. Typically, on an incoming
* message, the data handler is automatically set. When
* a message is being created and populated with content, the
- * setDataHandler method can be used to get data from
+ * {@code setDataHandler} method can be used to get data from
* various data sources into the message.
*
- * @param dataHandler the DataHandler object to be set
+ * @param dataHandler the {@code DataHandler} object to be set
*
* @exception IllegalArgumentException if there was a problem with
- * the specified DataHandler object
+ * the specified {@code DataHandler} object
*/
public abstract void setDataHandler(DataHandler dataHandler);
@@ -349,8 +348,8 @@
/**
* Gets the value of the MIME header whose name is "Content-ID".
*
- * @return a String giving the value of the
- * "Content-ID" header or null if there
+ * @return a {@code String} giving the value of the
+ * "Content-ID" header or {@code null} if there
* is none
* @see #setContentId
*/
@@ -364,8 +363,8 @@
/**
* Gets the value of the MIME header whose name is "Content-Location".
*
- * @return a String giving the value of the
- * "Content-Location" header or null if there
+ * @return a {@code String} giving the value of the
+ * "Content-Location" header or {@code null} if there
* is none
*/
public String getContentLocation() {
@@ -378,8 +377,8 @@
/**
* Gets the value of the MIME header whose name is "Content-Type".
*
- * @return a String giving the value of the
- * "Content-Type" header or null if there
+ * @return a {@code String} giving the value of the
+ * "Content-Type" header or {@code null} if there
* is none
*/
public String getContentType() {
@@ -392,11 +391,11 @@
/**
* Sets the MIME header whose name is "Content-ID" with the given value.
*
- * @param contentId a String giving the value of the
+ * @param contentId a {@code String} giving the value of the
* "Content-ID" header
*
* @exception IllegalArgumentException if there was a problem with
- * the specified contentId value
+ * the specified {@code contentId} value
* @see #getContentId
*/
public void setContentId(String contentId)
@@ -409,7 +408,7 @@
* Sets the MIME header whose name is "Content-Location" with the given value.
*
*
- * @param contentLocation a String giving the value of the
+ * @param contentLocation a {@code String} giving the value of the
* "Content-Location" header
* @exception IllegalArgumentException if there was a problem with
* the specified content location
@@ -422,7 +421,7 @@
/**
* Sets the MIME header whose name is "Content-Type" with the given value.
*
- * @param contentType a String giving the value of the
+ * @param contentType a {@code String} giving the value of the
* "Content-Type" header
*
* @exception IllegalArgumentException if there was a problem with
@@ -449,10 +448,10 @@
/**
* Gets all the values of the header identified by the given
- * String.
+ * {@code String}.
*
* @param name the name of the header; example: "Content-Type"
- * @return a String array giving the value for the
+ * @return a {@code String} array giving the value for the
* specified header
* @see #setMimeHeader
*/
@@ -466,9 +465,9 @@
*
* Note that RFC822 headers can only contain US-ASCII characters.
*
- * @param name a String giving the name of the header
+ * @param name a {@code String} giving the name of the header
* for which to search
- * @param value a String giving the value to be set for
+ * @param value a {@code String} giving the value to be set for
* the header whose name matches the given name
*
* @exception IllegalArgumentException if there was a problem with
@@ -479,13 +478,13 @@
/**
* Adds a MIME header with the specified name and value to this
- * AttachmentPart object.
+ * {@code AttachmentPart} object.
*
* Note that RFC822 headers can contain only US-ASCII characters.
*
- * @param name a String giving the name of the header
+ * @param name a {@code String} giving the name of the header
* to be added
- * @param value a String giving the value of the header
+ * @param value a {@code String} giving the value of the header
* to be added
*
* @exception IllegalArgumentException if there was a problem with
@@ -494,35 +493,35 @@
public abstract void addMimeHeader(String name, String value);
/**
- * Retrieves all the headers for this AttachmentPart object
- * as an iterator over the MimeHeader objects.
+ * Retrieves all the headers for this {@code AttachmentPart} object
+ * as an iterator over the {@code MimeHeader} objects.
*
- * @return an Iterator object with all of the Mime
- * headers for this AttachmentPart object
+ * @return an {@code Iterator} object with all of the Mime
+ * headers for this {@code AttachmentPart} object
*/
public abstract Iterator getAllMimeHeaders();
/**
- * Retrieves all MimeHeader objects that match a name in
+ * Retrieves all {@code MimeHeader} objects that match a name in
* the given array.
*
- * @param names a String array with the name(s) of the
+ * @param names a {@code String} array with the name(s) of the
* MIME headers to be returned
* @return all of the MIME headers that match one of the names in the
- * given array as an Iterator object
+ * given array as an {@code Iterator} object
*/
public abstract Iterator getMatchingMimeHeaders(String[] names);
/**
- * Retrieves all MimeHeader objects whose name does
+ * Retrieves all {@code MimeHeader} objects whose name does
* not match a name in the given array.
*
- * @param names a String array with the name(s) of the
+ * @param names a {@code String} array with the name(s) of the
* MIME headers not to be returned
- * @return all of the MIME headers in this AttachmentPart object
+ * @return all of the MIME headers in this {@code AttachmentPart} object
* except those that match one of the names in the
* given array. The nonmatching MIME headers are returned as an
- * Iterator object.
+ * {@code Iterator} object.
*/
public abstract Iterator getNonMatchingMimeHeaders(String[] names);
}
--- old/src/java.xml.ws/share/classes/javax/xml/soap/Name.java 2015-04-21 17:20:15.120098477 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/Name.java 2015-04-21 17:20:15.032098477 +0400
@@ -32,52 +32,50 @@
* to get the URI of the namespace.
*
* The following is an example of a namespace declaration in an element.
- *
+ * {@code }
* ("xmlns" stands for "XML namespace".)
* The following
- * shows what the methods in the Name interface will return.
+ * shows what the methods in the {@code Name} interface will return.
*
- *
getQualifiedName will return "prefix:LocalName" =
+ *
{@code getQualifiedName} will return "prefix:LocalName" =
* "WOMBAT:GetLastTradePrice"
- *
getURI will return "http://www.wombat.org/trader"
- *
getLocalName will return "GetLastTracePrice"
- *
getPrefix will return "WOMBAT"
+ *
{@code getURI} will return "http://www.wombat.org/trader"
+ *
{@code getLocalName} will return "GetLastTracePrice"
+ *
{@code getPrefix} will return "WOMBAT"
*
*
* XML namespaces are used to disambiguate SOAP identifiers from
* application-specific identifiers.
*
- * Name objects are created using the method
- * SOAPEnvelope.createName, which has two versions.
- * One method creates Name objects with
+ * {@code Name} objects are created using the method
+ * {@code SOAPEnvelope.createName}, which has two versions.
+ * One method creates {@code Name} objects with
* a local name, a namespace prefix, and a namespace URI.
- * and the second creates Name objects with just a local name.
+ * and the second creates {@code Name} objects with just a local name.
* The following line of
- * code, in which se is a SOAPEnvelope object, creates a new
- * Name object with all three.
+ * code, in which se is a {@code SOAPEnvelope} object, creates a new
+ * {@code Name} object with all three.
*
* Name name = se.createName("GetLastTradePrice", "WOMBAT",
* "http://www.wombat.org/trader");
*
- * The following line of code gives an example of how a Name object
- * can be used. The variable element is a SOAPElement object.
- * This code creates a new SOAPElement object with the given name and
+ * The following line of code gives an example of how a {@code Name} object
+ * can be used. The variable element is a {@code SOAPElement} object.
+ * This code creates a new {@code SOAPElement} object with the given name and
* adds it to element.
*
* element.addChildElement(name);
*
*
- * The Name interface may be deprecated in a future release of SAAJ
- * in favor of javax.xml.namespace.QName
+ * The {@code Name} interface may be deprecated in a future release of SAAJ
+ * in favor of {@code javax.xml.namespace.QName}
* @see SOAPEnvelope#createName(String, String, String) SOAPEnvelope.createName
* @see SOAPFactory#createName(String, String, String) SOAPFactory.createName
* @since 1.6
*/
public interface Name {
/**
- * Gets the local name part of the XML name that this Name
+ * Gets the local name part of the XML name that this {@code Name}
* object represents.
*
* @return a string giving the local name
@@ -86,16 +84,16 @@
/**
* Gets the namespace-qualified name of the XML name that this
- * Name object represents.
+ * {@code Name} object represents.
*
* @return the namespace-qualified name as a string
*/
String getQualifiedName();
/**
- * Returns the prefix that was specified when this Name object
+ * Returns the prefix that was specified when this {@code Name} object
* was initialized. This prefix is associated with the namespace for the XML
- * name that this Name object represents.
+ * name that this {@code Name} object represents.
*
* @return the prefix as a string
*/
@@ -103,7 +101,7 @@
/**
* Returns the URI of the namespace for the XML
- * name that this Name object represents.
+ * name that this {@code Name} object represents.
*
* @return the URI as a string
*/
--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBody.java 2015-04-21 17:20:15.476098476 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBody.java 2015-04-21 17:20:15.388098477 +0400
@@ -36,10 +36,10 @@
* element in a SOAP message. A SOAP body element consists of XML data
* that affects the way the application-specific content is processed.
*
- * A SOAPBody object contains SOAPBodyElement
+ * A {@code SOAPBody} object contains {@code SOAPBodyElement}
* objects, which have the content for the SOAP body.
- * A SOAPFault object, which carries status and/or
- * error information, is an example of a SOAPBodyElement object.
+ * A {@code SOAPFault} object, which carries status and/or
+ * error information, is an example of a {@code SOAPBodyElement} object.
*
* @see SOAPFault
* @since 1.6
@@ -47,47 +47,47 @@
public interface SOAPBody extends SOAPElement {
/**
- * Creates a new SOAPFault object and adds it to
- * this SOAPBody object. The new SOAPFault will
+ * Creates a new {@code SOAPFault} object and adds it to
+ * this {@code SOAPBody} object. The new {@code SOAPFault} will
* have default values set for the mandatory child elements. The type of
- * the SOAPFault will be a SOAP 1.1 or a SOAP 1.2 SOAPFault
- * depending on the protocol specified while creating the
- * MessageFactory instance.
+ * the {@code SOAPFault} will be a SOAP 1.1 or a SOAP 1.2 {@code SOAPFault}
+ * depending on the {@code protocol} specified while creating the
+ * {@code MessageFactory} instance.
*
- * A SOAPBody may contain at most one SOAPFault
+ * A {@code SOAPBody} may contain at most one {@code SOAPFault}
* child element.
*
- * @return the new SOAPFault object
+ * @return the new {@code SOAPFault} object
* @exception SOAPException if there is a SOAP error
*/
public SOAPFault addFault() throws SOAPException;
/**
- * Creates a new SOAPFault object and adds it to
- * this SOAPBody object. The type of the
- * SOAPFault will be a SOAP 1.1 or a SOAP 1.2
- * SOAPFault depending on the protocol
- * specified while creating the MessageFactory instance.
+ * Creates a new {@code SOAPFault} object and adds it to
+ * this {@code SOAPBody} object. The type of the
+ * {@code SOAPFault} will be a SOAP 1.1 or a SOAP 1.2
+ * {@code SOAPFault} depending on the {@code protocol}
+ * specified while creating the {@code MessageFactory} instance.
*
- * For SOAP 1.2 the faultCode parameter is the value of the
- * Fault/Code/Value element and the faultString parameter
+ * For SOAP 1.2 the {@code faultCode} parameter is the value of the
+ * Fault/Code/Value element and the {@code faultString} parameter
* is the value of the Fault/Reason/Text element. For SOAP 1.1
- * the faultCode parameter is the value of the faultcode
- * element and the faultString parameter is the value of the faultstring
+ * the {@code faultCode} parameter is the value of the {@code faultcode}
+ * element and the {@code faultString} parameter is the value of the {@code faultstring}
* element.
*
- * A SOAPBody may contain at most one SOAPFault
+ * A {@code SOAPBody} may contain at most one {@code SOAPFault}
* child element.
*
- * @param faultCode a Name object giving the fault
+ * @param faultCode a {@code Name} object giving the fault
* code to be set; must be one of the fault codes defined in the Version
* of SOAP specification in use
- * @param faultString a String giving an explanation of
+ * @param faultString a {@code String} giving an explanation of
* the fault
* @param locale a {@link java.util.Locale} object indicating
- * the native language of the faultString
- * @return the new SOAPFault object
+ * the native language of the {@code faultString}
+ * @return the new {@code SOAPFault} object
* @exception SOAPException if there is a SOAP error
* @see SOAPFault#setFaultCode
* @see SOAPFault#setFaultString
@@ -96,32 +96,32 @@
public SOAPFault addFault(Name faultCode, String faultString, Locale locale) throws SOAPException;
/**
- * Creates a new SOAPFault object and adds it to this
- * SOAPBody object. The type of the SOAPFault
- * will be a SOAP 1.1 or a SOAP 1.2 SOAPFault depending on
- * the protocol specified while creating the MessageFactory
+ * Creates a new {@code SOAPFault} object and adds it to this
+ * {@code SOAPBody} object. The type of the {@code SOAPFault}
+ * will be a SOAP 1.1 or a SOAP 1.2 {@code SOAPFault} depending on
+ * the {@code protocol} specified while creating the {@code MessageFactory}
* instance.
*
- * For SOAP 1.2 the faultCode parameter is the value of the
- * Fault/Code/Value element and the faultString parameter
+ * For SOAP 1.2 the {@code faultCode} parameter is the value of the
+ * Fault/Code/Value element and the {@code faultString} parameter
* is the value of the Fault/Reason/Text element. For SOAP 1.1
- * the faultCode parameter is the value of the faultcode
- * element and the faultString parameter is the value of the faultstring
+ * the {@code faultCode} parameter is the value of the {@code faultcode}
+ * element and the {@code faultString} parameter is the value of the {@code faultstring}
* element.
*
- * A SOAPBody may contain at most one SOAPFault
+ * A {@code SOAPBody} may contain at most one {@code SOAPFault}
* child element.
*
* @param faultCode
- * a QName object giving the fault code to be
+ * a {@code QName} object giving the fault code to be
* set; must be one of the fault codes defined in the version
* of SOAP specification in use.
* @param faultString
- * a String giving an explanation of the fault
+ * a {@code String} giving an explanation of the fault
* @param locale
* a {@link java.util.Locale Locale} object indicating the
- * native language of the faultString
- * @return the new SOAPFault object
+ * native language of the {@code faultString}
+ * @return the new {@code SOAPFault} object
* @exception SOAPException
* if there is a SOAP error
* @see SOAPFault#setFaultCode
@@ -134,33 +134,33 @@
throws SOAPException;
/**
- * Creates a new SOAPFault object and adds it to this
- * SOAPBody object. The type of the SOAPFault
- * will be a SOAP 1.1 or a SOAP 1.2 SOAPFault depending on
- * the protocol specified while creating the MessageFactory
+ * Creates a new {@code SOAPFault} object and adds it to this
+ * {@code SOAPBody} object. The type of the {@code SOAPFault}
+ * will be a SOAP 1.1 or a SOAP 1.2 {@code SOAPFault} depending on
+ * the {@code protocol} specified while creating the {@code MessageFactory}
* instance.
*
- * For SOAP 1.2 the faultCode parameter is the value of the
- * Fault/Code/Value element and the faultString parameter
+ * For SOAP 1.2 the {@code faultCode} parameter is the value of the
+ * Fault/Code/Value element and the {@code faultString} parameter
* is the value of the Fault/Reason/Text element. For SOAP 1.1
- * the faultCode parameter is the value of the faultcode
- * element and the faultString parameter is the value of the faultstring
+ * the {@code faultCode} parameter is the value of the faultcode
+ * element and the {@code faultString} parameter is the value of the faultstring
* element.
*
- * In case of a SOAP 1.2 fault, the default value for the mandatory xml:lang
+ * In case of a SOAP 1.2 fault, the default value for the mandatory {@code xml:lang}
* attribute on the Fault/Reason/Text element will be set to
- * java.util.Locale.getDefault()
+ * {@code java.util.Locale.getDefault()}
*
- * A SOAPBody may contain at most one SOAPFault
+ * A {@code SOAPBody} may contain at most one {@code SOAPFault}
* child element.
*
* @param faultCode
- * a Name object giving the fault code to be set;
+ * a {@code Name} object giving the fault code to be set;
* must be one of the fault codes defined in the version of SOAP
* specification in use
* @param faultString
- * a String giving an explanation of the fault
- * @return the new SOAPFault object
+ * a {@code String} giving an explanation of the fault
+ * @return the new {@code SOAPFault} object
* @exception SOAPException
* if there is a SOAP error
* @see SOAPFault#setFaultCode
@@ -171,33 +171,33 @@
throws SOAPException;
/**
- * Creates a new SOAPFault object and adds it to this SOAPBody
- * object. The type of the SOAPFault
- * will be a SOAP 1.1 or a SOAP 1.2 SOAPFault depending on
- * the protocol specified while creating the MessageFactory
+ * Creates a new {@code SOAPFault} object and adds it to this {@code SOAPBody}
+ * object. The type of the {@code SOAPFault}
+ * will be a SOAP 1.1 or a SOAP 1.2 {@code SOAPFault} depending on
+ * the {@code protocol} specified while creating the {@code MessageFactory}
* instance.
*
- * For SOAP 1.2 the faultCode parameter is the value of the
- * Fault/Code/Value element and the faultString parameter
+ * For SOAP 1.2 the {@code faultCode} parameter is the value of the
+ * Fault/Code/Value element and the {@code faultString} parameter
* is the value of the Fault/Reason/Text element. For SOAP 1.1
- * the faultCode parameter is the value of the faultcode
- * element and the faultString parameter is the value of the faultstring
+ * the {@code faultCode} parameter is the value of the faultcode
+ * element and the {@code faultString} parameter is the value of the faultstring
* element.
*
- * In case of a SOAP 1.2 fault, the default value for the mandatory xml:lang
+ * In case of a SOAP 1.2 fault, the default value for the mandatory {@code xml:lang}
* attribute on the Fault/Reason/Text element will be set to
- * java.util.Locale.getDefault()
+ * {@code java.util.Locale.getDefault()}
*
- * A SOAPBody may contain at most one SOAPFault
+ * A {@code SOAPBody} may contain at most one {@code SOAPFault}
* child element
*
* @param faultCode
- * a QName object giving the fault code to be
+ * a {@code QName} object giving the fault code to be
* set; must be one of the fault codes defined in the version
* of SOAP specification in use
* @param faultString
- * a String giving an explanation of the fault
- * @return the new SOAPFault object
+ * a {@code String} giving an explanation of the fault
+ * @return the new {@code SOAPFault} object
* @exception SOAPException
* if there is a SOAP error
* @see SOAPFault#setFaultCode
@@ -209,32 +209,32 @@
throws SOAPException;
/**
- * Indicates whether a SOAPFault object exists in this
- * SOAPBody object.
+ * Indicates whether a {@code SOAPFault} object exists in this
+ * {@code SOAPBody} object.
*
- * @return true if a SOAPFault object exists
- * in this SOAPBody object; false
+ * @return {@code true} if a {@code SOAPFault} object exists
+ * in this {@code SOAPBody} object; {@code false}
* otherwise
*/
public boolean hasFault();
/**
- * Returns the SOAPFault object in this SOAPBody
+ * Returns the {@code SOAPFault} object in this {@code SOAPBody}
* object.
*
- * @return the SOAPFault object in this SOAPBody
+ * @return the {@code SOAPFault} object in this {@code SOAPBody}
* object if present, null otherwise.
*/
public SOAPFault getFault();
/**
- * Creates a new SOAPBodyElement object with the specified
- * name and adds it to this SOAPBody object.
+ * Creates a new {@code SOAPBodyElement} object with the specified
+ * name and adds it to this {@code SOAPBody} object.
*
* @param name
- * a Name object with the name for the new SOAPBodyElement
+ * a {@code Name} object with the name for the new {@code SOAPBodyElement}
* object
- * @return the new SOAPBodyElement object
+ * @return the new {@code SOAPBodyElement} object
* @exception SOAPException
* if a SOAP error occurs
* @see SOAPBody#addBodyElement(javax.xml.namespace.QName)
@@ -243,13 +243,13 @@
/**
- * Creates a new SOAPBodyElement object with the specified
- * QName and adds it to this SOAPBody object.
+ * Creates a new {@code SOAPBodyElement} object with the specified
+ * QName and adds it to this {@code SOAPBody} object.
*
* @param qname
- * a QName object with the qname for the new
- * SOAPBodyElement object
- * @return the new SOAPBodyElement object
+ * a {@code QName} object with the qname for the new
+ * {@code SOAPBodyElement} object
+ * @return the new {@code SOAPBodyElement} object
* @exception SOAPException
* if a SOAP error occurs
* @see SOAPBody#addBodyElement(Name)
@@ -259,20 +259,20 @@
/**
* Adds the root node of the DOM {@link org.w3c.dom.Document}
- * to this SOAPBody object.
+ * to this {@code SOAPBody} object.
*
- * Calling this method invalidates the document parameter.
- * The client application should discard all references to this Document
- * and its contents upon calling addDocument. The behavior
+ * Calling this method invalidates the {@code document} parameter.
+ * The client application should discard all references to this {@code Document}
+ * and its contents upon calling {@code addDocument}. The behavior
* of an application that continues to use such references is undefined.
*
* @param document
- * the Document object whose root node will be
- * added to this SOAPBody.
- * @return the SOAPBodyElement that represents the root node
+ * the {@code Document} object whose root node will be
+ * added to this {@code SOAPBody}.
+ * @return the {@code SOAPBodyElement} that represents the root node
* that was added.
* @exception SOAPException
- * if the Document cannot be added
+ * if the {@code Document} cannot be added
* @since 1.6, SAAJ 1.2
*/
public SOAPBodyElement addDocument(org.w3c.dom.Document document)
@@ -280,16 +280,16 @@
/**
* Creates a new DOM {@link org.w3c.dom.Document} and sets
- * the first child of this SOAPBody as it's document
- * element. The child SOAPElement is removed as part of the
+ * the first child of this {@code SOAPBody} as it's document
+ * element. The child {@code SOAPElement} is removed as part of the
* process.
*
* @return the {@link org.w3c.dom.Document} representation
- * of the SOAPBody content.
+ * of the {@code SOAPBody} content.
*
* @exception SOAPException
- * if there is not exactly one child SOAPElement of the
- * SOAPBody.
+ * if there is not exactly one child {@code SOAPElement} of the
+ * {@code SOAPBody}.
*
* @since 1.6, SAAJ 1.3
*/
--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElement.java 2015-04-21 17:20:15.840098476 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElement.java 2015-04-21 17:20:15.748098476 +0400
@@ -38,7 +38,7 @@
* Methods in this interface that are required to return SAAJ specific objects
* may "silently" replace nodes in the tree as required to successfully return
* objects of the correct type. See {@link #getChildElements()} and
- * {@link javax.xml.soap}
+ * {@link javax.xml.soap}
* for details.
*
* @since 1.6
@@ -46,115 +46,115 @@
public interface SOAPElement extends Node, org.w3c.dom.Element {
/**
- * Creates a new SOAPElement object initialized with the
- * given Name object and adds the new element to this
- * SOAPElement object.
+ * Creates a new {@code SOAPElement} object initialized with the
+ * given {@code Name} object and adds the new element to this
+ * {@code SOAPElement} object.
*
* This method may be deprecated in a future release of SAAJ in favor of
* addChildElement(javax.xml.namespace.QName)
*
- * @param name a Name object with the XML name for the
+ * @param name a {@code Name} object with the XML name for the
* new element
*
- * @return the new SOAPElement object that was created
+ * @return the new {@code SOAPElement} object that was created
* @exception SOAPException if there is an error in creating the
- * SOAPElement object
+ * {@code SOAPElement} object
* @see SOAPElement#addChildElement(javax.xml.namespace.QName)
*/
public SOAPElement addChildElement(Name name) throws SOAPException;
/**
- * Creates a new SOAPElement object initialized with the given
- * QName object and adds the new element to this SOAPElement
+ * Creates a new {@code SOAPElement} object initialized with the given
+ * {@code QName} object and adds the new element to this {@code SOAPElement}
* object. The namespace, localname and prefix of the new
- * SOAPElement are all taken from the qname argument.
+ * {@code SOAPElement} are all taken from the {@code qname} argument.
*
- * @param qname a QName object with the XML name for the
+ * @param qname a {@code QName} object with the XML name for the
* new element
*
- * @return the new SOAPElement object that was created
+ * @return the new {@code SOAPElement} object that was created
* @exception SOAPException if there is an error in creating the
- * SOAPElement object
+ * {@code SOAPElement} object
* @see SOAPElement#addChildElement(Name)
* @since 1.6, SAAJ 1.3
*/
public SOAPElement addChildElement(QName qname) throws SOAPException;
/**
- * Creates a new SOAPElement object initialized with the
+ * Creates a new {@code SOAPElement} object initialized with the
* specified local name and adds the new element to this
- * SOAPElement object.
- * The new SOAPElement inherits any in-scope default namespace.
+ * {@code SOAPElement} object.
+ * The new {@code SOAPElement} inherits any in-scope default namespace.
*
- * @param localName a String giving the local name for
+ * @param localName a {@code String} giving the local name for
* the element
- * @return the new SOAPElement object that was created
+ * @return the new {@code SOAPElement} object that was created
* @exception SOAPException if there is an error in creating the
- * SOAPElement object
+ * {@code SOAPElement} object
*/
public SOAPElement addChildElement(String localName) throws SOAPException;
/**
- * Creates a new SOAPElement object initialized with the
+ * Creates a new {@code SOAPElement} object initialized with the
* specified local name and prefix and adds the new element to this
- * SOAPElement object.
+ * {@code SOAPElement} object.
*
- * @param localName a String giving the local name for
+ * @param localName a {@code String} giving the local name for
* the new element
- * @param prefix a String giving the namespace prefix for
+ * @param prefix a {@code String} giving the namespace prefix for
* the new element
*
- * @return the new SOAPElement object that was created
- * @exception SOAPException if the prefix is not valid in the
- * context of this SOAPElement or if there is an error in creating the
- * SOAPElement object
+ * @return the new {@code SOAPElement} object that was created
+ * @exception SOAPException if the {@code prefix} is not valid in the
+ * context of this {@code SOAPElement} or if there is an error in creating the
+ * {@code SOAPElement} object
*/
public SOAPElement addChildElement(String localName, String prefix)
throws SOAPException;
/**
- * Creates a new SOAPElement object initialized with the
+ * Creates a new {@code SOAPElement} object initialized with the
* specified local name, prefix, and URI and adds the new element to this
- * SOAPElement object.
+ * {@code SOAPElement} object.
*
- * @param localName a String giving the local name for
+ * @param localName a {@code String} giving the local name for
* the new element
- * @param prefix a String giving the namespace prefix for
+ * @param prefix a {@code String} giving the namespace prefix for
* the new element
- * @param uri a String giving the URI of the namespace
+ * @param uri a {@code String} giving the URI of the namespace
* to which the new element belongs
*
- * @return the new SOAPElement object that was created
+ * @return the new {@code SOAPElement} object that was created
* @exception SOAPException if there is an error in creating the
- * SOAPElement object
+ * {@code SOAPElement} object
*/
public SOAPElement addChildElement(String localName, String prefix,
String uri)
throws SOAPException;
/**
- * Add a SOAPElement as a child of this
- * SOAPElement instance. The SOAPElement
+ * Add a {@code SOAPElement} as a child of this
+ * {@code SOAPElement} instance. The {@code SOAPElement}
* is expected to be created by a
- * SOAPFactory. Callers should not rely on the
+ * {@code SOAPFactory}. Callers should not rely on the
* element instance being added as is into the XML
* tree. Implementations could end up copying the content
- * of the SOAPElement passed into an instance of
- * a different SOAPElement implementation. For
- * instance if addChildElement() is called on a
- * SOAPHeader, element will be copied
- * into an instance of a SOAPHeaderElement.
+ * of the {@code SOAPElement} passed into an instance of
+ * a different {@code SOAPElement} implementation. For
+ * instance if {@code addChildElement()} is called on a
+ * {@code SOAPHeader}, {@code element} will be copied
+ * into an instance of a {@code SOAPHeaderElement}.
*
- *
The fragment rooted in element is either added
+ *
The fragment rooted in {@code element} is either added
* as a whole or not at all, if there was an error.
*
- *
The fragment rooted in element cannot contain
+ *
The fragment rooted in {@code element} cannot contain
* elements named "Envelope", "Header" or "Body" and in the SOAP
* namespace. Any namespace prefixes present in the fragment
* should be fully resolved using appropriate namespace
* declarations within the fragment itself.
*
- * @param element the SOAPElement to be added as a
+ * @param element the {@code SOAPElement} to be added as a
* new child
*
* @exception SOAPException if there was an error in adding this
@@ -167,10 +167,10 @@
throws SOAPException;
/**
- * Detaches all children of this SOAPElement.
+ * Detaches all children of this {@code SOAPElement}.
*
* This method is useful for rolling back the construction of partially
- * completed SOAPHeaders and SOAPBodys in
+ * completed {@code SOAPHeaders} and {@code SOAPBodys} in
* preparation for sending a fault when an error condition is detected. It
* is also useful for recycling portions of a document within a SOAP
* message.
@@ -180,33 +180,33 @@
public abstract void removeContents();
/**
- * Creates a new Text object initialized with the given
- * String and adds it to this SOAPElement object.
+ * Creates a new {@code Text} object initialized with the given
+ * {@code String} and adds it to this {@code SOAPElement} object.
*
- * @param text a String object with the textual content to be added
+ * @param text a {@code String} object with the textual content to be added
*
- * @return the SOAPElement object into which
- * the new Text object was inserted
+ * @return the {@code SOAPElement} object into which
+ * the new {@code Text} object was inserted
* @exception SOAPException if there is an error in creating the
- * new Text object or if it is not legal to
+ * new {@code Text} object or if it is not legal to
* attach it as a child to this
- * SOAPElement
+ * {@code SOAPElement}
*/
public SOAPElement addTextNode(String text) throws SOAPException;
/**
* Adds an attribute with the specified name and value to this
- * SOAPElement object.
+ * {@code SOAPElement} object.
*
- * @param name a Name object with the name of the attribute
- * @param value a String giving the value of the attribute
- * @return the SOAPElement object into which the attribute was
+ * @param name a {@code Name} object with the name of the attribute
+ * @param value a {@code String} giving the value of the attribute
+ * @return the {@code SOAPElement} object into which the attribute was
* inserted
*
* @exception SOAPException if there is an error in creating the
* Attribute, or it is invalid to set
- an attribute with Name
- name on this SOAPElement.
+ an attribute with {@code Name}
+ {@code name} on this SOAPElement.
* @see SOAPElement#addAttribute(javax.xml.namespace.QName, String)
*/
public SOAPElement addAttribute(Name name, String value)
@@ -214,17 +214,17 @@
/**
* Adds an attribute with the specified name and value to this
- * SOAPElement object.
+ * {@code SOAPElement} object.
*
- * @param qname a QName object with the name of the attribute
- * @param value a String giving the value of the attribute
- * @return the SOAPElement object into which the attribute was
+ * @param qname a {@code QName} object with the name of the attribute
+ * @param value a {@code String} giving the value of the attribute
+ * @return the {@code SOAPElement} object into which the attribute was
* inserted
*
* @exception SOAPException if there is an error in creating the
* Attribute, or it is invalid to set
- an attribute with QName
- qname on this SOAPElement.
+ an attribute with {@code QName}
+ {@code qname} on this SOAPElement.
* @see SOAPElement#addAttribute(Name, String)
* @since 1.6, SAAJ 1.3
*/
@@ -233,11 +233,11 @@
/**
* Adds a namespace declaration with the specified prefix and URI to this
- * SOAPElement object.
+ * {@code SOAPElement} object.
*
- * @param prefix a String giving the prefix of the namespace
- * @param uri a String giving the uri of the namespace
- * @return the SOAPElement object into which this
+ * @param prefix a {@code String} giving the prefix of the namespace
+ * @param uri a {@code String} giving the uri of the namespace
+ * @return the {@code SOAPElement} object into which this
* namespace declaration was inserted.
*
* @exception SOAPException if there is an error in creating the
@@ -249,8 +249,8 @@
/**
* Returns the value of the attribute with the specified name.
*
- * @param name a Name object with the name of the attribute
- * @return a String giving the value of the specified
+ * @param name a {@code Name} object with the name of the attribute
+ * @return a {@code String} giving the value of the specified
* attribute, Null if there is no such attribute
* @see SOAPElement#getAttributeValue(javax.xml.namespace.QName)
*/
@@ -259,8 +259,8 @@
/**
* Returns the value of the attribute with the specified qname.
*
- * @param qname a QName object with the qname of the attribute
- * @return a String giving the value of the specified
+ * @param qname a {@code QName} object with the qname of the attribute
+ * @return a {@code String} giving the value of the specified
* attribute, Null if there is no such attribute
* @see SOAPElement#getAttributeValue(Name)
* @since 1.6, SAAJ 1.3
@@ -268,11 +268,11 @@
public String getAttributeValue(QName qname);
/**
- * Returns an Iterator over all of the attribute
- * Name objects in this
- * SOAPElement object. The iterator can be used to get
+ * Returns an {@code Iterator} over all of the attribute
+ * {@code Name} objects in this
+ * {@code SOAPElement} object. The iterator can be used to get
* the attribute names, which can then be passed to the method
- * getAttributeValue to retrieve the value of each
+ * {@code getAttributeValue} to retrieve the value of each
* attribute.
*
* @see SOAPElement#getAllAttributesAsQNames()
@@ -281,10 +281,10 @@
public Iterator getAllAttributes();
/**
- * Returns an Iterator over all of the attributes
- * in this SOAPElement as QName objects.
+ * Returns an {@code Iterator} over all of the attributes
+ * in this {@code SOAPElement} as {@code QName} objects.
* The iterator can be used to get the attribute QName, which can then
- * be passed to the method getAttributeValue to retrieve
+ * be passed to the method {@code getAttributeValue} to retrieve
* the value of each attribute.
*
* @return an iterator over the QNames of the attributes
@@ -297,94 +297,94 @@
/**
* Returns the URI of the namespace that has the given prefix.
*
- * @param prefix a String giving the prefix of the namespace
+ * @param prefix a {@code String} giving the prefix of the namespace
* for which to search
- * @return a String with the uri of the namespace that has
+ * @return a {@code String} with the uri of the namespace that has
* the given prefix
*/
public String getNamespaceURI(String prefix);
/**
- * Returns an Iterator over the namespace prefix
- * Strings declared by this element. The prefixes returned by
+ * Returns an {@code Iterator} over the namespace prefix
+ * {@code String}s declared by this element. The prefixes returned by
* this iterator can be passed to the method
- * getNamespaceURI to retrieve the URI of each namespace.
+ * {@code getNamespaceURI} to retrieve the URI of each namespace.
*
* @return an iterator over the namespace prefixes in this
- * SOAPElement object
+ * {@code SOAPElement} object
*/
public Iterator getNamespacePrefixes();
/**
- * Returns an Iterator over the namespace prefix
- * Strings visible to this element. The prefixes returned by
+ * Returns an {@code Iterator} over the namespace prefix
+ * {@code String}s visible to this element. The prefixes returned by
* this iterator can be passed to the method
- * getNamespaceURI to retrieve the URI of each namespace.
+ * {@code getNamespaceURI} to retrieve the URI of each namespace.
*
* @return an iterator over the namespace prefixes are within scope of this
- * SOAPElement object
+ * {@code SOAPElement} object
*
* @since 1.6, SAAJ 1.2
*/
public Iterator getVisibleNamespacePrefixes();
/**
- * Creates a QName whose namespace URI is the one associated
- * with the parameter, prefix, in the context of this
- * SOAPElement. The remaining elements of the new
- * QName are taken directly from the parameters,
- * localName and prefix.
+ * Creates a {@code QName} whose namespace URI is the one associated
+ * with the parameter, {@code prefix}, in the context of this
+ * {@code SOAPElement}. The remaining elements of the new
+ * {@code QName} are taken directly from the parameters,
+ * {@code localName} and {@code prefix}.
*
* @param localName
- * a String containing the local part of the name.
+ * a {@code String} containing the local part of the name.
* @param prefix
- * a String containing the prefix for the name.
+ * a {@code String} containing the prefix for the name.
*
- * @return a QName with the specified localName
- * and prefix, and with a namespace that is associated
- * with the prefix in the context of this
- * SOAPElement. This namespace will be the same as
+ * @return a {@code QName} with the specified {@code localName}
+ * and {@code prefix}, and with a namespace that is associated
+ * with the {@code prefix} in the context of this
+ * {@code SOAPElement}. This namespace will be the same as
* the one that would be returned by
* {@link #getNamespaceURI(String)} if it were given
- * prefix as it's parameter.
+ * {@code prefix} as it's parameter.
*
- * @exception SOAPException if the QName cannot be created.
+ * @exception SOAPException if the {@code QName} cannot be created.
*
* @since 1.6, SAAJ 1.3
*/
public QName createQName(String localName, String prefix)
throws SOAPException;
/**
- * Returns the name of this SOAPElement object.
+ * Returns the name of this {@code SOAPElement} object.
*
- * @return a Name object with the name of this
- * SOAPElement object
+ * @return a {@code Name} object with the name of this
+ * {@code SOAPElement} object
*/
public Name getElementName();
/**
- * Returns the qname of this SOAPElement object.
+ * Returns the qname of this {@code SOAPElement} object.
*
- * @return a QName object with the qname of this
- * SOAPElement object
+ * @return a {@code QName} object with the qname of this
+ * {@code SOAPElement} object
* @see SOAPElement#getElementName()
* @since 1.6, SAAJ 1.3
*/
public QName getElementQName();
/**
- * Changes the name of this Element to newName if
+ * Changes the name of this {@code Element} to {@code newName} if
* possible. SOAP Defined elements such as SOAPEnvelope, SOAPHeader, SOAPBody
* etc. cannot have their names changed using this method. Any attempt to do
* so will result in a SOAPException being thrown.
*
* Callers should not rely on the element instance being renamed as is.
* Implementations could end up copying the content of the
- * SOAPElement to a renamed instance.
+ * {@code SOAPElement} to a renamed instance.
*
- * @param newName the new name for the Element.
+ * @param newName the new name for the {@code Element}.
*
- * @exception SOAPException if changing the name of this Element
+ * @exception SOAPException if changing the name of this {@code Element}
* is not allowed.
* @return The renamed Node
*
@@ -395,10 +395,10 @@
/**
* Removes the attribute with the specified name.
*
- * @param name the Name object with the name of the
+ * @param name the {@code Name} object with the name of the
* attribute to be removed
- * @return true if the attribute was
- * removed successfully; false if it was not
+ * @return {@code true} if the attribute was
+ * removed successfully; {@code false} if it was not
* @see SOAPElement#removeAttribute(javax.xml.namespace.QName)
*/
public boolean removeAttribute(Name name);
@@ -406,10 +406,10 @@
/**
* Removes the attribute with the specified qname.
*
- * @param qname the QName object with the qname of the
+ * @param qname the {@code QName} object with the qname of the
* attribute to be removed
- * @return true if the attribute was
- * removed successfully; false if it was not
+ * @return {@code true} if the attribute was
+ * removed successfully; {@code false} if it was not
* @see SOAPElement#removeAttribute(Name)
* @since 1.6, SAAJ 1.3
*/
@@ -418,84 +418,84 @@
/**
* Removes the namespace declaration corresponding to the given prefix.
*
- * @param prefix a String giving the prefix for which
+ * @param prefix a {@code String} giving the prefix for which
* to search
- * @return true if the namespace declaration was
- * removed successfully; false if it was not
+ * @return {@code true} if the namespace declaration was
+ * removed successfully; {@code false} if it was not
*/
public boolean removeNamespaceDeclaration(String prefix);
/**
- * Returns an Iterator over all the immediate child
- * {@link Node}s of this element. This includes javax.xml.soap.Text
- * objects as well as SOAPElement objects.
+ * Returns an {@code Iterator} over all the immediate child
+ * {@link Node}s of this element. This includes {@code javax.xml.soap.Text}
+ * objects as well as {@code SOAPElement} objects.
*
- * Calling this method may cause child Element,
- * SOAPElement and org.w3c.dom.Text nodes to be
- * replaced by SOAPElement, SOAPHeaderElement,
- * SOAPBodyElement or javax.xml.soap.Text nodes as
+ * Calling this method may cause child {@code Element},
+ * {@code SOAPElement} and {@code org.w3c.dom.Text} nodes to be
+ * replaced by {@code SOAPElement}, {@code SOAPHeaderElement},
+ * {@code SOAPBodyElement} or {@code javax.xml.soap.Text} nodes as
* appropriate for the type of this parent node. As a result the calling
* application must treat any existing references to these child nodes that
* have been obtained through DOM APIs as invalid and either discard them or
- * refresh them with the values returned by this Iterator. This
+ * refresh them with the values returned by this {@code Iterator}. This
* behavior can be avoided by calling the equivalent DOM APIs. See
- * {@link javax.xml.soap}
+ * {@link javax.xml.soap}
* for more details.
*
- * @return an iterator with the content of this SOAPElement
+ * @return an iterator with the content of this {@code SOAPElement}
* object
*/
public Iterator getChildElements();
/**
- * Returns an Iterator over all the immediate child
+ * Returns an {@code Iterator} over all the immediate child
* {@link Node}s of this element with the specified name. All of these
- * children will be SOAPElement nodes.
+ * children will be {@code SOAPElement} nodes.
*
- * Calling this method may cause child Element,
- * SOAPElement and org.w3c.dom.Text nodes to be
- * replaced by SOAPElement, SOAPHeaderElement,
- * SOAPBodyElement or javax.xml.soap.Text nodes as
+ * Calling this method may cause child {@code Element},
+ * {@code SOAPElement} and {@code org.w3c.dom.Text} nodes to be
+ * replaced by {@code SOAPElement}, {@code SOAPHeaderElement},
+ * {@code SOAPBodyElement} or {@code javax.xml.soap.Text} nodes as
* appropriate for the type of this parent node. As a result the calling
* application must treat any existing references to these child nodes that
* have been obtained through DOM APIs as invalid and either discard them or
- * refresh them with the values returned by this Iterator. This
+ * refresh them with the values returned by this {@code Iterator}. This
* behavior can be avoided by calling the equivalent DOM APIs. See
- * {@link javax.xml.soap}
+ * {@link javax.xml.soap}
* for more details.
*
- * @param name a Name object with the name of the child
+ * @param name a {@code Name} object with the name of the child
* elements to be returned
*
- * @return an Iterator object over all the elements
- * in this SOAPElement object with the
+ * @return an {@code Iterator} object over all the elements
+ * in this {@code SOAPElement} object with the
* specified name
* @see SOAPElement#getChildElements(javax.xml.namespace.QName)
*/
public Iterator getChildElements(Name name);
/**
- * Returns an Iterator over all the immediate child
+ * Returns an {@code Iterator} over all the immediate child
* {@link Node}s of this element with the specified qname. All of these
- * children will be SOAPElement nodes.
+ * children will be {@code SOAPElement} nodes.
*
- * Calling this method may cause child Element,
- * SOAPElement and org.w3c.dom.Text nodes to be
- * replaced by SOAPElement, SOAPHeaderElement,
- * SOAPBodyElement or javax.xml.soap.Text nodes as
+ * Calling this method may cause child {@code Element},
+ * {@code SOAPElement} and {@code org.w3c.dom.Text} nodes to be
+ * replaced by {@code SOAPElement}, {@code SOAPHeaderElement},
+ * {@code SOAPBodyElement} or {@code javax.xml.soap.Text} nodes as
* appropriate for the type of this parent node. As a result the calling
* application must treat any existing references to these child nodes that
* have been obtained through DOM APIs as invalid and either discard them or
- * refresh them with the values returned by this Iterator. This
+ * refresh them with the values returned by this {@code Iterator}. This
* behavior can be avoided by calling the equivalent DOM APIs. See
- * {@link javax.xml.soap}
+ * {@link javax.xml.soap}
* for more details.
*
- * @param qname a QName object with the qname of the child
+ * @param qname a {@code QName} object with the qname of the child
* elements to be returned
*
- * @return an Iterator object over all the elements
- * in this SOAPElement object with the
+ * @return an {@code Iterator} object over all the elements
+ * in this {@code SOAPElement} object with the
* specified qname
* @see SOAPElement#getChildElements(Name)
* @since 1.6, SAAJ 1.3
@@ -503,10 +503,10 @@
public Iterator getChildElements(QName qname);
/**
- * Sets the encoding style for this SOAPElement object
+ * Sets the encoding style for this {@code SOAPElement} object
* to one specified.
*
- * @param encodingStyle a String giving the encoding style
+ * @param encodingStyle a {@code String} giving the encoding style
*
* @exception IllegalArgumentException if there was a problem in the
* encoding style being set.
@@ -516,9 +516,9 @@
public void setEncodingStyle(String encodingStyle)
throws SOAPException;
/**
- * Returns the encoding style for this SOAPElement object.
+ * Returns the encoding style for this {@code SOAPElement} object.
*
- * @return a String giving the encoding style
+ * @return a {@code String} giving the encoding style
*
* @see #setEncodingStyle
*/
--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPMessage.java 2015-04-21 17:20:16.208098476 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPMessage.java 2015-04-21 17:20:16.116098476 +0400
@@ -36,24 +36,24 @@
* message is an XML document or a MIME message whose first body part is an
* XML/SOAP document.
*
- * A SOAPMessage object consists of a SOAP part and optionally
- * one or more attachment parts. The SOAP part for a SOAPMessage
- * object is a SOAPPart object, which contains information used
+ * A {@code SOAPMessage} object consists of a SOAP part and optionally
+ * one or more attachment parts. The SOAP part for a {@code SOAPMessage}
+ * object is a {@code SOAPPart} object, which contains information used
* for message routing and identification, and which can contain
* application-specific content. All data in the SOAP Part of a message must be
* in XML format.
*
- * A new SOAPMessage object contains the following by default:
+ * A new {@code SOAPMessage} object contains the following by default:
*
- *
A SOAPPart object
- *
A SOAPEnvelope object
- *
A SOAPBody object
- *
A SOAPHeader object
+ *
A {@code SOAPPart} object
+ *
A {@code SOAPEnvelope} object
+ *
A {@code SOAPBody} object
+ *
A {@code SOAPHeader} object
*
- * The SOAP part of a message can be retrieved by calling the method SOAPMessage.getSOAPPart().
- * The SOAPEnvelope object is retrieved from the SOAPPart
- * object, and the SOAPEnvelope object is used to retrieve the
- * SOAPBody and SOAPHeader objects.
+ * The SOAP part of a message can be retrieved by calling the method {@code SOAPMessage.getSOAPPart()}.
+ * The {@code SOAPEnvelope} object is retrieved from the {@code SOAPPart}
+ * object, and the {@code SOAPEnvelope} object is used to retrieve the
+ * {@code SOAPBody} and {@code SOAPHeader} objects.
*
*
- * In addition to the mandatory SOAPPart object, a SOAPMessage
- * object may contain zero or more AttachmentPart objects, each
- * of which contains application-specific data. The SOAPMessage
- * interface provides methods for creating AttachmentPart
- * objects and also for adding them to a SOAPMessage object. A
- * party that has received a SOAPMessage object can examine its
+ * In addition to the mandatory {@code SOAPPart} object, a {@code SOAPMessage}
+ * object may contain zero or more {@code AttachmentPart} objects, each
+ * of which contains application-specific data. The {@code SOAPMessage}
+ * interface provides methods for creating {@code AttachmentPart}
+ * objects and also for adding them to a {@code SOAPMessage} object. A
+ * party that has received a {@code SOAPMessage} object can examine its
* contents by retrieving individual attachment parts.
*
* Unlike the rest of a SOAP message, an attachment is not required to be in
* XML format and can therefore be anything from simple text to an image file.
* Consequently, any message content that is not in XML format must be in an
- * AttachmentPart object.
+ * {@code AttachmentPart} object.
*
- * A MessageFactory object may create SOAPMessage
+ * A {@code MessageFactory} object may create {@code SOAPMessage}
* objects with behavior that is specialized to a particular implementation or
- * application of SAAJ. For instance, a MessageFactory object
- * may produce SOAPMessage objects that conform to a particular
- * Profile such as ebXML. In this case a MessageFactory object
- * might produce SOAPMessage objects that are initialized with
+ * application of SAAJ. For instance, a {@code MessageFactory} object
+ * may produce {@code SOAPMessage} objects that conform to a particular
+ * Profile such as ebXML. In this case a {@code MessageFactory} object
+ * might produce {@code SOAPMessage} objects that are initialized with
* ebXML headers.
*
* In order to ensure backward source compatibility, methods that are added to
* this class after version 1.1 of the SAAJ specification are all concrete
* instead of abstract and they all have default implementations. Unless
* otherwise noted in the JavaDocs for those methods the default
- * implementations simply throw an UnsupportedOperationException
+ * implementations simply throw an {@code UnsupportedOperationException}
* and the SAAJ implementation code must override them with methods that
* provide the specified behavior. Legacy client code does not have this
* restriction, however, so long as there is no claim made that it conforms to
@@ -126,41 +126,40 @@
"javax.xml.soap.write-xml-declaration";
/**
- * Sets the description of this SOAPMessage object's
+ * Sets the description of this {@code SOAPMessage} object's
* content with the given description.
*
- * @param description a String describing the content of this
+ * @param description a {@code String} describing the content of this
* message
* @see #getContentDescription
*/
public abstract void setContentDescription(String description);
/**
- * Retrieves a description of this SOAPMessage object's
+ * Retrieves a description of this {@code SOAPMessage} object's
* content.
*
- * @return a String describing the content of this
- * message or null if no description has been set
+ * @return a {@code String} describing the content of this
+ * message or {@code null} if no description has been set
* @see #setContentDescription
*/
public abstract String getContentDescription();
/**
- * Gets the SOAP part of this SOAPMessage object.
+ * Gets the SOAP part of this {@code SOAPMessage} object.
*
- * SOAPMessage object contains one or more attachments, the
+ * {@code SOAPMessage} object contains one or more attachments, the
* SOAP Part must be the first MIME body part in the message.
*
- * @return the SOAPPart object for this SOAPMessage
+ * @return the {@code SOAPPart} object for this {@code SOAPMessage}
* object
*/
public abstract SOAPPart getSOAPPart();
/**
- * Gets the SOAP Body contained in this SOAPMessage object.
- *
+ * Gets the SOAP Body contained in this {@code SOAPMessage} object.
*
- * @return the SOAPBody object contained by this SOAPMessage
+ * @return the {@code SOAPBody} object contained by this {@code SOAPMessage}
* object
* @exception SOAPException
* if the SOAP Body does not exist or cannot be retrieved
@@ -171,23 +170,21 @@
}
/**
- * Gets the SOAP Header contained in this SOAPMessage
- * object.
- *
- *
- * @return the SOAPHeader object contained by this SOAPMessage
- * object
- * @exception SOAPException
- * if the SOAP Header does not exist or cannot be retrieved
- * @since 1.6, SAAJ 1.2
- */
+ * Gets the SOAP Header contained in this {@code SOAPMessage} object.
+ *
+ * @return the {@code SOAPHeader} object contained
+ * by this {@code SOAPMessage} object
+ * @exception SOAPException
+ * if the SOAP Header does not exist or cannot be retrieved
+ * @since 1.6, SAAJ 1.2
+ */
public SOAPHeader getSOAPHeader() throws SOAPException {
throw new UnsupportedOperationException("getSOAPHeader must be overridden by all subclasses of SOAPMessage");
}
/**
- * Removes all AttachmentPart objects that have been added
- * to this SOAPMessage object.
+ * Removes all {@code AttachmentPart} objects that have been added
+ * to this {@code SOAPMessage} object.
*
* This method does not touch the SOAP part.
*/
@@ -197,26 +194,26 @@
* Gets a count of the number of attachments in this message. This count
* does not include the SOAP part.
*
- * @return the number of AttachmentPart objects that are
- * part of this SOAPMessage object
+ * @return the number of {@code AttachmentPart} objects that are
+ * part of this {@code SOAPMessage} object
*/
public abstract int countAttachments();
/**
- * Retrieves all the AttachmentPart objects that are part of
- * this SOAPMessage object.
+ * Retrieves all the {@code AttachmentPart} objects that are part of
+ * this {@code SOAPMessage} object.
*
* @return an iterator over all the attachments in this message
*/
public abstract Iterator getAttachments();
/**
- * Retrieves all the AttachmentPart objects that have header
+ * Retrieves all the {@code AttachmentPart} objects that have header
* entries that match the specified headers. Note that a returned
* attachment could have headers in addition to those specified.
*
* @param headers
- * a MimeHeaders object containing the MIME
+ * a {@code MimeHeaders} object containing the MIME
* headers for which to search
* @return an iterator over all attachments that have a header that matches
* one of the given headers
@@ -224,12 +221,12 @@
public abstract Iterator getAttachments(MimeHeaders headers);
/**
- * Removes all the AttachmentPart objects that have header
+ * Removes all the {@code AttachmentPart} objects that have header
* entries that match the specified headers. Note that the removed
* attachment could have headers in addition to those specified.
*
* @param headers
- * a MimeHeaders object containing the MIME
+ * a {@code MimeHeaders} object containing the MIME
* headers for which to search
* @since 1.6, SAAJ 1.3
*/
@@ -237,25 +234,26 @@
/**
- * Returns an AttachmentPart object that is associated with an
- * attachment that is referenced by this SOAPElement or
- * null if no such attachment exists. References can be made
- * via an href attribute as described in
- * {@link SOAP Messages with Attachments},
- * or via a single Text child node containing a URI as
+ * Returns an {@code AttachmentPart} object that is associated with an
+ * attachment that is referenced by this {@code SOAPElement} or
+ * {@code null} if no such attachment exists. References can be made
+ * via an {@code href} attribute as described in
+ * SOAP Messages with Attachments,
+ * or via a single {@code Text} child node containing a URI as
* described in the WS-I Attachments Profile 1.0 for elements of schema
- * type {@link ref:swaRef}. These two mechanisms must be supported.
- * The support for references via href attribute also implies that
+ * type ref:swaRef.
+ * These two mechanisms must be supported.
+ * The support for references via {@code href} attribute also implies that
* this method should also be supported on an element that is an
* xop:Include element (
- * {@link XOP}).
+ * XOP).
* other reference mechanisms may be supported by individual
* implementations of this standard. Contact your vendor for details.
*
- * @param element The SOAPElement containing the reference to an Attachment
- * @return the referenced AttachmentPart or null if no such
- * AttachmentPart exists or no reference can be
- * found in this SOAPElement.
+ * @param element The {@code SOAPElement} containing the reference to an Attachment
+ * @return the referenced {@code AttachmentPart} or null if no such
+ * {@code AttachmentPart} exists or no reference can be
+ * found in this {@code SOAPElement}.
* @throws SOAPException if there is an error in the attempt to access the
* attachment
*
@@ -265,40 +263,40 @@
/**
- * Adds the given AttachmentPart object to this SOAPMessage
- * object. An AttachmentPart object must be created before
+ * Adds the given {@code AttachmentPart} object to this {@code SOAPMessage}
+ * object. An {@code AttachmentPart} object must be created before
* it can be added to a message.
*
* @param AttachmentPart
- * an AttachmentPart object that is to become part
- * of this SOAPMessage object
+ * an {@code AttachmentPart} object that is to become part
+ * of this {@code SOAPMessage} object
* @exception IllegalArgumentException
*/
public abstract void addAttachmentPart(AttachmentPart AttachmentPart);
/**
- * Creates a new empty AttachmentPart object. Note that the
- * method addAttachmentPart must be called with this new
- * AttachmentPart object as the parameter in order for it to
- * become an attachment to this SOAPMessage object.
+ * Creates a new empty {@code AttachmentPart} object. Note that the
+ * method {@code addAttachmentPart} must be called with this new
+ * {@code AttachmentPart} object as the parameter in order for it to
+ * become an attachment to this {@code SOAPMessage} object.
*
- * @return a new AttachmentPart object that can be populated
- * and added to this SOAPMessage object
+ * @return a new {@code AttachmentPart} object that can be populated
+ * and added to this {@code SOAPMessage} object
*/
public abstract AttachmentPart createAttachmentPart();
/**
- * Creates an AttachmentPart object and populates it using
- * the given DataHandler object.
+ * Creates an {@code AttachmentPart} object and populates it using
+ * the given {@code DataHandler} object.
*
* @param dataHandler
- * the javax.activation.DataHandler object that
- * will generate the content for this SOAPMessage
+ * the {@code javax.activation.DataHandler} object that
+ * will generate the content for this {@code SOAPMessage}
* object
- * @return a new AttachmentPart object that contains data
- * generated by the given DataHandler object
+ * @return a new {@code AttachmentPart} object that contains data
+ * generated by the given {@code DataHandler} object
* @exception IllegalArgumentException
- * if there was a problem with the specified DataHandler
+ * if there was a problem with the specified {@code DataHandler}
* object
* @see javax.activation.DataHandler
* @see javax.activation.DataContentHandler
@@ -310,32 +308,32 @@
}
/**
- * Returns all the transport-specific MIME headers for this SOAPMessage
+ * Returns all the transport-specific MIME headers for this {@code SOAPMessage}
* object in a transport-independent fashion.
*
- * @return a MimeHeaders object containing the MimeHeader
+ * @return a {@code MimeHeaders} object containing the {@code MimeHeader}
* objects
*/
public abstract MimeHeaders getMimeHeaders();
/**
- * Creates an AttachmentPart object and populates it with
+ * Creates an {@code AttachmentPart} object and populates it with
* the specified data of the specified content type. The type of the
- * Object should correspond to the value given for the
- * Content-Type.
+ * {@code Object} should correspond to the value given for the
+ * {@code Content-Type}.
*
* @param content
- * an Object containing the content for the
- * AttachmentPart object to be created
+ * an {@code Object} containing the content for the
+ * {@code AttachmentPart} object to be created
* @param contentType
- * a String object giving the type of content;
+ * a {@code String} object giving the type of content;
* examples are "text/xml", "text/plain", and "image/jpeg"
- * @return a new AttachmentPart object that contains the
+ * @return a new {@code AttachmentPart} object that contains the
* given data
* @exception IllegalArgumentException
* may be thrown if the contentType does not match the type
* of the content object, or if there was no
- * DataContentHandler object for the given
+ * {@code DataContentHandler} object for the given
* content object
* @see javax.activation.DataHandler
* @see javax.activation.DataContentHandler
@@ -349,50 +347,49 @@
}
/**
- * Updates this SOAPMessage object with all the changes that
+ * Updates this {@code SOAPMessage} object with all the changes that
* have been made to it. This method is called automatically when
* {@link SOAPMessage#writeTo(OutputStream)} is called. However, if
* changes are made to a message that was received or to one that has
- * already been sent, the method saveChanges needs to be
- * called explicitly in order to save the changes. The method saveChanges
+ * already been sent, the method {@code saveChanges} needs to be
+ * called explicitly in order to save the changes. The method {@code saveChanges}
* also generates any changes that can be read back (for example, a
* MessageId in profiles that support a message id). All MIME headers in a
* message that is created for sending purposes are guaranteed to have
- * valid values only after saveChanges has been called.
+ * valid values only after {@code saveChanges} has been called.
*
* In addition, this method marks the point at which the data from all
- * constituent AttachmentPart objects are pulled into the
+ * constituent {@code AttachmentPart} objects are pulled into the
* message.
- *
*
- * @exception SOAPException if there was a problem saving
- * changes to this message.
+ * @exception SOAPException if there was a problem saving
+ * changes to this message.
*/
public abstract void saveChanges() throws SOAPException;
/**
- * Indicates whether this SOAPMessage object needs to have
- * the method saveChanges called on it.
+ * Indicates whether this {@code SOAPMessage} object needs to have
+ * the method {@code saveChanges} called on it.
*
- * @return true if saveChanges needs to be
- * called; false otherwise.
+ * @return {@code true} if {@code saveChanges} needs to be
+ * called; {@code false} otherwise.
*/
public abstract boolean saveRequired();
/**
- * Writes this SOAPMessage object to the given output
+ * Writes this {@code SOAPMessage} object to the given output
* stream. The externalization format is as defined by the SOAP 1.1 with
* Attachments specification.
*
* If there are no attachments, just an XML stream is written out. For
- * those messages that have attachments, writeTo writes a
+ * those messages that have attachments, {@code writeTo} writes a
* MIME-encoded byte stream.
*
* Note that this method does not write the transport-specific MIME Headers
* of the Message
*
* @param out
- * the OutputStream object to which this SOAPMessage
+ * the {@code OutputStream} object to which this {@code SOAPMessage}
* object will be written
* @exception IOException
* if an I/O error occurs
@@ -414,13 +411,13 @@
* implementation specific properties. These properties must be prefixed
* with package names that are unique to the vendor.
*
- * Setting the property WRITE_XML_DECLARATION to "true"
+ * Setting the property {@code WRITE_XML_DECLARATION} to {@code "true"}
* will cause an XML Declaration to be written out at the start of the SOAP
* message. The default value of "false" suppresses this declaration.
*
- * The property CHARACTER_SET_ENCODING defaults to the value
- * "utf-8" which causes the SOAP message to be encoded using
- * UTF-8. Setting CHARACTER_SET_ENCODING to "utf-16"
+ * The property {@code CHARACTER_SET_ENCODING} defaults to the value
+ * {@code "utf-8"} which causes the SOAP message to be encoded using
+ * UTF-8. Setting {@code CHARACTER_SET_ENCODING} to {@code "utf-16"}
* causes the SOAP message to be encoded using UTF-16.
*
* Some implementations may allow encodings in addition to UTF-8 and
@@ -445,7 +442,7 @@
*
* @param property
* the name of the property to retrieve
- * @return the value associated with the named property or null
+ * @return the value associated with the named property or {@code null}
* if no such property exists.
* @exception SOAPException
* if the property name is not recognized.
--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPPart.java 2015-04-21 17:20:16.572098476 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPPart.java 2015-04-21 17:20:16.484098476 +0400
@@ -30,52 +30,51 @@
import javax.xml.transform.Source;
/**
- * The container for the SOAP-specific portion of a SOAPMessage
+ * The container for the SOAP-specific portion of a {@code SOAPMessage}
* object. All messages are required to have a SOAP part, so when a
- * SOAPMessage object is created, it will automatically
- * have a SOAPPart object.
- *
- * A SOAPPart object is a MIME part and has the MIME headers
+ * {@code SOAPMessage} object is created, it will automatically
+ * have a {@code SOAPPart} object.
+ *
+ * A {@code SOAPPart} object is a MIME part and has the MIME headers
* Content-Id, Content-Location, and Content-Type. Because the value of
- * Content-Type must be "text/xml", a SOAPPart object automatically
+ * Content-Type must be "text/xml", a {@code SOAPPart} object automatically
* has a MIME header of Content-Type with its value set to "text/xml".
* The value must be "text/xml" because content in the SOAP part of a
* message must be in XML format. Content that is not of type "text/xml"
- * must be in an AttachmentPart object rather than in the
- * SOAPPart object.
+ * must be in an {@code AttachmentPart} object rather than in the
+ * {@code SOAPPart} object.
*
* When a message is sent, its SOAP part must have the MIME header Content-Type
* set to "text/xml". Or, from the other perspective, the SOAP part of any
* message that is received must have the MIME header Content-Type with a
* value of "text/xml".
*
- * A client can access the SOAPPart object of a
- * SOAPMessage object by
- * calling the method SOAPMessage.getSOAPPart. The
- * following line of code, in which message is a
- * SOAPMessage object, retrieves the SOAP part of a message.
+ * A client can access the {@code SOAPPart} object of a
+ * {@code SOAPMessage} object by
+ * calling the method {@code SOAPMessage.getSOAPPart}. The
+ * following line of code, in which {@code message} is a
+ * {@code SOAPMessage} object, retrieves the SOAP part of a message.
*
* SOAPPart soapPart = message.getSOAPPart();
*
*
- * A SOAPPart object contains a SOAPEnvelope object,
- * which in turn contains a SOAPBody object and a
- * SOAPHeader object.
- * The SOAPPart method getEnvelope can be used
- * to retrieve the SOAPEnvelope object.
- *
+ * A {@code SOAPPart} object contains a {@code SOAPEnvelope} object,
+ * which in turn contains a {@code SOAPBody} object and a
+ * {@code SOAPHeader} object.
+ * The {@code SOAPPart} method {@code getEnvelope} can be used
+ * to retrieve the {@code SOAPEnvelope} object.
*
* @since 1.6
*/
public abstract class SOAPPart implements org.w3c.dom.Document, Node {
/**
- * Gets the SOAPEnvelope object associated with this
- * SOAPPart object. Once the SOAP envelope is obtained, it
+ * Gets the {@code SOAPEnvelope} object associated with this
+ * {@code SOAPPart} object. Once the SOAP envelope is obtained, it
* can be used to get its contents.
*
- * @return the SOAPEnvelope object for this
- * SOAPPart object
+ * @return the {@code SOAPEnvelope} object for this
+ * {@code SOAPPart} object
* @exception SOAPException if there is a SOAP error
*/
public abstract SOAPEnvelope getEnvelope() throws SOAPException;
@@ -83,7 +82,7 @@
/**
* Retrieves the value of the MIME header whose name is "Content-Id".
*
- * @return a String giving the value of the MIME header
+ * @return a {@code String} giving the value of the MIME header
* named "Content-Id"
* @see #setContentId
*/
@@ -97,7 +96,7 @@
/**
* Retrieves the value of the MIME header whose name is "Content-Location".
*
- * @return a String giving the value of the MIME header whose
+ * @return a {@code String} giving the value of the MIME header whose
* name is "Content-Location"
* @see #setContentLocation
*/
@@ -110,9 +109,9 @@
/**
* Sets the value of the MIME header named "Content-Id"
- * to the given String.
+ * to the given {@code String}.
*
- * @param contentId a String giving the value of the MIME
+ * @param contentId a {@code String} giving the value of the MIME
* header "Content-Id"
*
* @exception IllegalArgumentException if there is a problem in
@@ -125,9 +124,9 @@
}
/**
* Sets the value of the MIME header "Content-Location"
- * to the given String.
+ * to the given {@code String}.
*
- * @param contentLocation a String giving the value
+ * @param contentLocation a {@code String} giving the value
* of the MIME
* header "Content-Location"
* @exception IllegalArgumentException if there is a problem in
@@ -141,24 +140,24 @@
/**
* Removes all MIME headers that match the given name.
*
- * @param header a String giving the name of the MIME header(s) to
+ * @param header a {@code String} giving the name of the MIME header(s) to
* be removed
*/
public abstract void removeMimeHeader(String header);
/**
- * Removes all the MimeHeader objects for this
- * SOAPEnvelope object.
+ * Removes all the {@code MimeHeader} objects for this
+ * {@code SOAPEnvelope} object.
*/
public abstract void removeAllMimeHeaders();
/**
- * Gets all the values of the MimeHeader object
- * in this SOAPPart object that
- * is identified by the given String.
+ * Gets all the values of the {@code MimeHeader} object
+ * in this {@code SOAPPart} object that
+ * is identified by the given {@code String}.
*
* @param name the name of the header; example: "Content-Type"
- * @return a String array giving all the values for the
+ * @return a {@code String} array giving all the values for the
* specified header
* @see #setMimeHeader
*/
@@ -176,13 +175,13 @@
*
* Note that RFC822 headers can contain only US-ASCII characters.
*
- * @param name a String giving the header name
+ * @param name a {@code String} giving the header name
* for which to search
- * @param value a String giving the value to be set.
+ * @param value a {@code String} giving the value to be set.
* This value will be substituted for the current value(s)
* of the first header that is a match if there is one.
* If there is no match, this value will be the value for
- * a new MimeHeader object.
+ * a new {@code MimeHeader} object.
*
* @exception IllegalArgumentException if there was a problem with
* the specified mime header name or value
@@ -191,16 +190,16 @@
public abstract void setMimeHeader(String name, String value);
/**
- * Creates a MimeHeader object with the specified
- * name and value and adds it to this SOAPPart object.
- * If a MimeHeader with the specified name already
+ * Creates a {@code MimeHeader} object with the specified
+ * name and value and adds it to this {@code SOAPPart} object.
+ * If a {@code MimeHeader} with the specified name already
* exists, this method adds the specified value to the already
* existing value(s).
*
* Note that RFC822 headers can contain only US-ASCII characters.
*
- * @param name a String giving the header name
- * @param value a String giving the value to be set
+ * @param name a {@code String} giving the header name
+ * @param value a {@code String} giving the value to be set
* or added
* @exception IllegalArgumentException if there was a problem with
* the specified mime header name or value
@@ -208,44 +207,44 @@
public abstract void addMimeHeader(String name, String value);
/**
- * Retrieves all the headers for this SOAPPart object
- * as an iterator over the MimeHeader objects.
+ * Retrieves all the headers for this {@code SOAPPart} object
+ * as an iterator over the {@code MimeHeader} objects.
*
- * @return an Iterator object with all of the Mime
- * headers for this SOAPPart object
+ * @return an {@code Iterator} object with all of the Mime
+ * headers for this {@code SOAPPart} object
*/
public abstract Iterator getAllMimeHeaders();
/**
- * Retrieves all MimeHeader objects that match a name in
+ * Retrieves all {@code MimeHeader} objects that match a name in
* the given array.
*
- * @param names a String array with the name(s) of the
+ * @param names a {@code String} array with the name(s) of the
* MIME headers to be returned
* @return all of the MIME headers that match one of the names in the
- * given array, returned as an Iterator object
+ * given array, returned as an {@code Iterator} object
*/
public abstract Iterator getMatchingMimeHeaders(String[] names);
/**
- * Retrieves all MimeHeader objects whose name does
+ * Retrieves all {@code MimeHeader} objects whose name does
* not match a name in the given array.
*
- * @param names a String array with the name(s) of the
+ * @param names a {@code String} array with the name(s) of the
* MIME headers not to be returned
- * @return all of the MIME headers in this SOAPPart object
+ * @return all of the MIME headers in this {@code SOAPPart} object
* except those that match one of the names in the
* given array. The nonmatching MIME headers are returned as an
- * Iterator object.
+ * {@code Iterator} object.
*/
public abstract Iterator getNonMatchingMimeHeaders(String[] names);
/**
- * Sets the content of the SOAPEnvelope object with the data
- * from the given Source object. This Source
+ * Sets the content of the {@code SOAPEnvelope} object with the data
+ * from the given {@code Source} object. This {@code Source}
* must contain a valid SOAP document.
*
- * @param source the javax.xml.transform.Source object with the
+ * @param source the {@code javax.xml.transform.Source} object with the
* data to be set
*
* @exception SOAPException if there is a problem in setting the source
@@ -254,13 +253,13 @@
public abstract void setContent(Source source) throws SOAPException;
/**
- * Returns the content of the SOAPEnvelope as a JAXP Source
+ * Returns the content of the SOAPEnvelope as a JAXP {@code Source}
* object.
*
- * @return the content as a javax.xml.transform.Source object
+ * @return the content as a {@code javax.xml.transform.Source} object
*
* @exception SOAPException if the implementation cannot convert
- * the specified Source object
+ * the specified {@code Source} object
* @see #setContent
*/
public abstract Source getContent() throws SOAPException;
--- old/src/java.xml.ws/share/classes/javax/xml/ws/Action.java 2015-04-21 17:20:16.932098475 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/Action.java 2015-04-21 17:20:16.840098475 +0400
@@ -32,89 +32,90 @@
import java.lang.annotation.Target;
/**
- * The Action annotation allows explicit association of a
- * WS-Addressing Action message addressing property with
- * input, output, and
- * fault messages of the mapped WSDL operation.
+ * The {@code Action} annotation allows explicit association of a
+ * WS-Addressing {@code Action} message addressing property with
+ * {@code input}, {@code output}, and
+ * {@code fault} messages of the mapped WSDL operation.
*
* This annotation can be specified on each method of a service endpoint interface.
* For such a method, the mapped operation in the generated WSDL's
- * wsam:Action attribute on the WSDL input,
- * output and fault messages of the WSDL operation
- * is based upon which attributes of the Action annotation have been specified.
- * For the exact computation of wsam:Action values for the messages, refer
+ * {@code wsam:Action} attribute on the WSDL {@code input},
+ * {@code output} and {@code fault} messages of the WSDL {@code operation}
+ * is based upon which attributes of the {@code Action} annotation have been specified.
+ * For the exact computation of {@code wsam:Action} values for the messages, refer
* to the algorithm in the JAX-WS specification.
*
- * Example 1: Specify explicit values for Action message addressing property
- * for input and output messages.
+ * Example 1: Specify explicit values for {@code Action} message addressing property
+ * for {@code input} and {@code output} messages.
*
*
- * @WebService(targetNamespace="http://example.com/numbers")
- * public class AddNumbersImpl {
- * @Action(
- * input="http://example.com/inputAction",
- * output="http://example.com/outputAction")
- * public int addNumbers(int number1, int number2) {
- * return number1 + number2;
- * }
- * }
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ * public class AddNumbersImpl {
+ * {@literal @}Action(
+ * input="http://example.com/inputAction",
+ * output="http://example.com/outputAction")
+ * public int addNumbers(int number1, int number2) {
+ * return number1 + number2;
+ * }
+ * }
*
- * Example 2: Specify explicit value for Action message addressing property
- * for only the input message. The wsam:Action values for the
- * WSDL output message are computed using the algorithm in the JAX-WS specification.
+ * Example 2: Specify explicit value for {@code Action} message addressing property
+ * for only the {@code input} message. The {@code wsam:Action} values for the
+ * WSDL {@code output} message are computed using the algorithm in the JAX-WS specification.
*
*
- * @WebService(targetNamespace="http://example.com/numbers")
- * public class AddNumbersImpl {
- * @Action(input="http://example.com/inputAction")
- * public int addNumbers(int number1, int number2) {
- * return number1 + number2;
- * }
- * }
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ * public class AddNumbersImpl {
+ * {@literal @}Action(input="http://example.com/inputAction")
+ * public int addNumbers(int number1, int number2) {
+ * return number1 + number2;
+ * }
+ * }
*
*
- * It is legitimate to specify an explicit value for Action message addressing property for
- * output message only. In this case, wsam:Action value for the
- * WSDL input message is computed using the algorithm in the JAX-WS specification.
+ * It is legitimate to specify an explicit value for {@code Action} message addressing property for
+ * {@code output} message only. In this case, {@code wsam:Action} value for the
+ * WSDL {@code input} message is computed using the algorithm in the JAX-WS specification.
*
*
* Example 3: See {@link FaultAction} annotation for an example of
- * how to specify an explicit value for Action message addressing property for the
- * fault message.
+ * how to specify an explicit value for {@code Action} message addressing property for the
+ * {@code fault} message.
*
* @see FaultAction
*
@@ -126,21 +127,21 @@
@Target(ElementType.METHOD)
public @interface Action {
/**
- * Explicit value of the WS-Addressing Action message addressing property for the input
+ * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code input}
* message of the operation.
*/
String input() default "";
/**
- * Explicit value of the WS-Addressing Action message addressing property for the output
+ * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code output}
* message of the operation.
*/
String output() default "";
/**
- * Explicit value of the WS-Addressing Action message addressing property for the fault
+ * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code fault}
* message(s) of the operation. Each exception that is mapped to a fault and requires an explicit WS-Addressing
- * Action message addressing property, needs to be specified as a value in this property
+ * {@code Action} message addressing property, needs to be specified as a value in this property
* using {@link FaultAction} annotation.
*/
FaultAction[] fault() default { };
--- old/src/java.xml.ws/share/classes/javax/xml/ws/Binding.java 2015-04-21 17:20:17.288098475 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/Binding.java 2015-04-21 17:20:17.200098475 +0400
@@ -26,7 +26,7 @@
package javax.xml.ws;
-/** The Binding interface is the base interface
+/** The {@code Binding} interface is the base interface
* for JAX-WS protocol bindings.
*
* @since 1.6, JAX-WS 2.0
@@ -35,10 +35,10 @@
/**
* Gets a copy of the handler chain for a protocol binding instance.
- * If the returned chain is modified a call to setHandlerChain
+ * If the returned chain is modified a call to {@code setHandlerChain}
* is required to configure the binding instance with the new chain.
*
- * @return java.util.List<Handler> Handler chain
+ * @return {@code java.util.List} Handler chain
*/
public java.util.List getHandlerChain();
@@ -59,7 +59,7 @@
* Get the URI for this binding instance.
*
* @return String The binding identifier for the port.
- * Never returns null
+ * Never returns {@code null}
*
* @since 1.6, JAX-WS 2.1
*/
--- old/src/java.xml.ws/share/classes/javax/xml/ws/Dispatch.java 2015-04-21 17:20:17.640098475 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/Dispatch.java 2015-04-21 17:20:17.552098475 +0400
@@ -27,10 +27,10 @@
import java.util.concurrent.Future;
-/** The Dispatch interface provides support
+/** The {@code Dispatch} interface provides support
* for the dynamic invocation of a service endpoint operations. The
- * javax.xml.ws.Service
- * class acts as a factory for the creation of Dispatch
+ * {@code javax.xml.ws.Service}
+ * class acts as a factory for the creation of {@code Dispatch}
* instances.
*
* @since 1.6, JAX-WS 2.0
@@ -39,7 +39,7 @@
/** Invoke a service operation synchronously.
*
- * The client is responsible for ensuring that the msg object
+ * The client is responsible for ensuring that the {@code msg} object
* when marshalled is formed according to the requirements of the protocol
* binding in use.
*
@@ -50,16 +50,16 @@
* @throws WebServiceException If a fault occurs during communication with
* the service
* @throws WebServiceException If there is any error in the configuration of
- * the Dispatch instance
+ * the {@code Dispatch} instance
**/
public T invoke(T msg);
/** Invoke a service operation asynchronously. The
* method returns without waiting for the response to the operation
* invocation, the results of the operation are obtained by polling the
- * returned Response.
+ * returned {@code Response}.
*
- * The client is responsible for ensuring that the msg object
+ * The client is responsible for ensuring that the {@code msg} object
* when marshalled is formed according to the requirements of the protocol
* binding in use.
*
@@ -68,16 +68,16 @@
* @return The response message or message payload to the
* operation invocation.
* @throws WebServiceException If there is any error in the configuration of
- * the Dispatch instance
+ * the {@code Dispatch} instance
**/
public Response invokeAsync(T msg);
/** Invoke a service operation asynchronously. The
* method returns without waiting for the response to the operation
* invocation, the results of the operation are communicated to the client
- * via the passed in handler.
+ * via the passed in {@code handler}.
*
- * The client is responsible for ensuring that the msg object
+ * The client is responsible for ensuring that the {@code msg} object
* when marshalled is formed according to the requirements of the protocol
* binding in use.
*
@@ -85,13 +85,13 @@
* the message used to invoke the operation.
* @param handler The handler object that will receive the
* response to the operation invocation.
- * @return A Future object that may be used to check the status
+ * @return A {@code Future} object that may be used to check the status
* of the operation invocation. This object MUST NOT be used to try to
* obtain the results of the operation - the object returned from
- * Future<?>.get() is implementation dependent
+ * {@code Future>.get()} is implementation dependent
* and any use of it will result in non-portable behaviour.
* @throws WebServiceException If there is any error in the configuration of
- * the Dispatch instance
+ * the {@code Dispatch} instance
**/
public Future> invokeAsync(T msg, AsyncHandler handler);
@@ -102,14 +102,14 @@
* the protocol in use is SOAP/HTTP, this method MUST block until
* an HTTP response code has been received or an error occurs.
*
- * The client is responsible for ensuring that the msg object
+ * The client is responsible for ensuring that the {@code msg} object
* when marshalled is formed according to the requirements of the protocol
* binding in use.
*
* @param msg An object that will form the message or payload of
* the message used to invoke the operation.
* @throws WebServiceException If there is any error in the configuration of
- * the Dispatch instance or if an error occurs during the
+ * the {@code Dispatch} instance or if an error occurs during the
* invocation.
**/
public void invokeOneWay(T msg);
--- old/src/java.xml.ws/share/classes/javax/xml/ws/FaultAction.java 2015-04-21 17:20:18.000098474 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/FaultAction.java 2015-04-21 17:20:17.912098474 +0400
@@ -32,28 +32,28 @@
import java.lang.annotation.Target;
/**
- * The FaultAction annotation is used inside an {@link Action}
+ * The {@code FaultAction} annotation is used inside an {@link Action}
* annotation to allow an explicit association of a WS-Addressing
- * Action message addressing property with the fault
+ * {@code Action} message addressing property with the {@code fault}
* messages of the WSDL operation mapped from the exception class.
*
- * The wsam:Action attribute value in the fault
- * message in the generated WSDL operation mapped for className
- * class is equal to the corresponding value in the FaultAction.
- * For the exact computation of wsam:Action values for the
+ * The {@code wsam:Action} attribute value in the {@code fault}
+ * message in the generated WSDL operation mapped for {@code className}
+ * class is equal to the corresponding value in the {@code FaultAction}.
+ * For the exact computation of {@code wsam:Action} values for the
* fault messages, refer to the algorithm in the JAX-WS specification.
*
*
- * Example 1: Specify explicit values for Action message addressing
- * property for the input, output and fault message
+ * Example 1: Specify explicit values for {@code Action} message addressing
+ * property for the {@code input}, {@code output} and {@code fault} message
* if the Java method throws only one service specific exception.
*
*
- * @WebService(targetNamespace="http://example.com/numbers")
- * public class AddNumbersImpl {
- * @Action(
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ * public class AddNumbersImpl {
+ * {@literal @}Action(
* fault = {
- * @FaultAction(className=AddNumbersException.class, value="http://example.com/faultAction")
+ * {@literal @}FaultAction(className=AddNumbersException.class, value="http://example.com/faultAction")
* })
* public int addNumbers(int number1, int number2)
* throws AddNumbersException {
@@ -64,86 +64,86 @@
*
* The generated WSDL looks like:
*
- *
- * Example 2: Here is an example that shows if the explicit value for Action
+ * Example 2: Here is an example that shows if the explicit value for {@code Action}
* message addressing property for the service specific exception is not present.
*
*
- * @WebService(targetNamespace="http://example.com/numbers")
- * public class AddNumbersImpl {
+ * {@literal @}WebService(targetNamespace="http://example.com/numbers")
+ * public class AddNumbersImpl {
* public int addNumbers(int number1, int number2)
* throws AddNumbersException {
* return number1 + number2;
* }
- * }
+ * }
*
- * Example 3: Here is an example that shows how to specify explicit values for Action
+ * Example 3: Here is an example that shows how to specify explicit values for {@code Action}
* message addressing property if the Java method throws more than one service specific exception.
*
*
*
* @since 1.6, JAX-WS 2.1
*/
@@ -158,7 +158,7 @@
Class extends Exception> className();
/**
- * Value of WS-Addressing Action message addressing property for the exception
+ * Value of WS-Addressing {@code Action} message addressing property for the exception
*/
String value() default "";
}
--- old/src/java.xml.ws/share/classes/javax/xml/ws/WebServicePermission.java 2015-04-21 17:20:18.356098474 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/WebServicePermission.java 2015-04-21 17:20:18.268098474 +0400
@@ -35,16 +35,14 @@
* with them.
*
* The following permission target name is defined:
- *
*
*
publishEndpoint
*
+ * The {@code publishEndpoint} permission allows publishing a
+ * web service endpoint using the {@code publish} methods
+ * defined by the {@code javax.xml.ws.Endpoint} class.
*
- * The publishEndpoint permission allows publishing a
- * web service endpoint using the publish methods
- * defined by the javax.xml.ws.Endpoint class.
- *
- * Granting publishEndpoint allows the application to be
+ * Granting {@code publishEndpoint} allows the application to be
* exposed as a network service. Depending on the security of the runtime and
* the security of the application, this may introduce a security hole that
* is remotely exploitable.
@@ -64,7 +62,7 @@
/**
* Creates a new permission with the specified name.
*
- * @param name the name of the WebServicePermission
+ * @param name the name of the {@code WebServicePermission}
*/
public WebServicePermission(String name) {
super(name);
@@ -73,11 +71,11 @@
/**
* Creates a new permission with the specified name and actions.
*
- * The actions parameter is currently unused and
- * it should be null.
+ * The {@code actions} parameter is currently unused and
+ * it should be {@code null}.
*
- * @param name the name of the WebServicePermission
- * @param actions should be null
+ * @param name the name of the {@code WebServicePermission}
+ * @param actions should be {@code null}
*/
public WebServicePermission(String name, String actions) {
super(name, actions);
--- old/src/java.xml.ws/share/classes/javax/xml/ws/handler/HandlerResolver.java 2015-04-21 17:20:18.712098474 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/handler/HandlerResolver.java 2015-04-21 17:20:18.620098474 +0400
@@ -26,15 +26,15 @@
package javax.xml.ws.handler;
/**
- * HandlerResolver is an interface implemented
+ * {@code HandlerResolver} is an interface implemented
* by an application to get control over the handler chain
* set on proxy/dispatch objects at the time of their creation.
*
- * A HandlerResolver may be set on a Service
- * using the setHandlerResolver method.
- *
- * When the runtime invokes a HandlerResolver, it will
- * pass it a PortInfo object containing information
+ * A {@code HandlerResolver} may be set on a {@code Service}
+ * using the {@code setHandlerResolver} method.
+ *
+ * When the runtime invokes a {@code HandlerResolver}, it will
+ * pass it a {@code PortInfo} object containing information
* about the port that the proxy/dispatch object will be accessing.
*
* @see javax.xml.ws.Service#setHandlerResolver
@@ -47,7 +47,7 @@
* Gets the handler chain for the specified port.
*
* @param portInfo Contains information about the port being accessed.
- * @return java.util.List<Handler> chain
+ * @return {@code java.util.List} chain
**/
public java.util.List getHandlerChain(PortInfo portInfo);
}
--- old/src/java.xml.ws/share/classes/javax/xml/ws/handler/MessageContext.java 2015-04-21 17:20:19.068098474 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/handler/MessageContext.java 2015-04-21 17:20:18.980098474 +0400
@@ -27,12 +27,12 @@
import java.util.Map;
/**
- * The interface MessageContext abstracts the message
- * context that is processed by a handler in the handle
+ * The interface {@code MessageContext} abstracts the message
+ * context that is processed by a handler in the {@code handle}
* method.
*
- *
The MessageContext interface provides methods to
- * manage a property set. MessageContext properties
+ *
The {@code MessageContext} interface provides methods to
+ * manage a property set. {@code MessageContext} properties
* enable handlers in a handler chain to share processing related
* state.
*
@@ -41,8 +41,8 @@
public interface MessageContext extends Map {
/**
- * Standard property: message direction, true for
- * outbound messages, false for inbound.
+ * Standard property: message direction, {@code true} for
+ * outbound messages, {@code false} for inbound.
*
Type: boolean
*/
public static final String MESSAGE_OUTBOUND_PROPERTY =
@@ -51,7 +51,7 @@
/**
* Standard property: Map of attachments to a message for the inbound
* message, key is the MIME Content-ID, value is a DataHandler.
- *
Type: java.util.Map<String,DataHandler>
+ *
Type: {@code java.util.Map}
*/
public static final String INBOUND_MESSAGE_ATTACHMENTS =
"javax.xml.ws.binding.attachments.inbound";
@@ -59,7 +59,7 @@
/**
* Standard property: Map of attachments to a message for the outbound
* message, key is the MIME Content-ID, value is a DataHandler.
- *
Type: java.util.Map<String,DataHandler>
+ *
Type: {@code java.util.Map}
*/
public static final String OUTBOUND_MESSAGE_ATTACHMENTS =
"javax.xml.ws.binding.attachments.outbound";
@@ -108,14 +108,14 @@
/**
* Standard property: HTTP request headers.
- *
Type: {@code java.util.Map>}
*/
public static final String HTTP_RESPONSE_HEADERS =
"javax.xml.ws.http.response.headers";
@@ -166,7 +166,7 @@
* Standard property: WS Addressing Reference Parameters.
* The list MUST include all SOAP headers marked with the
* wsa:IsReferenceParameter="true" attribute.
- *
Type: List<Element>
+ *
Type: {@code List}
*
* @since 1.6, JAX-WS 2.1
*/
@@ -174,10 +174,10 @@
"javax.xml.ws.reference.parameters";
/**
- * Property scope. Properties scoped as APPLICATION are
+ * Property scope. Properties scoped as {@code APPLICATION} are
* visible to handlers,
* client applications and service endpoints; properties scoped as
- * HANDLER
+ * {@code HANDLER}
* are only normally visible to handlers.
*/
public enum Scope {APPLICATION, HANDLER};
@@ -186,7 +186,7 @@
* Sets the scope of a property.
*
* @param name Name of the property associated with the
- * MessageContext
+ * {@code MessageContext}
* @param scope Desired scope of the property
* @throws java.lang.IllegalArgumentException if an illegal
* property name is specified
--- old/src/java.xml.ws/share/classes/javax/xml/ws/soap/AddressingFeature.java 2015-04-21 17:20:19.424098473 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/soap/AddressingFeature.java 2015-04-21 17:20:19.336098473 +0400
@@ -52,10 +52,10 @@
* receiver.
*
*
- * If the feature is enabled, the required property determines
+ * If the feature is enabled, the {@code required} property determines
* whether the endpoint requires WS-Addressing. If it is set true,
* WS-Addressing headers MUST be present on incoming and outgoing messages.
- * By default the required property is false.
+ * By default the {@code required} property is {@code false}.
*
*
* If the web service developer has not explicitly enabled this feature,
@@ -75,31 +75,31 @@
*
*
* Example 1: Possible Policy Assertion in the generated WSDL for
- * @Addressing
- *
@@ -181,7 +181,7 @@
private final Responses responses;
/**
- * Creates and configures an AddressingFeature with the
+ * Creates and configures an {@code AddressingFeature} with the
* use of addressing requirements. The created feature enables
* ws-addressing i.e. supports ws-addressing but doesn't require
* its use. It is also configured to accept all the response types.
@@ -191,8 +191,8 @@
}
/**
- * Creates and configures an AddressingFeature with the
- * use of addressing requirements. If enabled is true,
+ * Creates and configures an {@code AddressingFeature} with the
+ * use of addressing requirements. If {@code enabled} is true,
* it enables ws-addressing i.e. supports ws-addressing but doesn't
* require its use. It also configures to accept all the response types.
*
@@ -204,9 +204,9 @@
}
/**
- * Creates and configures an AddressingFeature with the
- * use of addressing requirements. If enabled and
- * required are true, it enables ws-addressing and
+ * Creates and configures an {@code AddressingFeature} with the
+ * use of addressing requirements. If {@code enabled} and
+ * {@code required} are true, it enables ws-addressing and
* requires its use. It also configures to accept all the response types.
*
* @param enabled true enables ws-addressing i.e.ws-addressing
@@ -218,11 +218,11 @@
}
/**
- * Creates and configures an AddressingFeature with the
- * use of addressing requirements. If enabled and
- * required are true, it enables ws-addressing and
+ * Creates and configures an {@code AddressingFeature} with the
+ * use of addressing requirements. If {@code enabled} and
+ * {@code required} are true, it enables ws-addressing and
* requires its use. Also, the response types can be configured using
- * responses parameter.
+ * {@code responses} parameter.
*
* @param enabled true enables ws-addressing i.e.ws-addressing
* is supported but doesn't require its use
@@ -260,7 +260,6 @@
* requires the use of anonymous responses, or non-anonymous responses,
* or all responses.
*
- *
* @return {@link Responses#ALL} when endpoint supports all types of
* responses,
* {@link Responses#ANONYMOUS} when endpoint requires the use of
--- old/src/java.xml.ws/share/classes/javax/xml/ws/soap/MTOM.java 2015-04-21 17:20:19.784098473 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/soap/MTOM.java 2015-04-21 17:20:19.692098473 +0400
@@ -40,14 +40,14 @@
* web service.
*
* This annotation MUST only be used in conjunction the
- * javax.jws.WebService, {@link WebServiceProvider},
+ * {@code javax.jws.WebService}, {@link WebServiceProvider},
* {@link WebServiceRef} annotations.
- * When used with the javax.jws.WebService annotation this
+ * When used with the {@code javax.jws.WebService} annotation this
* annotation MUST only be used on the service endpoint implementation
* class.
- * When used with a WebServiceRef annotation, this annotation
+ * When used with a {@code WebServiceRef} annotation, this annotation
* MUST only be used when a proxy instance is created. The injected SEI
- * proxy, and endpoint MUST honor the values of the MTOM
+ * proxy, and endpoint MUST honor the values of the {@code MTOM}
* annotation.
*
*
@@ -69,7 +69,7 @@
/**
* Property for MTOM threshold value. When MTOM is enabled, binary data above this
* size in bytes will be XOP encoded or sent as attachment. The value of this property
- * MUST always be >= 0. Default value is 0.
+ * MUST always be {@literal >=} 0. Default value is 0.
*/
int threshold() default 0;
}
--- old/src/java.xml.ws/share/classes/javax/xml/ws/soap/MTOMFeature.java 2015-04-21 17:20:20.136098473 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/soap/MTOMFeature.java 2015-04-21 17:20:20.048098473 +0400
@@ -67,14 +67,14 @@
* Property for MTOM threshold value. This property serves as a hint when
* MTOM is enabled, binary data above this size in bytes SHOULD be sent
* as attachment.
- * The value of this property MUST always be >= 0. Default value is 0.
+ * The value of this property MUST always be {@literal >=} 0. Default value is 0.
*/
// should be changed to private final, keeping original modifier to keep backwards compatibility
protected int threshold;
/**
- * Create an MTOMFeature.
+ * Create an {@code MTOMFeature}.
* The instance created will be enabled.
*/
public MTOMFeature() {
@@ -83,7 +83,7 @@
}
/**
- * Creates an MTOMFeature.
+ * Creates a {@code MTOMFeature}.
*
* @param enabled specifies if this feature should be enabled or not
*/
@@ -94,13 +94,13 @@
/**
- * Creates an MTOMFeature.
+ * Creates a {@code MTOMFeature}.
* The instance created will be enabled.
*
* @param threshold the size in bytes that binary data SHOULD be before
* being sent as an attachment.
*
- * @throws WebServiceException if threshold is < 0
+ * @throws WebServiceException if threshold is {@literal <} 0
*/
public MTOMFeature(int threshold) {
if (threshold < 0)
@@ -110,13 +110,13 @@
}
/**
- * Creates an MTOMFeature.
+ * Creates a {@code MTOMFeature}.
*
* @param enabled specifies if this feature should be enabled or not
* @param threshold the size in bytes that binary data SHOULD be before
* being sent as an attachment.
*
- * @throws WebServiceException if threshold is < 0
+ * @throws WebServiceException if threshold is {@literal <} 0
*/
public MTOMFeature(boolean enabled, int threshold) {
if (threshold < 0)
--- old/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPBinding.java 2015-04-21 17:20:20.492098472 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPBinding.java 2015-04-21 17:20:20.404098472 +0400
@@ -31,7 +31,7 @@
import javax.xml.soap.SOAPFactory;
import javax.xml.soap.MessageFactory;
-/** The SOAPBinding interface is an abstraction for
+/** The {@code SOAPBinding} interface is an abstraction for
* the SOAP binding.
*
* @since 1.6, JAX-WS 2.0
@@ -63,7 +63,7 @@
/** Gets the roles played by the SOAP binding instance.
*
- * @return Set<String> The set of roles played by the binding instance.
+ * @return {@code Set} The set of roles played by the binding instance.
**/
public Set getRoles();
@@ -76,9 +76,9 @@
public void setRoles(Set roles);
/**
- * Returns true if the use of MTOM is enabled.
+ * Returns {@code true} if the use of MTOM is enabled.
*
- * @return true if and only if the use of MTOM is enabled.
+ * @return {@code true} if and only if the use of MTOM is enabled.
**/
public boolean isMTOMEnabled();
@@ -86,7 +86,7 @@
/**
* Enables or disables use of MTOM.
*
- * @param flag A boolean specifying whether the use of MTOM should
+ * @param flag A {@code boolean} specifying whether the use of MTOM should
* be enabled or disabled.
* @throws WebServiceException If the specified setting is not supported
* by this binding instance.
@@ -95,14 +95,14 @@
public void setMTOMEnabled(boolean flag);
/**
- * Gets the SAAJ SOAPFactory instance used by this SOAP binding.
+ * Gets the SAAJ {@code SOAPFactory} instance used by this SOAP binding.
*
* @return SOAPFactory instance used by this SOAP binding.
**/
public SOAPFactory getSOAPFactory();
/**
- * Gets the SAAJ MessageFactory instance used by this SOAP binding.
+ * Gets the SAAJ {@code MessageFactory} instance used by this SOAP binding.
*
* @return MessageFactory instance used by this SOAP binding.
**/
--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/Provider.java 2015-04-21 17:20:20.848098472 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/Provider.java 2015-04-21 17:20:20.756098472 +0400
@@ -37,9 +37,8 @@
import org.w3c.dom.Element;
/**
- * Service provider for ServiceDelegate and
- * Endpoint objects.
- *
+ * Service provider for {@code ServiceDelegate} and
+ * {@code Endpoint} objects.
*
* @since 1.6, JAX-WS 2.0
*/
@@ -47,14 +46,14 @@
/**
* A constant representing the property used to lookup the
- * name of a Provider implementation
+ * name of a {@code Provider} implementation
* class.
*/
static public final String JAXWSPROVIDER_PROPERTY = "javax.xml.ws.spi.Provider";
/**
* A constant representing the name of the default
- * Provider implementation class.
+ * {@code Provider} implementation class.
**/
// Using two strings so that package renaming doesn't change it
static final String DEFAULT_JAXWSPROVIDER
@@ -72,22 +71,21 @@
*
* The algorithm used to locate the provider subclass to use consists
* of the following steps:
- *
*
*
* If a resource with the name of
- * META-INF/services/javax.xml.ws.spi.Provider
+ * {@code META-INF/services/javax.xml.ws.spi.Provider}
* exists, then its first line, if present, is used as the UTF-8 encoded
* name of the implementation class.
*
*
* If the $java.home/lib/jaxws.properties file exists and it is readable by
- * the java.util.Properties.load(InputStream) method and it contains
- * an entry whose key is javax.xml.ws.spi.Provider, then the value of
+ * the {@code java.util.Properties.load(InputStream)} method and it contains
+ * an entry whose key is {@code javax.xml.ws.spi.Provider}, then the value of
* that entry is used as the name of the implementation class.
*
*
- * If a system property with the name javax.xml.ws.spi.Provider
+ * If a system property with the name {@code javax.xml.ws.spi.Provider}
* is defined, then its value is used as the name of the implementation class.
*
*
@@ -136,12 +134,12 @@
/**
* Creates a service delegate object.
- *
+ *
* @param wsdlDocumentLocation A URL pointing to the WSDL document
- * for the service, or null if there isn't one.
+ * for the service, or {@code null} if there isn't one.
* @param serviceName The qualified name of the service.
* @param serviceClass The service class, which MUST be either
- * javax.xml.ws.Service or a subclass thereof.
+ * {@code javax.xml.ws.Service} or a subclass thereof.
* @return The newly created service delegate.
*/
public abstract ServiceDelegate createServiceDelegate(
@@ -150,12 +148,12 @@
/**
* Creates a service delegate object.
- *
+ *
* @param wsdlDocumentLocation A URL pointing to the WSDL document
- * for the service, or null if there isn't one.
+ * for the service, or {@code null} if there isn't one.
* @param serviceName The qualified name of the service.
* @param serviceClass The service class, which MUST be either
- * javax.xml.ws.Service or a subclass thereof.
+ * {@code javax.xml.ws.Service} or a subclass thereof.
* @param features Web Service features that must be configured on
* the service. If the provider doesn't understand a feature,
* it must throw a WebServiceException.
@@ -205,18 +203,18 @@
/**
* read an EndpointReference from the infoset contained in
- * eprInfoset.
+ * {@code eprInfoset}.
*
* @param eprInfoset infoset for EndpointReference
*
- * @return the EndpointReference unmarshalled from
- * eprInfoset. This method never returns null.
+ * @return the {@code EndpointReference} unmarshalled from
+ * {@code eprInfoset}. This method never returns {@code null}.
*
* @throws WebServiceException If there is an error creating the
- * EndpointReference from the specified eprInfoset.
+ * {@code EndpointReference} from the specified {@code eprInfoset}.
*
- * @throws NullPointerException If the null
- * eprInfoset value is given.
+ * @throws NullPointerException If the {@code null}
+ * {@code eprInfoset} value is given.
*
* @since 1.6, JAX-WS 2.1
**/
@@ -226,31 +224,31 @@
/**
* The getPort method returns a proxy. If there
* are any reference parameters in the
- * endpointReference, then those reference
+ * {@code endpointReference}, then those reference
* parameters MUST appear as SOAP headers, indicating them to be
* reference parameters, on all messages sent to the endpoint.
- * The parameter serviceEndpointInterface specifies
+ * The parameter {@code serviceEndpointInterface} specifies
* the service endpoint interface that is supported by the
* returned proxy.
- * The parameter endpointReference specifies the
+ * The parameter {@code endpointReference} specifies the
* endpoint that will be invoked by the returned proxy.
* In the implementation of this method, the JAX-WS
* runtime system takes the responsibility of selecting a protocol
* binding (and a port) and configuring the proxy accordingly from
* the WSDL metadata of the
- * serviceEndpointInterface and the EndpointReference.
+ * {@code serviceEndpointInterface} and the {@code EndpointReference}.
* For this method
* to successfully return a proxy, WSDL metadata MUST be available and the
- * endpointReference MUST contain an implementation understood
- * serviceName metadata.
+ * {@code endpointReference} MUST contain an implementation understood
+ * {@code serviceName} metadata.
*
*
* @param endpointReference the EndpointReference that will
* be invoked by the returned proxy.
* @param serviceEndpointInterface Service endpoint interface
* @param features A list of WebServiceFeatures to configure on the
- * proxy. Supported features not in the features
- * parameter will have their default values.
+ * proxy. Supported features not in the {@code features
+ * } parameter will have their default values.
* @return Object Proxy instance that supports the
* specified service endpoint interface
* @throws WebServiceException
@@ -260,10 +258,10 @@
*
If there is any missing WSDL metadata
* as required by this method}
*
If this
- * endpointReference
+ * {@code endpointReference}
* is illegal
*
If an illegal
- * serviceEndpointInterface
+ * {@code serviceEndpointInterface}
* is specified
*
If a feature is enabled that is not compatible with
* this port or is unsupported.
@@ -278,60 +276,60 @@
WebServiceFeature... features);
/**
- * Factory method to create a W3CEndpointReference.
+ * Factory method to create a {@code W3CEndpointReference}.
*
*
- * This method can be used to create a W3CEndpointReference
- * for any endpoint by specifying the address property along
+ * This method can be used to create a {@code W3CEndpointReference}
+ * for any endpoint by specifying the {@code address} property along
* with any other desired properties. This method
- * can also be used to create a W3CEndpointReference for
+ * can also be used to create a {@code W3CEndpointReference} for
* an endpoint that is published by the same Java EE application.
- * To do so the address property can be provided or this
- * method can automatically determine the address of
+ * To do so the {@code address} property can be provided or this
+ * method can automatically determine the {@code address} of
* an endpoint that is published by the same Java EE application and is
- * identified by the serviceName and
- * portName propeties. If the address is
- * null and the serviceName and
- * portName do not identify an endpoint published by the
+ * identified by the {@code serviceName} and
+ * {@code portName} propeties. If the {@code address} is
+ * {@code null} and the {@code serviceName} and
+ * {@code portName} do not identify an endpoint published by the
* same Java EE application, a
- * javax.lang.IllegalStateException MUST be thrown.
+ * {@code javax.lang.IllegalStateException} MUST be thrown.
*
* @param address Specifies the address of the target endpoint
* @param serviceName Qualified name of the service in the WSDL.
* @param portName Qualified name of the endpoint in the WSDL.
* @param metadata A list of elements that should be added to the
- * W3CEndpointReference instances wsa:metadata
+ * {@code W3CEndpointReference} instances {@code wsa:metadata}
* element.
* @param wsdlDocumentLocation URL for the WSDL document location for
* the service.
* @param referenceParameters Reference parameters to be associated
- * with the returned EndpointReference instance.
+ * with the returned {@code EndpointReference} instance.
*
- * @return the W3CEndpointReference created from
- * serviceName, portName,
- * metadata, wsdlDocumentLocation
- * and referenceParameters. This method
- * never returns null.
+ * @return the {@code W3CEndpointReference} created from
+ * {@code serviceName}, {@code portName},
+ * {@code metadata}, {@code wsdlDocumentLocation}
+ * and {@code referenceParameters}. This method
+ * never returns {@code null}.
*
* @throws java.lang.IllegalStateException
*
- *
If the address, serviceName and
- * portName are all null.
- *
If the serviceName service is null and the
- * portName is NOT null.
- *
If the address property is null and
- * the serviceName and portName do not
+ *
If the {@code address}, {@code serviceName} and
+ * {@code portName} are all {@code null}.
+ *
If the {@code serviceName} service is {@code null} and the
+ * {@code portName} is NOT {@code null}.
+ *
If the {@code address} property is {@code null} and
+ * the {@code serviceName} and {@code portName} do not
* specify a valid endpoint published by the same Java EE
* application.
- *
If the serviceNameis NOT null
+ *
If the {@code serviceName}is NOT {@code null}
* and is not present in the specified WSDL.
- *
If the portName port is not null and it
- * is not present in serviceName service in the WSDL.
- *
If the wsdlDocumentLocation is NOT null
+ *
If the {@code portName} port is not {@code null} and it
+ * is not present in {@code serviceName} service in the WSDL.
+ *
If the {@code wsdlDocumentLocation} is NOT {@code null}
* and does not represent a valid WSDL.
*
* @throws WebServiceException If an error occurs while creating the
- * W3CEndpointReference.
+ * {@code W3CEndpointReference}.
*
* @since 1.6, JAX-WS 2.1
*/
@@ -340,73 +338,73 @@
/**
- * Factory method to create a W3CEndpointReference.
- * Using this method, a W3CEndpointReference instance
+ * Factory method to create a {@code W3CEndpointReference}.
+ * Using this method, a {@code W3CEndpointReference} instance
* can be created with extension elements, and attributes.
- * Provider implementations must override the default
+ * {@code Provider} implementations must override the default
* implementation.
*
*
- * This method can be used to create a W3CEndpointReference
- * for any endpoint by specifying the address property along
+ * This method can be used to create a {@code W3CEndpointReference}
+ * for any endpoint by specifying the {@code address} property along
* with any other desired properties. This method
- * can also be used to create a W3CEndpointReference for
+ * can also be used to create a {@code W3CEndpointReference} for
* an endpoint that is published by the same Java EE application.
- * To do so the address property can be provided or this
- * method can automatically determine the address of
+ * To do so the {@code address} property can be provided or this
+ * method can automatically determine the {@code address} of
* an endpoint that is published by the same Java EE application and is
- * identified by the serviceName and
- * portName propeties. If the address is
- * null and the serviceName and
- * portName do not identify an endpoint published by the
+ * identified by the {@code serviceName} and
+ * {@code portName} propeties. If the {@code address} is
+ * {@code null} and the {@code serviceName} and
+ * {@code portName} do not identify an endpoint published by the
* same Java EE application, a
- * javax.lang.IllegalStateException MUST be thrown.
+ * {@code javax.lang.IllegalStateException} MUST be thrown.
*
* @param address Specifies the address of the target endpoint
- * @param interfaceName the wsam:InterfaceName element in the
- * wsa:Metadata element.
+ * @param interfaceName the {@code wsam:InterfaceName} element in the
+ * {@code wsa:Metadata} element.
* @param serviceName Qualified name of the service in the WSDL.
* @param portName Qualified name of the endpoint in the WSDL.
* @param metadata A list of elements that should be added to the
- * W3CEndpointReference instances wsa:metadata
+ * {@code W3CEndpointReference} instances {@code wsa:metadata}
* element.
* @param wsdlDocumentLocation URL for the WSDL document location for
* the service.
* @param referenceParameters Reference parameters to be associated
- * with the returned EndpointReference instance.
+ * with the returned {@code EndpointReference} instance.
* @param elements extension elements to be associated
- * with the returned EndpointReference instance.
+ * with the returned {@code EndpointReference} instance.
* @param attributes extension attributes to be associated
- * with the returned EndpointReference instance.
+ * with the returned {@code EndpointReference} instance.
*
- * @return the W3CEndpointReference created from
- * serviceName, portName,
- * metadata, wsdlDocumentLocation
- * and referenceParameters. This method
- * never returns null.
+ * @return the {@code W3CEndpointReference} created from
+ * {@code serviceName}, {@code portName},
+ * {@code metadata}, {@code wsdlDocumentLocation}
+ * and {@code referenceParameters}. This method
+ * never returns {@code null}.
*
* @throws java.lang.IllegalStateException
*
- *
If the address, serviceName and
- * portName are all null.
- *
If the serviceName service is null and the
- * portName is NOT null.
- *
If the address property is null and
- * the serviceName and portName do not
+ *
If the {@code address}, {@code serviceName} and
+ * {@code portName} are all {@code null}.
+ *
If the {@code serviceName} service is {@code null} and the
+ * {@code portName} is NOT {@code null}.
+ *
If the {@code address} property is {@code null} and
+ * the {@code serviceName} and {@code portName} do not
* specify a valid endpoint published by the same Java EE
* application.
- *
If the serviceNameis NOT null
+ *
If the {@code serviceName}is NOT {@code null}
* and is not present in the specified WSDL.
- *
If the portName port is not null and it
- * is not present in serviceName service in the WSDL.
- *
If the wsdlDocumentLocation is NOT null
+ *
If the {@code portName} port is not {@code null} and it
+ * is not present in {@code serviceName} service in the WSDL.
+ *
If the {@code wsdlDocumentLocation} is NOT {@code null}
* and does not represent a valid WSDL.
- *
If the wsdlDocumentLocation is NOT null but
+ *
If the {@code wsdlDocumentLocation} is NOT {@code null} but
* wsdli:wsdlLocation's namespace name cannot be got from the available
* metadata.
*
* @throws WebServiceException If an error occurs while creating the
- * W3CEndpointReference.
+ * {@code W3CEndpointReference}.
* @since 1.7, JAX-WS 2.2
*/
public W3CEndpointReference createW3CEndpointReference(String address,
@@ -419,7 +417,7 @@
/**
* Creates and publishes an endpoint object with the specified
* address, implementation object and web service features.
- * Provider implementations must override the
+ * {@code Provider} implementations must override the
* default implementation.
*
* @param address A URI specifying the address and transport/protocol
@@ -431,8 +429,8 @@
* class MUST be annotated with all the necessary Web service
* annotations.
* @param features A list of WebServiceFeatures to configure on the
- * endpoint. Supported features not in the features
- * parameter will have their default values.
+ * endpoint. Supported features not in the {@code features}
+ * parameter will have their default values.
* @return The newly created endpoint.
* @since 1.7, JAX-WS 2.2
*/
@@ -443,7 +441,7 @@
/**
* Creates an endpoint object with the provided binding, implementation
- * object and web service features. Provider implementations
+ * object and web service features. {@code Provider} implementations
* must override the default implementation.
*
* @param bindingId A URI specifying the desired binding (e.g. SOAP/HTTP)
@@ -452,8 +450,8 @@
* class MUST be annotated with all the necessary Web service
* annotations.
* @param features A list of WebServiceFeatures to configure on the
- * endpoint. Supported features not in the features
- * parameter will have their default values.
+ * endpoint. Supported features not in the {@code features}
+ * parameter will have their default values.
* @return The newly created endpoint.
* @since 1.7, JAX-WS 2.2
*/
@@ -465,7 +463,7 @@
/**
* Creates an endpoint object with the provided binding, implementation
* class, invoker and web service features. Containers typically use
- * this to create Endpoint objects. Provider
+ * this to create Endpoint objects. {@code Provider}
* implementations must override the default implementation.
*
* @param bindingId A URI specifying the desired binding (e.g. SOAP/HTTP).
@@ -475,8 +473,8 @@
* annotations.
* @param invoker that does the actual invocation on the service instance.
* @param features A list of WebServiceFeatures to configure on the
- * endpoint. Supported features not in the features
- * parameter will have their default values.
+ * endpoint. Supported features not in the {@code features
+ * } parameter will have their default values.
* @return The newly created endpoint.
* @since 1.7, JAX-WS 2.2
*/
--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/WebServiceFeatureAnnotation.java 2015-04-21 17:20:21.212098472 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/WebServiceFeatureAnnotation.java 2015-04-21 17:20:21.124098472 +0400
@@ -39,27 +39,26 @@
/**
* Annotation used to identify other annotations
- * as a WebServiceFeature.
+ * as a {@code WebServiceFeature}.
*
- * Each WebServiceFeature annotation annotated with
+ * Each {@code WebServiceFeature} annotation annotated with
* this annotation MUST contain an
- * enabled property of type
- * boolean with a default value of true.
+ * {@code enabled} property of type
+ * {@code boolean} with a default value of {@code true}.
*
* JAX-WS defines the following
- * WebServiceFeature annotations (Addressing,
- * MTOM, RespectBinding), however, an implementation
+ * {@code WebServiceFeature} annotations ({@code Addressing},
+ * {@code MTOM}, {@code RespectBinding}), however, an implementation
* may define vendors specific annotations for other features.
*
- * Annotations annotated with WebServiceFeatureAnnotation MUST
+ * Annotations annotated with {@code WebServiceFeatureAnnotation} MUST
* have the same @Target of {@link WebServiceRef} annotation, so that the resulting
* feature annotation can be used in conjunction with the {@link WebServiceRef}
* annotation if necessary.
*
* If a JAX-WS implementation encounters an annotation annotated
- * with the WebServiceFeatureAnnotation that it does not
+ * with the {@code WebServiceFeatureAnnotation} that it does not
* recognize/support an error MUST be given.
- *
*
* @see Addressing
* @see MTOM
@@ -79,8 +78,8 @@
String id();
/**
- * The WebServiceFeature bean that is associated
- * with the WebServiceFeature annotation
+ * The {@code WebServiceFeature} bean that is associated
+ * with the {@code WebServiceFeature} annotation
*/
Class extends WebServiceFeature> bean();
}
--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/package-info.java 2015-04-21 17:20:21.572098471 +0400
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/package-info.java 2015-04-21 17:20:21.480098472 +0400
@@ -47,7 +47,7 @@
object encapsulates a HTTP request and a response.
-