Mercurial > hg > jdk9-shenandoah > jaxws
changeset 612:6232472e5141 jdk9-b74
Merge
| author | lana |
|---|---|
| date | Thu, 16 Jul 2015 19:27:53 -0700 |
| parents | 5ce7ccacd056 (current diff) b6421bef83ff (diff) |
| children | 086bcd5e4a53 |
| files | |
| diffstat | 73 files changed, 1540 insertions(+), 1540 deletions(-) [+] |
line wrap: on
line diff
--- a/src/java.annotations.common/share/classes/javax/annotation/PostConstruct.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.annotations.common/share/classes/javax/annotation/PostConstruct.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -39,6 +39,7 @@ * method can be annotated with this annotation. The method on which the * PostConstruct annotation is applied MUST fulfill all of the following * criteria: + * <p> * <ul> * <li>The method MUST NOT have any parameters except in the case of * interceptors in which case it takes an InvocationContext object as
--- a/src/java.annotations.common/share/classes/javax/annotation/PreDestroy.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.annotations.common/share/classes/javax/annotation/PreDestroy.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -38,6 +38,7 @@ * 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: + * <p> * <ul> * <li>The method MUST NOT have any parameters except in the case of * interceptors in which case it takes an InvocationContext object as
--- a/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterImpl.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterImpl.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -124,7 +124,7 @@ } public static long _parseLong(CharSequence s) { - return Long.valueOf(removeOptionalPlus(WhiteSpaceProcessor.trim(s)).toString()); + return Long.parseLong(removeOptionalPlus(WhiteSpaceProcessor.trim(s)).toString()); } public short parseShort(String lexicalXSDShort) {
--- a/src/java.xml.ws/share/classes/javax/xml/soap/AttachmentPart.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/AttachmentPart.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it
--- a/src/java.xml.ws/share/classes/javax/xml/soap/Detail.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/Detail.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -30,43 +30,43 @@ import javax.xml.namespace.QName; /** - * A container for <code>DetailEntry</code> objects. <code>DetailEntry</code> + * A container for {@code DetailEntry} objects. {@code DetailEntry} * objects give detailed error information that is application-specific and - * related to the <code>SOAPBody</code> object that contains it. + * related to the {@code SOAPBody} object that contains it. *<P> - * A <code>Detail</code> object, which is part of a <code>SOAPFault</code> - * object, can be retrieved using the method <code>SOAPFault.getDetail</code>. - * The <code>Detail</code> interface provides two methods. One creates a new - * <code>DetailEntry</code> object and also automatically adds it to - * the <code>Detail</code> object. The second method gets a list of the - * <code>DetailEntry</code> objects contained in a <code>Detail</code> + * A {@code Detail} object, which is part of a {@code SOAPFault} + * object, can be retrieved using the method {@code SOAPFault.getDetail}. + * The {@code Detail} interface provides two methods. One creates a new + * {@code DetailEntry} object and also automatically adds it to + * the {@code Detail} object. The second method gets a list of the + * {@code DetailEntry} objects contained in a {@code Detail} * object. * <P> - * The following code fragment, in which <i>sf</i> is a <code>SOAPFault</code> - * object, gets its <code>Detail</code> object (<i>d</i>), adds a new - * <code>DetailEntry</code> object to <i>d</i>, and then gets a list of all the - * <code>DetailEntry</code> objects in <i>d</i>. The code also creates a - * <code>Name</code> object to pass to the method <code>addDetailEntry</code>. - * The variable <i>se</i>, used to create the <code>Name</code> object, - * is a <code>SOAPEnvelope</code> object. - * <PRE> + * The following code fragment, in which <i>sf</i> is a {@code SOAPFault} + * object, gets its {@code Detail} object (<i>d</i>), adds a new + * {@code DetailEntry} object to <i>d</i>, and then gets a list of all the + * {@code DetailEntry} objects in <i>d</i>. The code also creates a + * {@code Name} object to pass to the method {@code addDetailEntry}. + * The variable <i>se</i>, used to create the {@code Name} object, + * is a {@code SOAPEnvelope} object. + * <pre>{@code * Detail d = sf.getDetail(); * Name name = se.createName("GetLastTradePrice", "WOMBAT", * "http://www.wombat.org/trader"); * d.addDetailEntry(name); * Iterator it = d.getDetailEntries(); - * </PRE> + * }</pre> * * @since 1.6 */ public interface Detail extends SOAPFaultElement { /** - * Creates a new <code>DetailEntry</code> object with the given - * name and adds it to this <code>Detail</code> object. + * Creates a new {@code DetailEntry} object with the given + * name and adds it to this {@code Detail} object. * - * @param name a <code>Name</code> object identifying the - * new <code>DetailEntry</code> object + * @param name a {@code Name} object identifying the + * new {@code DetailEntry} object * * @exception SOAPException thrown when there is a problem in adding a * DetailEntry object to this Detail object. @@ -76,12 +76,12 @@ public DetailEntry addDetailEntry(Name name) throws SOAPException; /** - * Creates a new <code>DetailEntry</code> object with the given - * QName and adds it to this <code>Detail</code> object. This method + * Creates a new {@code DetailEntry} object with the given + * QName and adds it to this {@code Detail} object. This method * is the preferred over the one using Name. * - * @param qname a <code>QName</code> object identifying the - * new <code>DetailEntry</code> object + * @param qname a {@code QName} object identifying the + * new {@code DetailEntry} object * * @exception SOAPException thrown when there is a problem in adding a * DetailEntry object to this Detail object. @@ -92,10 +92,10 @@ public DetailEntry addDetailEntry(QName qname) throws SOAPException; /** - * Gets an Iterator over all of the <code>DetailEntry</code>s in this <code>Detail</code> object. + * Gets an Iterator over all of the {@code DetailEntry}s in this {@code Detail} object. * - * @return an <code>Iterator</code> object over the <code>DetailEntry</code> - * objects in this <code>Detail</code> object + * @return an {@code Iterator} object over the {@code DetailEntry} + * objects in this {@code Detail} object */ public Iterator getDetailEntries(); }
--- a/src/java.xml.ws/share/classes/javax/xml/soap/DetailEntry.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/DetailEntry.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,9 +26,9 @@ package javax.xml.soap; /** - * The content for a <code>Detail</code> object, giving details for - * a <code>SOAPFault</code> object. A <code>DetailEntry</code> object, - * which carries information about errors related to the <code>SOAPBody</code> + * The content for a {@code Detail} object, giving details for + * a {@code SOAPFault} object. A {@code DetailEntry} object, + * which carries information about errors related to the {@code SOAPBody} * object that contains it, is application-specific. * * @since 1.6
--- a/src/java.xml.ws/share/classes/javax/xml/soap/FactoryFinder.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/FactoryFinder.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -33,7 +33,7 @@ /** * Creates an instance of the specified class using the specified - * <code>ClassLoader</code> object. + * {@code ClassLoader} object. * * @exception SOAPException if the given class could not be found * or could not be instantiated @@ -54,13 +54,13 @@ } /** - * Finds the implementation <code>Class</code> object for the given + * Finds the implementation {@code Class} object for the given * factory name, or null if that fails. * <P> * This method is package private so that this code can be shared. * - * @return the <code>Class</code> object of the specified message factory; - * or <code>null</code> + * @return the {@code Class} object of the specified message factory; + * or {@code null} * * @param factoryId the name of the factory to find, which is * a system property @@ -73,22 +73,22 @@ } /** - * Finds the implementation <code>Class</code> object for the given - * factory name, or if that fails, finds the <code>Class</code> object + * Finds the implementation {@code Class} object for the given + * factory name, or if that fails, finds the {@code Class} object * for the given fallback class name. The arguments supplied must be * used in order. If using the first argument is successful, the second * one will not be used. * <P> * This method is package private so that this code can be shared. * - * @return the <code>Class</code> object of the specified message factory; - * may be <code>null</code> + * @return the {@code Class} object of the specified message factory; + * may be {@code null} * * @param factoryId the name of the factory to find, which is * a system property * @param fallbackClassName the implementation class name, which is * to be used only if nothing else - * is found; <code>null</code> to indicate that + * is found; {@code null} to indicate that * there is no fallback class name * @exception SOAPException if there is a SOAP error */ @@ -99,24 +99,24 @@ } /** - * Finds the implementation <code>Class</code> object for the given - * factory name, or if that fails, finds the <code>Class</code> object - * for the given default class name, but only if <code>tryFallback</code> - * is <code>true</code>. The arguments supplied must be used in order + * Finds the implementation {@code Class} object for the given + * factory name, or if that fails, finds the {@code Class} object + * for the given default class name, but only if {@code tryFallback} + * is {@code true}. The arguments supplied must be used in order * If using the first argument is successful, the second one will not * be used. Note the default class name may be needed even if fallback * is not to be attempted, so certain error conditions can be handled. * <P> * This method is package private so that this code can be shared. * - * @return the <code>Class</code> object of the specified message factory; - * may not be <code>null</code> + * @return the {@code Class} object of the specified message factory; + * may not be {@code null} * * @param factoryId the name of the factory to find, which is * a system property * @param defaultClassName the implementation class name, which is * to be used only if nothing else - * is found; <code>null</code> to indicate + * is found; {@code null} to indicate * that there is no default class name * @param tryFallback whether to try the default class as a * fallback
--- a/src/java.xml.ws/share/classes/javax/xml/soap/MessageFactory.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/MessageFactory.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -30,36 +30,36 @@ import java.io.InputStream; /** - * A factory for creating <code>SOAPMessage</code> objects. + * A factory for creating {@code SOAPMessage} objects. * <P> - * A SAAJ client can create a <code>MessageFactory</code> object - * using the method <code>newInstance</code>, as shown in the following + * A SAAJ client can create a {@code MessageFactory} object + * using the method {@code newInstance}, as shown in the following * lines of code. - * <PRE> + * <pre>{@code * MessageFactory mf = MessageFactory.newInstance(); * MessageFactory mf12 = MessageFactory.newInstance(SOAPConstants.SOAP_1_2_PROTOCOL); - * </PRE> + * }</pre> * <P> - * All <code>MessageFactory</code> objects, regardless of how they are - * created, will produce <code>SOAPMessage</code> objects that + * All {@code MessageFactory} objects, regardless of how they are + * created, will produce {@code SOAPMessage} objects that * have the following elements by default: * <UL> - * <LI>A <code>SOAPPart</code> object - * <LI>A <code>SOAPEnvelope</code> object - * <LI>A <code>SOAPBody</code> object - * <LI>A <code>SOAPHeader</code> object + * <LI>A {@code SOAPPart} object + * <LI>A {@code SOAPEnvelope} object + * <LI>A {@code SOAPBody} object + * <LI>A {@code SOAPHeader} object * </UL> * In some cases, specialized MessageFactory objects may be obtained that produce messages - * prepopulated with additional entries in the <code>SOAPHeader</code> object and the - * <code>SOAPBody</code> object. - * The content of a new <code>SOAPMessage</code> object depends on which of the two - * <code>MessageFactory</code> methods is used to create it. + * prepopulated with additional entries in the {@code SOAPHeader} object and the + * {@code SOAPBody} object. + * The content of a new {@code SOAPMessage} object depends on which of the two + * {@code MessageFactory} methods is used to create it. * <UL> - * <LI><code>createMessage()</code> <BR> + * <LI>{@code createMessage()} <BR> * This is the method clients would normally use to create a request message. - * <LI><code>createMessage(MimeHeaders, java.io.InputStream)</code> -- message has - * content from the <code>InputStream</code> object and headers from the - * <code>MimeHeaders</code> object <BR> + * <LI>{@code createMessage(MimeHeaders, java.io.InputStream)} -- message has + * content from the {@code InputStream} object and headers from the + * {@code MimeHeaders} object <BR> * This method can be used internally by a service implementation to * create a message that is a response to a request. * </UL> @@ -75,7 +75,7 @@ = "javax.xml.soap.MessageFactory"; /** - * Creates a new <code>MessageFactory</code> object that is an instance + * Creates a new {@code MessageFactory} object that is an instance * of the default implementation (SOAP 1.1), * * This method uses the following ordered lookup procedure to determine the MessageFactory implementation class to load: @@ -90,11 +90,11 @@ * </UL> * - * @return a new instance of a <code>MessageFactory</code> + * @return a new instance of a {@code MessageFactory} * * @exception SOAPException if there was an error in creating the * default implementation of the - * <code>MessageFactory</code>. + * {@code MessageFactory}. * @see SAAJMetaFactory */ @@ -121,26 +121,26 @@ } /** - * Creates a new <code>MessageFactory</code> object that is an instance + * Creates a new {@code MessageFactory} object that is an instance * of the specified implementation. May be a dynamic message factory, * a SOAP 1.1 message factory, or a SOAP 1.2 message factory. A dynamic * message factory creates messages based on the MIME headers specified - * as arguments to the <code>createMessage</code> method. + * as arguments to the {@code createMessage} method. * * This method uses the SAAJMetaFactory to locate the implementation class * and create the MessageFactory instance. * - * @return a new instance of a <code>MessageFactory</code> + * @return a new instance of a {@code MessageFactory} * * @param protocol a string constant representing the class of the * specified message factory implementation. May be - * either <code>DYNAMIC_SOAP_PROTOCOL</code>, - * <code>DEFAULT_SOAP_PROTOCOL</code> (which is the same - * as) <code>SOAP_1_1_PROTOCOL</code>, or - * <code>SOAP_1_2_PROTOCOL</code>. + * either {@code DYNAMIC_SOAP_PROTOCOL}, + * {@code DEFAULT_SOAP_PROTOCOL} (which is the same + * as) {@code SOAP_1_1_PROTOCOL}, or + * {@code SOAP_1_2_PROTOCOL}. * * @exception SOAPException if there was an error in creating the - * specified implementation of <code>MessageFactory</code>. + * specified implementation of {@code MessageFactory}. * @see SAAJMetaFactory * @since 1.6, SAAJ 1.3 */ @@ -149,52 +149,52 @@ } /** - * Creates a new <code>SOAPMessage</code> object with the default - * <code>SOAPPart</code>, <code>SOAPEnvelope</code>, <code>SOAPBody</code>, - * and <code>SOAPHeader</code> objects. Profile-specific message factories - * can choose to prepopulate the <code>SOAPMessage</code> object with + * Creates a new {@code SOAPMessage} object with the default + * {@code SOAPPart}, {@code SOAPEnvelope}, {@code SOAPBody}, + * and {@code SOAPHeader} objects. Profile-specific message factories + * can choose to prepopulate the {@code SOAPMessage} object with * profile-specific headers. * <P> - * Content can be added to this message's <code>SOAPPart</code> object, and + * Content can be added to this message's {@code SOAPPart} object, and * the message can be sent "as is" when a message containing only a SOAP part - * is sufficient. Otherwise, the <code>SOAPMessage</code> object needs - * to create one or more <code>AttachmentPart</code> objects and + * is sufficient. Otherwise, the {@code SOAPMessage} object needs + * to create one or more {@code AttachmentPart} objects and * add them to itself. Any content that is not in XML format must be - * in an <code>AttachmentPart</code> object. + * in an {@code AttachmentPart} object. * - * @return a new <code>SOAPMessage</code> object + * @return a new {@code SOAPMessage} object * @exception SOAPException if a SOAP error occurs * @exception UnsupportedOperationException if the protocol of this - * <code>MessageFactory</code> instance is <code>DYNAMIC_SOAP_PROTOCOL</code> + * {@code MessageFactory} instance is {@code DYNAMIC_SOAP_PROTOCOL} */ public abstract SOAPMessage createMessage() throws SOAPException; /** - * Internalizes the contents of the given <code>InputStream</code> object into a - * new <code>SOAPMessage</code> object and returns the <code>SOAPMessage</code> + * Internalizes the contents of the given {@code InputStream} object into a + * new {@code SOAPMessage} object and returns the {@code SOAPMessage} * object. * - * @param in the <code>InputStream</code> object that contains the data + * @param in the {@code InputStream} object that contains the data * for a message * @param headers the transport-specific headers passed to the * message in a transport-independent fashion for creation of the * message - * @return a new <code>SOAPMessage</code> object containing the data from - * the given <code>InputStream</code> object + * @return a new {@code SOAPMessage} object containing the data from + * the given {@code InputStream} object * * @exception IOException if there is a problem in reading data from * the input stream * * @exception SOAPException may be thrown if the message is invalid * - * @exception IllegalArgumentException if the <code>MessageFactory</code> + * @exception IllegalArgumentException if the {@code MessageFactory} * requires one or more MIME headers to be present in the - * <code>headers</code> parameter and they are missing. - * <code>MessageFactory</code> implementations for - * <code>SOAP_1_1_PROTOCOL</code> or - * <code>SOAP_1_2_PROTOCOL</code> must not throw - * <code>IllegalArgumentException</code> for this reason. + * {@code headers} parameter and they are missing. + * {@code MessageFactory} implementations for + * {@code SOAP_1_1_PROTOCOL} or + * {@code SOAP_1_2_PROTOCOL} must not throw + * {@code IllegalArgumentException} for this reason. */ public abstract SOAPMessage createMessage(MimeHeaders headers, InputStream in)
--- a/src/java.xml.ws/share/classes/javax/xml/soap/MimeHeader.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/MimeHeader.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ /** * An object that stores a MIME header name and its value. One or more - * <code>MimeHeader</code> objects may be contained in a <code>MimeHeaders</code> + * {@code MimeHeader} objects may be contained in a {@code MimeHeaders} * object. * * @see MimeHeaders @@ -40,11 +40,11 @@ private String value; /** - * Constructs a <code>MimeHeader</code> object initialized with the given + * Constructs a {@code MimeHeader} object initialized with the given * name and value. * - * @param name a <code>String</code> giving the name of the header - * @param value a <code>String</code> giving the value of the header + * @param name a {@code String} giving the name of the header + * @param value a {@code String} giving the value of the header */ public MimeHeader(String name, String value) { this.name = name; @@ -52,18 +52,18 @@ } /** - * Returns the name of this <code>MimeHeader</code> object. + * Returns the name of this {@code MimeHeader} object. * - * @return the name of the header as a <code>String</code> + * @return the name of the header as a {@code String} */ public String getName() { return name; } /** - * Returns the value of this <code>MimeHeader</code> object. + * Returns the value of this {@code MimeHeader} object. * - * @return the value of the header as a <code>String</code> + * @return the value of the header as a {@code String} */ public String getValue() { return value;
--- a/src/java.xml.ws/share/classes/javax/xml/soap/MimeHeaders.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/MimeHeaders.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -29,13 +29,13 @@ import java.util.Vector; /** - * A container for <code>MimeHeader</code> objects, which represent + * A container for {@code MimeHeader} objects, which represent * the MIME headers present in a MIME part of a message. * * <p>This class is used primarily when an application wants to * retrieve specific attachments based on certain MIME headers and * values. This class will most likely be used by implementations of - * <code>AttachmentPart</code> and other MIME dependent parts of the SAAJ + * {@code AttachmentPart} and other MIME dependent parts of the SAAJ * API. * @see SOAPMessage#getAttachments * @see AttachmentPart @@ -45,8 +45,8 @@ private Vector headers; /** - * Constructs a default <code>MimeHeaders</code> object initialized with - * an empty <code>Vector</code> object. + * Constructs a default {@code MimeHeaders} object initialized with + * an empty {@code Vector} object. */ public MimeHeaders() { headers = new Vector(); @@ -54,10 +54,10 @@ /** * Returns all of the values for the specified header as an array of - * <code>String</code> objects. + * {@code String} objects. * * @param name the name of the header for which values will be returned - * @return a <code>String</code> array with all of the values for the + * @return a {@code String} array with all of the values for the * specified header * @see #setHeader */ @@ -86,9 +86,9 @@ * <P> * Note that RFC822 headers can contain only US-ASCII characters. * - * @param name a <code>String</code> with the name of the header for + * @param name a {@code String} with the name of the header for * which to search - * @param value a <code>String</code> with the value that will replace the + * @param value a {@code String} with the value that will replace the * current value of the specified header * * @exception IllegalArgumentException if there was a problem in the @@ -120,14 +120,14 @@ } /** - * Adds a <code>MimeHeader</code> object with the specified name and value - * to this <code>MimeHeaders</code> object's list of headers. + * Adds a {@code MimeHeader} object with the specified name and value + * to this {@code MimeHeaders} object's list of headers. * <P> * Note that RFC822 headers can contain only US-ASCII characters. * - * @param name a <code>String</code> with the name of the header to + * @param name a {@code String} with the name of the header to * be added - * @param value a <code>String</code> with the value of the header to + * @param value a {@code String} with the value of the header to * be added * * @exception IllegalArgumentException if there was a problem in the @@ -152,10 +152,10 @@ } /** - * Remove all <code>MimeHeader</code> objects whose name matches the + * Remove all {@code MimeHeader} objects whose name matches the * given name. * - * @param name a <code>String</code> with the name of the header for + * @param name a {@code String} with the name of the header for * which to search */ public void removeHeader(String name) { @@ -167,7 +167,7 @@ } /** - * Removes all the header entries from this <code>MimeHeaders</code> object. + * Removes all the header entries from this {@code MimeHeaders} object. */ public void removeAllHeaders() { headers.removeAllElements(); @@ -175,10 +175,10 @@ /** - * Returns all the <code>MimeHeader</code>s in this <code>MimeHeaders</code> object. + * Returns all the {@code MimeHeader}s in this {@code MimeHeaders} object. * - * @return an <code>Iterator</code> object over this <code>MimeHeaders</code> - * object's list of <code>MimeHeader</code> objects + * @return an {@code Iterator} object over this {@code MimeHeaders} + * object's list of {@code MimeHeader} objects */ public Iterator getAllHeaders() { return headers.iterator(); @@ -243,12 +243,12 @@ /** - * Returns all the <code>MimeHeader</code> objects whose name matches + * Returns all the {@code MimeHeader} objects whose name matches * a name in the given array of names. * - * @param names an array of <code>String</code> objects with the names + * @param names an array of {@code String} objects with the names * for which to search - * @return an <code>Iterator</code> object over the <code>MimeHeader</code> + * @return an {@code Iterator} object over the {@code MimeHeader} * objects whose name matches one of the names in the given list */ public Iterator getMatchingHeaders(String[] names) { @@ -256,12 +256,12 @@ } /** - * Returns all of the <code>MimeHeader</code> objects whose name does not + * Returns all of the {@code MimeHeader} objects whose name does not * match a name in the given array of names. * - * @param names an array of <code>String</code> objects with the names + * @param names an array of {@code String} objects with the names * for which to search - * @return an <code>Iterator</code> object over the <code>MimeHeader</code> + * @return an {@code Iterator} object over the {@code MimeHeader} * objects whose name does not match one of the names in the given list */ public Iterator getNonMatchingHeaders(String[] names) {
--- a/src/java.xml.ws/share/classes/javax/xml/soap/Name.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/Name.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -55,17 +55,17 @@ * The following line of * code, in which <i>se</i> is a {@code SOAPEnvelope} object, creates a new * {@code Name} object with all three. - * <PRE> + * <pre>{@code * Name name = se.createName("GetLastTradePrice", "WOMBAT", * "http://www.wombat.org/trader"); - * </PRE> + * }</pre> * The following line of code gives an example of how a {@code Name} object * can be used. The variable <i>element</i> is a {@code SOAPElement} object. * This code creates a new {@code SOAPElement} object with the given name and * adds it to <i>element</i>. - * <PRE> + * <pre>{@code * element.addChildElement(name); - * </PRE> + * }</pre> * <P> * The {@code Name} interface may be deprecated in a future release of SAAJ * in favor of {@code javax.xml.namespace.QName}
--- a/src/java.xml.ws/share/classes/javax/xml/soap/Node.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/Node.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -35,19 +35,19 @@ */ public interface Node extends org.w3c.dom.Node { /** - * Returns the value of this node if this is a <code>Text</code> node or the + * Returns the value of this node if this is a {@code Text} node or the * value of the immediate child of this node otherwise. - * If there is an immediate child of this <code>Node</code> that it is a - * <code>Text</code> node then it's value will be returned. If there is - * more than one <code>Text</code> node then the value of the first - * <code>Text</code> Node will be returned. - * Otherwise <code>null</code> is returned. + * If there is an immediate child of this {@code Node} that it is a + * {@code Text} node then it's value will be returned. If there is + * more than one {@code Text} node then the value of the first + * {@code Text} Node will be returned. + * Otherwise {@code null} is returned. * - * @return a <code>String</code> with the text of this node if this is a - * <code>Text</code> node or the text contained by the first - * immediate child of this <code>Node</code> object that is a - * <code>Text</code> object if such a child exists; - * <code>null</code> otherwise. + * @return a {@code String} with the text of this node if this is a + * {@code Text} node or the text contained by the first + * immediate child of this {@code Node} object that is a + * {@code Text} object if such a child exists; + * {@code null} otherwise. */ public String getValue(); @@ -55,24 +55,24 @@ * If this is a Text node then this method will set its value, * otherwise it sets the value of the immediate (Text) child of this node. * The value of the immediate child of this node can be set only if, there is - * one child node and that node is a <code>Text</code> node, or if - * there are no children in which case a child <code>Text</code> node will be + * one child node and that node is a {@code Text} node, or if + * there are no children in which case a child {@code Text} node will be * created. * - * @exception IllegalStateException if the node is not a <code>Text</code> + * @exception IllegalStateException if the node is not a {@code Text} * node and either has more than one child node or has a child - * node that is not a <code>Text</code> node. + * node that is not a {@code Text} node. * * @since 1.6, SAAJ 1.2 */ public void setValue(String value); /** - * Sets the parent of this <code>Node</code> object to the given - * <code>SOAPElement</code> object. + * Sets the parent of this {@code Node} object to the given + * {@code SOAPElement} object. * - * @param parent the <code>SOAPElement</code> object to be set as - * the parent of this <code>Node</code> object + * @param parent the {@code SOAPElement} object to be set as + * the parent of this {@code Node} object * * @exception SOAPException if there is a problem in setting the * parent to the given element @@ -81,13 +81,13 @@ public void setParentElement(SOAPElement parent) throws SOAPException; /** - * Returns the parent element of this <code>Node</code> object. - * This method can throw an <code>UnsupportedOperationException</code> + * Returns the parent element of this {@code Node} object. + * This method can throw an {@code UnsupportedOperationException} * if the tree is not kept in memory. * - * @return the <code>SOAPElement</code> object that is the parent of - * this <code>Node</code> object or <code>null</code> if this - * <code>Node</code> object is root + * @return the {@code SOAPElement} object that is the parent of + * this {@code Node} object or {@code null} if this + * {@code Node} object is root * * @exception UnsupportedOperationException if the whole tree is not * kept in memory @@ -96,18 +96,18 @@ public SOAPElement getParentElement(); /** - * Removes this <code>Node</code> object from the tree. + * Removes this {@code Node} object from the tree. */ public void detachNode(); /** - * Notifies the implementation that this <code>Node</code> + * Notifies the implementation that this {@code Node} * object is no longer being used by the application and that the * implementation is free to reuse this object for nodes that may * be created later. * <P> - * Calling the method <code>recycleNode</code> implies that the method - * <code>detachNode</code> has been called previously. + * Calling the method {@code recycleNode} implies that the method + * {@code detachNode} has been called previously. */ public void recycleNode();
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SAAJMetaFactory.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SAAJMetaFactory.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,9 +27,9 @@ /** * The access point for the implementation classes of the factories defined in the -* SAAJ API. All of the <code>newInstance</code> methods defined on factories in +* SAAJ API. All of the {@code newInstance} methods defined on factories in * SAAJ 1.3 defer to instances of this class to do the actual object creation. -* The implementations of <code>newInstance()</code> methods (in SOAPFactory and MessageFactory) +* The implementations of {@code newInstance()} methods (in SOAPFactory and MessageFactory) * that existed in SAAJ 1.2 have been updated to also delegate to the SAAJMetaFactory when the SAAJ 1.2 * defined lookup fails to locate the Factory implementation class name. * @@ -48,10 +48,10 @@ "com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl"; /** - * Creates a new instance of a concrete <code>SAAJMetaFactory</code> object. + * Creates a new instance of a concrete {@code SAAJMetaFactory} object. * The SAAJMetaFactory is an SPI, it pulls the creation of the other factories together into a * single place. Changing out the SAAJMetaFactory has the effect of changing out the entire SAAJ - * implementation. Service providers provide the name of their <code>SAAJMetaFactory</code> + * implementation. Service providers provide the name of their {@code SAAJMetaFactory} * implementation. * * This method uses the following ordered lookup procedure to determine the SAAJMetaFactory implementation class to load: @@ -65,8 +65,8 @@ * <LI> Default to com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl. * </UL> * - * @return a concrete <code>SAAJMetaFactory</code> object - * @exception SOAPException if there is an error in creating the <code>SAAJMetaFactory</code> + * @return a concrete {@code SAAJMetaFactory} object + * @exception SOAPException if there is an error in creating the {@code SAAJMetaFactory} */ static SAAJMetaFactory getInstance() throws SOAPException { try { @@ -84,10 +84,10 @@ protected SAAJMetaFactory() { } /** - * Creates a <code>MessageFactory</code> object for - * the given <code>String</code> protocol. + * Creates a {@code MessageFactory} object for + * the given {@code String} protocol. * - * @param protocol a <code>String</code> indicating the protocol + * @param protocol a {@code String} indicating the protocol * @exception SOAPException if there is an error in creating the * MessageFactory * @see SOAPConstants#SOAP_1_1_PROTOCOL @@ -98,10 +98,10 @@ throws SOAPException; /** - * Creates a <code>SOAPFactory</code> object for - * the given <code>String</code> protocol. + * Creates a {@code SOAPFactory} object for + * the given {@code String} protocol. * - * @param protocol a <code>String</code> indicating the protocol + * @param protocol a {@code String} indicating the protocol * @exception SOAPException if there is an error in creating the * SOAPFactory * @see SOAPConstants#SOAP_1_1_PROTOCOL
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SAAJResult.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SAAJResult.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -40,18 +40,18 @@ public class SAAJResult extends DOMResult { /** - * Creates a <code>SAAJResult</code> that will present results in the form + * Creates a {@code SAAJResult} that will present results in the form * of a SAAJ tree that supports the default (SOAP 1.1) protocol. * <p> - * This kind of <code>SAAJResult</code> is meant for use in situations where the + * This kind of {@code SAAJResult} is meant for use in situations where the * results will be used as a parameter to a method that takes a parameter - * whose type, such as <code>SOAPElement</code>, is drawn from the SAAJ + * whose type, such as {@code SOAPElement}, is drawn from the SAAJ * API. When used in a transformation, the results are populated into the - * <code>SOAPPart</code> of a <code>SOAPMessage</code> that is created internally. - * The <code>SOAPPart</code> returned by {@link DOMResult#getNode()} + * {@code SOAPPart} of a {@code SOAPMessage} that is created internally. + * The {@code SOAPPart} returned by {@link DOMResult#getNode()} * is not guaranteed to be well-formed. * - * @throws SOAPException if there is a problem creating a <code>SOAPMessage</code> + * @throws SOAPException if there is a problem creating a {@code SOAPMessage} * * @since 1.6, SAAJ 1.3 */ @@ -60,23 +60,23 @@ } /** - * Creates a <code>SAAJResult</code> that will present results in the form + * Creates a {@code SAAJResult} that will present results in the form * of a SAAJ tree that supports the specified protocol. The - * <code>DYNAMIC_SOAP_PROTOCOL</code> is ambiguous in this context and will - * cause this constructor to throw an <code>UnsupportedOperationException</code>. + * {@code DYNAMIC_SOAP_PROTOCOL} is ambiguous in this context and will + * cause this constructor to throw an {@code UnsupportedOperationException}. * <p> - * This kind of <code>SAAJResult</code> is meant for use in situations where the + * This kind of {@code SAAJResult} is meant for use in situations where the * results will be used as a parameter to a method that takes a parameter - * whose type, such as <code>SOAPElement</code>, is drawn from the SAAJ + * whose type, such as {@code SOAPElement}, is drawn from the SAAJ * API. When used in a transformation the results are populated into the - * <code>SOAPPart</code> of a <code>SOAPMessage</code> that is created - * internally. The <code>SOAPPart</code> returned by {@link DOMResult#getNode()} + * {@code SOAPPart} of a {@code SOAPMessage} that is created + * internally. The {@code SOAPPart} returned by {@link DOMResult#getNode()} * is not guaranteed to be well-formed. * * @param protocol - the name of the SOAP protocol that the resulting SAAJ * tree should support * - * @throws SOAPException if a <code>SOAPMessage</code> supporting the + * @throws SOAPException if a {@code SOAPMessage} supporting the * specified protocol cannot be created * * @since 1.6, SAAJ 1.3 @@ -86,16 +86,16 @@ } /** - * Creates a <code>SAAJResult</code> that will write the results into the - * <code>SOAPPart</code> of the supplied <code>SOAPMessage</code>. + * Creates a {@code SAAJResult} that will write the results into the + * {@code SOAPPart} of the supplied {@code SOAPMessage}. * In the normal case these results will be written using DOM APIs and, - * as a result, the finished <code>SOAPPart</code> will not be guaranteed + * as a result, the finished {@code SOAPPart} will not be guaranteed * to be well-formed unless the data used to create it is also well formed. - * When used in a transformation the validity of the <code>SOAPMessage</code> + * When used in a transformation the validity of the {@code SOAPMessage} * after the transformation can be guaranteed only by means outside SAAJ * specification. * - * @param message - the message whose <code>SOAPPart</code> will be + * @param message - the message whose {@code SOAPPart} will be * populated as a result of some transformation or * marshalling operation * @@ -106,11 +106,11 @@ } /** - * Creates a <code>SAAJResult</code> that will write the results as a - * child node of the <code>SOAPElement</code> specified. In the normal + * Creates a {@code SAAJResult} that will write the results as a + * child node of the {@code SOAPElement} specified. In the normal * case these results will be written using DOM APIs and as a result may * invalidate the structure of the SAAJ tree. This kind of - * <code>SAAJResult</code> should only be used when the validity of the + * {@code SAAJResult} should only be used when the validity of the * incoming data can be guaranteed by means outside of the SAAJ * specification. *
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBody.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBody.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -258,7 +258,7 @@ public SOAPBodyElement addBodyElement(QName qname) throws SOAPException; /** - * Adds the root node of the DOM <code>{@link org.w3c.dom.Document}</code> + * Adds the root node of the DOM {@link org.w3c.dom.Document} * to this {@code SOAPBody} object. * <p> * Calling this method invalidates the {@code document} parameter. @@ -279,12 +279,12 @@ throws SOAPException; /** - * Creates a new DOM <code>{@link org.w3c.dom.Document}</code> and sets + * Creates a new DOM {@link org.w3c.dom.Document} and sets * 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 <code>{@link org.w3c.dom.Document}</code> representation + * @return the {@link org.w3c.dom.Document} representation * of the {@code SOAPBody} content. * * @exception SOAPException
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBodyElement.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPBodyElement.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,18 +26,18 @@ package javax.xml.soap; /** - * A <code>SOAPBodyElement</code> object represents the contents in - * a <code>SOAPBody</code> object. The <code>SOAPFault</code> interface - * is a <code>SOAPBodyElement</code> object that has been defined. + * A {@code SOAPBodyElement} object represents the contents in + * a {@code SOAPBody} object. The {@code SOAPFault} interface + * is a {@code SOAPBodyElement} object that has been defined. * <P> - * A new <code>SOAPBodyElement</code> object can be created and added - * to a <code>SOAPBody</code> object with the <code>SOAPBody</code> - * method <code>addBodyElement</code>. In the following line of code, - * <code>sb</code> is a <code>SOAPBody</code> object, and - * <code>myName</code> is a <code>Name</code> object. - * <PRE> + * A new {@code SOAPBodyElement} object can be created and added + * to a {@code SOAPBody} object with the {@code SOAPBody} + * method {@code addBodyElement}. In the following line of code, + * {@code sb} is a {@code SOAPBody} object, and + * {@code myName} is a {@code Name} object. + * <pre>{@code * SOAPBodyElement sbe = sb.addBodyElement(myName); - * </PRE> + * }</pre> * * @since 1.6 */
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnection.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnection.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,18 +32,18 @@ * <p> * The SOAPConnection class is optional. Some implementations may * not implement this interface in which case the call to - * <code>SOAPConnectionFactory.newInstance()</code> (see below) will - * throw an <code>UnsupportedOperationException</code>. + * {@code SOAPConnectionFactory.newInstance()} (see below) will + * throw an {@code UnsupportedOperationException}. * <p> - * A client can obtain a <code>SOAPConnection</code> object using a + * A client can obtain a {@code SOAPConnection} object using a * {@link SOAPConnectionFactory} object as in the following example: - * <PRE> + * <pre>{@code * SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance(); * SOAPConnection con = factory.createConnection(); - * </PRE> - * A <code>SOAPConnection</code> object can be used to send messages + * }</pre> + * A {@code SOAPConnection} object can be used to send messages * directly to a URL following the request/response paradigm. That is, - * messages are sent using the method <code>call</code>, which sends the + * messages are sent using the method {@code call}, which sends the * message and then waits until it gets a reply. * * @since 1.6 @@ -54,15 +54,15 @@ * Sends the given message to the specified endpoint and blocks until * it has returned the response. * - * @param request the <code>SOAPMessage</code> object to be sent - * @param to an <code>Object</code> that identifies + * @param request the {@code SOAPMessage} object to be sent + * @param to an {@code Object} that identifies * where the message should be sent. It is required to * support Objects of type - * <code>java.lang.String</code>, - * <code>java.net.URL</code>, and when JAXM is present - * <code>javax.xml.messaging.URLEndpoint</code> + * {@code java.lang.String}, + * {@code java.net.URL}, and when JAXM is present + * {@code javax.xml.messaging.URLEndpoint} * - * @return the <code>SOAPMessage</code> object that is the response to the + * @return the {@code SOAPMessage} object that is the response to the * message that was sent * @throws SOAPException if there is a SOAP error */ @@ -72,12 +72,12 @@ /** * Gets a message from a specific endpoint and blocks until it receives, * - * @param to an <code>Object</code> that identifies where + * @param to an {@code Object} that identifies where * the request should be sent. Objects of type - * <code>java.lang.String</code> and - * <code>java.net.URL</code> must be supported. + * {@code java.lang.String} and + * {@code java.net.URL} must be supported. * - * @return the <code>SOAPMessage</code> object that is the response to the + * @return the {@code SOAPMessage} object that is the response to the * get message request * @throws SOAPException if there is a SOAP error * @since 1.6, SAAJ 1.3 @@ -88,7 +88,7 @@ } /** - * Closes this <code>SOAPConnection</code> object. + * Closes this {@code SOAPConnection} object. * * @throws SOAPException if there is a SOAP error */
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnectionFactory.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnectionFactory.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,38 +26,38 @@ package javax.xml.soap; /** - * A factory for creating <code>SOAPConnection</code> objects. Implementation of this class - * is optional. If <code>SOAPConnectionFactory.newInstance()</code> throws an + * A factory for creating {@code SOAPConnection} objects. Implementation of this class + * is optional. If {@code SOAPConnectionFactory.newInstance()} throws an * UnsupportedOperationException then the implementation does not support the * SAAJ communication infrastructure. Otherwise {@link SOAPConnection} objects - * can be created by calling <code>createConnection()</code> on the newly - * created <code>SOAPConnectionFactory</code> object. + * can be created by calling {@code createConnection()} on the newly + * created {@code SOAPConnectionFactory} object. * * @since 1.6 */ public abstract class SOAPConnectionFactory { /** - * A constant representing the default value for a <code>SOAPConnection</code> + * A constant representing the default value for a {@code SOAPConnection} * object. The default is the point-to-point SOAP connection. */ static final String DEFAULT_SOAP_CONNECTION_FACTORY = "com.sun.xml.internal.messaging.saaj.client.p2p.HttpSOAPConnectionFactory"; /** - * A constant representing the <code>SOAPConnection</code> class. + * A constant representing the {@code SOAPConnection} class. */ static private final String SF_PROPERTY = "javax.xml.soap.SOAPConnectionFactory"; /** * Creates an instance of the default - * <code>SOAPConnectionFactory</code> object. + * {@code SOAPConnectionFactory} object. * * @return a new instance of a default - * <code>SOAPConnectionFactory</code> object + * {@code SOAPConnectionFactory} object * * @exception SOAPException if there was an error creating the - * <code>SOAPConnectionFactory</code> + * {@code SOAPConnectionFactory} * * @exception UnsupportedOperationException if newInstance is not * supported. @@ -76,12 +76,12 @@ } /** - * Create a new <code>SOAPConnection</code>. + * Create a new {@code SOAPConnection}. * - * @return the new <code>SOAPConnection</code> object. + * @return the new {@code SOAPConnection} object. * * @exception SOAPException if there was an exception creating the - * <code>SOAPConnection</code> object. + * {@code SOAPConnection} object. */ public abstract SOAPConnection createConnection() throws SOAPException;
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConstants.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConstants.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,30 +34,30 @@ */ public interface SOAPConstants { /** - * Used to create <code>MessageFactory</code> instances that create - * <code>SOAPMessages</code> whose concrete type is based on the - * <code>Content-Type</code> MIME header passed to the - * <code>createMessage</code> method. If no <code>Content-Type</code> - * header is passed then the <code>createMessage</code> may throw an - * <code>IllegalArgumentException</code> or, in the case of the no - * argument version of <code>createMessage</code>, an - * <code>UnsupportedOperationException</code>. + * Used to create {@code MessageFactory} instances that create + * {@code SOAPMessages} whose concrete type is based on the + * {@code Content-Type} MIME header passed to the + * {@code createMessage} method. If no {@code Content-Type} + * header is passed then the {@code createMessage} may throw an + * {@code IllegalArgumentException} or, in the case of the no + * argument version of {@code createMessage}, an + * {@code UnsupportedOperationException}. * * @since 1.6, SAAJ 1.3 */ public static final String DYNAMIC_SOAP_PROTOCOL = "Dynamic Protocol"; /** - * Used to create <code>MessageFactory</code> instances that create - * <code>SOAPMessages</code> whose behavior supports the SOAP 1.1 specification. + * Used to create {@code MessageFactory} instances that create + * {@code SOAPMessages} whose behavior supports the SOAP 1.1 specification. * * @since 1.6, SAAJ 1.3 */ public static final String SOAP_1_1_PROTOCOL = "SOAP 1.1 Protocol"; /** - * Used to create <code>MessageFactory</code> instances that create - * <code>SOAPMessages</code> whose behavior supports the SOAP 1.2 + * Used to create {@code MessageFactory} instances that create + * {@code SOAPMessages} whose behavior supports the SOAP 1.2 * specification * * @since 1.6, SAAJ 1.3 @@ -93,9 +93,9 @@ /** * The namespace identifier for the SOAP 1.1 encoding. - * An attribute named <code>encodingStyle</code> in the - * <code>URI_NS_SOAP_ENVELOPE</code> namespace and set to the value - * <code>URI_NS_SOAP_ENCODING</code> can be added to an element to indicate + * An attribute named {@code encodingStyle} in the + * {@code URI_NS_SOAP_ENVELOPE} namespace and set to the value + * {@code URI_NS_SOAP_ENCODING} can be added to an element to indicate * that it is encoded using the rules in section 5 of the SOAP 1.1 * specification. */ @@ -110,14 +110,14 @@ URI_NS_SOAP_1_2_ENCODING = "http://www.w3.org/2003/05/soap-encoding"; /** - * The media type of the <code>Content-Type</code> MIME header in SOAP 1.1. + * The media type of the {@code Content-Type} MIME header in SOAP 1.1. * @since 1.6, SAAJ 1.3 */ public static final String SOAP_1_1_CONTENT_TYPE = "text/xml"; /** - * The media type of the <code>Content-Type</code> MIME header in SOAP 1.2. + * The media type of the {@code Content-Type} MIME header in SOAP 1.2. * @since 1.6, SAAJ 1.3 */ public static final String
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElement.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElement.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -38,8 +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 <a HREF="package-summary.html#package_description">javax.xml.soap</a>} - * for details. + * {@link javax.xml.soap} for details. * * @since 1.6 */ @@ -345,7 +344,7 @@ * 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 - * <code>{@link #getNamespaceURI(String)}</code> if it were given + * {@link #getNamespaceURI(String)} if it were given * {@code prefix} as it's parameter. * * @exception SOAPException if the {@code QName} cannot be created. @@ -439,7 +438,7 @@ * have been obtained through DOM APIs as invalid and either discard them or * refresh them with the values returned by this {@code Iterator}. This * behavior can be avoided by calling the equivalent DOM APIs. See - * {@link <a HREF="package-summary.html#package_description">javax.xml.soap</a>} + * {@link javax.xml.soap} * for more details. * * @return an iterator with the content of this {@code SOAPElement} @@ -461,7 +460,7 @@ * have been obtained through DOM APIs as invalid and either discard them or * refresh them with the values returned by this {@code Iterator}. This * behavior can be avoided by calling the equivalent DOM APIs. See - * {@link <a HREF="package-summary.html#package_description">javax.xml.soap</a>} + * {@link javax.xml.soap} * for more details. * * @param name a {@code Name} object with the name of the child @@ -488,7 +487,7 @@ * have been obtained through DOM APIs as invalid and either discard them or * refresh them with the values returned by this {@code Iterator}. This * behavior can be avoided by calling the equivalent DOM APIs. See - * {@link <a HREF="package-summary.html#package_description">javax.xml.soap</a>} + * {@link javax.xml.soap} * for more details. * * @param qname a {@code QName} object with the qname of the child
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElementFactory.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPElementFactory.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,16 +26,16 @@ package javax.xml.soap; /** - * <code>SOAPElementFactory</code> is a factory for XML fragments that + * {@code SOAPElementFactory} is a factory for XML fragments that * will eventually end up in the SOAP part. These fragments - * can be inserted as children of the <code>SOAPHeader</code> or - * <code>SOAPBody</code> or <code>SOAPEnvelope</code>. + * can be inserted as children of the {@code SOAPHeader} or + * {@code SOAPBody} or {@code SOAPEnvelope}. * * <p>Elements created using this factory do not have the properties * of an element that lives inside a SOAP header document. These * elements are copied into the XML document tree when they are * inserted. - * @deprecated - Use <code>javax.xml.soap.SOAPFactory</code> for creating SOAPElements. + * @deprecated - Use {@code javax.xml.soap.SOAPFactory} for creating SOAPElements. * @see javax.xml.soap.SOAPFactory * @since 1.6 */ @@ -48,17 +48,17 @@ } /** - * Create a <code>SOAPElement</code> object initialized with the - * given <code>Name</code> object. + * Create a {@code SOAPElement} object initialized with the + * given {@code Name} object. * - * @param name a <code>Name</code> object with the XML name for + * @param name a {@code Name} object with the XML name for * the new element * - * @return the new <code>SOAPElement</code> object that was + * @return the new {@code SOAPElement} object that was * created * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) @@ -72,17 +72,17 @@ } /** - * Create a <code>SOAPElement</code> object initialized with the + * Create a {@code SOAPElement} object initialized with the * given local name. * - * @param localName a <code>String</code> giving the local name for + * @param localName a {@code String} giving the local name for * the new element * - * @return the new <code>SOAPElement</code> object that was + * @return the new {@code SOAPElement} object that was * created * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(String localName) instead @@ -94,17 +94,17 @@ } /** - * Create a new <code>SOAPElement</code> object with the given + * Create a new {@code SOAPElement} object with the given * local name, prefix and uri. * - * @param localName a <code>String</code> giving the local name + * @param localName a {@code String} giving the local name * for the new element - * @param prefix the prefix for this <code>SOAPElement</code> - * @param uri a <code>String</code> giving the URI of the + * @param prefix the prefix for this {@code SOAPElement} + * @param uri a {@code String} giving the URI of the * namespace to which the new element belongs * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(String localName, @@ -120,12 +120,12 @@ } /** - * Creates a new instance of <code>SOAPElementFactory</code>. + * Creates a new instance of {@code SOAPElementFactory}. * - * @return a new instance of a <code>SOAPElementFactory</code> + * @return a new instance of a {@code SOAPElementFactory} * * @exception SOAPException if there was an error creating the - * default <code>SOAPElementFactory</code> + * default {@code SOAPElementFactory} */ public static SOAPElementFactory newInstance() throws SOAPException { try {
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPEnvelope.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPEnvelope.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,87 +28,87 @@ /** * The container for the SOAPHeader and SOAPBody portions of a - * <code>SOAPPart</code> object. By default, a <code>SOAPMessage</code> - * object is created with a <code>SOAPPart</code> object that has a - * <code>SOAPEnvelope</code> object. The <code>SOAPEnvelope</code> object - * by default has an empty <code>SOAPBody</code> object and an empty - * <code>SOAPHeader</code> object. The <code>SOAPBody</code> object is - * required, and the <code>SOAPHeader</code> object, though + * {@code SOAPPart} object. By default, a {@code SOAPMessage} + * object is created with a {@code SOAPPart} object that has a + * {@code SOAPEnvelope} object. The {@code SOAPEnvelope} object + * by default has an empty {@code SOAPBody} object and an empty + * {@code SOAPHeader} object. The {@code SOAPBody} object is + * required, and the {@code SOAPHeader} object, though * optional, is used in the majority of cases. If the - * <code>SOAPHeader</code> object is not needed, it can be deleted, + * {@code SOAPHeader} object is not needed, it can be deleted, * which is shown later. * <P> - * A client can access the <code>SOAPHeader</code> and <code>SOAPBody</code> - * objects by calling the methods <code>SOAPEnvelope.getHeader</code> and - * <code>SOAPEnvelope.getBody</code>. The + * A client can access the {@code SOAPHeader} and {@code SOAPBody} + * objects by calling the methods {@code SOAPEnvelope.getHeader} and + * {@code SOAPEnvelope.getBody}. The * following lines of code use these two methods after starting with - * the <code>SOAPMessage</code> - * object <i>message</i> to get the <code>SOAPPart</code> object <i>sp</i>, - * which is then used to get the <code>SOAPEnvelope</code> object <i>se</i>. + * the {@code SOAPMessage} + * object <i>message</i> to get the {@code SOAPPart} object <i>sp</i>, + * which is then used to get the {@code SOAPEnvelope} object <i>se</i>. * - * <PRE> + * <pre>{@code * SOAPPart sp = message.getSOAPPart(); * SOAPEnvelope se = sp.getEnvelope(); * SOAPHeader sh = se.getHeader(); * SOAPBody sb = se.getBody(); - * </PRE> + * }</pre> * <P> - * It is possible to change the body or header of a <code>SOAPEnvelope</code> + * It is possible to change the body or header of a {@code SOAPEnvelope} * object by retrieving the current one, deleting it, and then adding - * a new body or header. The <code>javax.xml.soap.Node</code> method - * <code>deleteNode</code> deletes the XML element (node) on which it is + * a new body or header. The {@code javax.xml.soap.Node} method + * {@code deleteNode} deletes the XML element (node) on which it is * called. For example, the following line of code deletes the - * <code>SOAPBody</code> object that is retrieved by the method <code>getBody</code>. - * <PRE> + * {@code SOAPBody} object that is retrieved by the method {@code getBody}. + * <pre>{@code * se.getBody().detachNode(); - * </PRE> - * To create a <code>SOAPHeader</code> object to replace the one that was removed, + * }</pre> + * To create a {@code SOAPHeader} object to replace the one that was removed, * a client uses - * the method <code>SOAPEnvelope.addHeader</code>, which creates a new header and - * adds it to the <code>SOAPEnvelope</code> object. Similarly, the method - * <code>addBody</code> creates a new <code>SOAPBody</code> object and adds - * it to the <code>SOAPEnvelope</code> object. The following code fragment + * the method {@code SOAPEnvelope.addHeader}, which creates a new header and + * adds it to the {@code SOAPEnvelope} object. Similarly, the method + * {@code addBody} creates a new {@code SOAPBody} object and adds + * it to the {@code SOAPEnvelope} object. The following code fragment * retrieves the current header, removes it, and adds a new one. Then * it retrieves the current body, removes it, and adds a new one. * - * <PRE> + * <pre>{@code * SOAPPart sp = message.getSOAPPart(); * SOAPEnvelope se = sp.getEnvelope(); * se.getHeader().detachNode(); * SOAPHeader sh = se.addHeader(); * se.getBody().detachNode(); * SOAPBody sb = se.addBody(); - * </PRE> - * It is an error to add a <code>SOAPBody</code> or <code>SOAPHeader</code> + * }</pre> + * It is an error to add a {@code SOAPBody} or {@code SOAPHeader} * object if one already exists. * <P> - * The <code>SOAPEnvelope</code> interface provides three methods for creating - * <code>Name</code> objects. One method creates <code>Name</code> objects with + * The {@code SOAPEnvelope} interface provides three methods for creating + * {@code Name} objects. One method creates {@code Name} objects with * a local name, a namespace prefix, and a namesapce URI. The second method creates - * <code>Name</code> objects with a local name and a namespace prefix, and the third - * creates <code>Name</code> objects with just a local name. The following line of - * code, in which <i>se</i> is a <code>SOAPEnvelope</code> object, creates a new - * <code>Name</code> object with all three. - * <PRE> + * {@code Name} objects with a local name and a namespace prefix, and the third + * creates {@code Name} objects with just a local name. The following line of + * code, in which <i>se</i> is a {@code SOAPEnvelope} object, creates a new + * {@code Name} object with all three. + * <pre>{@code * Name name = se.createName("GetLastTradePrice", "WOMBAT", * "http://www.wombat.org/trader"); - * </PRE> + * }</pre> * * @since 1.6 */ public interface SOAPEnvelope extends SOAPElement { /** - * Creates a new <code>Name</code> object initialized with the + * Creates a new {@code Name} object initialized with the * given local name, namespace prefix, and namespace URI. * <P> - * This factory method creates <code>Name</code> objects for use in + * This factory method creates {@code Name} objects for use in * the SOAP/XML document. * - * @param localName a <code>String</code> giving the local name - * @param prefix a <code>String</code> giving the prefix of the namespace - * @param uri a <code>String</code> giving the URI of the namespace - * @return a <code>Name</code> object initialized with the given + * @param localName a {@code String} giving the local name + * @param prefix a {@code String} giving the prefix of the namespace + * @param uri a {@code String} giving the URI of the namespace + * @return a {@code Name} object initialized with the given * local name, namespace prefix, and namespace URI * @throws SOAPException if there is a SOAP error */ @@ -117,14 +117,14 @@ throws SOAPException; /** - * Creates a new <code>Name</code> object initialized with the + * Creates a new {@code Name} object initialized with the * given local name. * <P> - * This factory method creates <code>Name</code> objects for use in + * This factory method creates {@code Name} objects for use in * the SOAP/XML document. * - * @param localName a <code>String</code> giving the local name - * @return a <code>Name</code> object initialized with the given + * @param localName a {@code String} giving the local name + * @return a {@code Name} object initialized with the given * local name * @throws SOAPException if there is a SOAP error */ @@ -132,71 +132,71 @@ throws SOAPException; /** - * Returns the <code>SOAPHeader</code> object for - * this <code>SOAPEnvelope</code> object. + * Returns the {@code SOAPHeader} object for + * this {@code SOAPEnvelope} object. * <P> - * A new <code>SOAPMessage</code> object is by default created with a - * <code>SOAPEnvelope</code> object that contains an empty - * <code>SOAPHeader</code> object. As a result, the method - * <code>getHeader</code> will always return a <code>SOAPHeader</code> + * A new {@code SOAPMessage} object is by default created with a + * {@code SOAPEnvelope} object that contains an empty + * {@code SOAPHeader} object. As a result, the method + * {@code getHeader} will always return a {@code SOAPHeader} * object unless the header has been removed and a new one has not * been added. * - * @return the <code>SOAPHeader</code> object or <code>null</code> if + * @return the {@code SOAPHeader} object or {@code null} if * there is none * @exception SOAPException if there is a problem obtaining the - * <code>SOAPHeader</code> object + * {@code SOAPHeader} object */ public SOAPHeader getHeader() throws SOAPException; /** - * Returns the <code>SOAPBody</code> object associated with this - * <code>SOAPEnvelope</code> object. + * Returns the {@code SOAPBody} object associated with this + * {@code SOAPEnvelope} object. * <P> - * A new <code>SOAPMessage</code> object is by default created with a - * <code>SOAPEnvelope</code> object that contains an empty - * <code>SOAPBody</code> object. As a result, the method - * <code>getBody</code> will always return a <code>SOAPBody</code> + * A new {@code SOAPMessage} object is by default created with a + * {@code SOAPEnvelope} object that contains an empty + * {@code SOAPBody} object. As a result, the method + * {@code getBody} will always return a {@code SOAPBody} * object unless the body has been removed and a new one has not * been added. * - * @return the <code>SOAPBody</code> object for this - * <code>SOAPEnvelope</code> object or <code>null</code> + * @return the {@code SOAPBody} object for this + * {@code SOAPEnvelope} object or {@code null} * if there is none * @exception SOAPException if there is a problem obtaining the - * <code>SOAPBody</code> object + * {@code SOAPBody} object */ public SOAPBody getBody() throws SOAPException; /** - * Creates a <code>SOAPHeader</code> object and sets it as the - * <code>SOAPHeader</code> object for this <code>SOAPEnvelope</code> + * Creates a {@code SOAPHeader} object and sets it as the + * {@code SOAPHeader} object for this {@code SOAPEnvelope} * object. * <P> * It is illegal to add a header when the envelope already * contains a header. Therefore, this method should be called * only after the existing header has been removed. * - * @return the new <code>SOAPHeader</code> object + * @return the new {@code SOAPHeader} object * * @exception SOAPException if this - * <code>SOAPEnvelope</code> object already contains a - * valid <code>SOAPHeader</code> object + * {@code SOAPEnvelope} object already contains a + * valid {@code SOAPHeader} object */ public SOAPHeader addHeader() throws SOAPException; /** - * Creates a <code>SOAPBody</code> object and sets it as the - * <code>SOAPBody</code> object for this <code>SOAPEnvelope</code> + * Creates a {@code SOAPBody} object and sets it as the + * {@code SOAPBody} object for this {@code SOAPEnvelope} * object. * <P> * It is illegal to add a body when the envelope already * contains a body. Therefore, this method should be called * only after the existing body has been removed. * - * @return the new <code>SOAPBody</code> object + * @return the new {@code SOAPBody} object * * @exception SOAPException if this - * <code>SOAPEnvelope</code> object already contains a - * valid <code>SOAPBody</code> object + * {@code SOAPEnvelope} object already contains a + * valid {@code SOAPBody} object */ public SOAPBody addBody() throws SOAPException; }
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPException.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPException.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,16 +27,16 @@ /** * An exception that signals that a SOAP exception has occurred. A - * <code>SOAPException</code> object may contain a <code>String</code> + * {@code SOAPException} object may contain a {@code String} * that gives the reason for the exception, an embedded - * <code>Throwable</code> object, or both. This class provides methods + * {@code Throwable} object, or both. This class provides methods * for retrieving reason messages and for retrieving the embedded - * <code>Throwable</code> object. + * {@code Throwable} object. * - * <P> Typical reasons for throwing a <code>SOAPException</code> + * <P> Typical reasons for throwing a {@code SOAPException} * object are problems such as difficulty setting a header, not being * able to send a message, and not being able to get a connection with - * the provider. Reasons for embedding a <code>Throwable</code> + * the provider. Reasons for embedding a {@code Throwable} * object include problems such as input/output errors or a parsing * problem, such as an error in parsing a header. * @@ -46,8 +46,8 @@ private Throwable cause; /** - * Constructs a <code>SOAPException</code> object with no - * reason or embedded <code>Throwable</code> object. + * Constructs a {@code SOAPException} object with no + * reason or embedded {@code Throwable} object. */ public SOAPException() { super(); @@ -55,8 +55,8 @@ } /** - * Constructs a <code>SOAPException</code> object with the given - * <code>String</code> as the reason for the exception being thrown. + * Constructs a {@code SOAPException} object with the given + * {@code String} as the reason for the exception being thrown. * * @param reason a description of what caused the exception */ @@ -66,14 +66,14 @@ } /** - * Constructs a <code>SOAPException</code> object with the given - * <code>String</code> as the reason for the exception being thrown - * and the given <code>Throwable</code> object as an embedded + * Constructs a {@code SOAPException} object with the given + * {@code String} as the reason for the exception being thrown + * and the given {@code Throwable} object as an embedded * exception. * * @param reason a description of what caused the exception - * @param cause a <code>Throwable</code> object that is to - * be embedded in this <code>SOAPException</code> object + * @param cause a {@code Throwable} object that is to + * be embedded in this {@code SOAPException} object */ public SOAPException(String reason, Throwable cause) { super(reason); @@ -81,8 +81,8 @@ } /** - * Constructs a <code>SOAPException</code> object initialized - * with the given <code>Throwable</code> object. + * Constructs a {@code SOAPException} object initialized + * with the given {@code Throwable} object. */ public SOAPException(Throwable cause) { super(cause.toString()); @@ -90,17 +90,17 @@ } /** - * Returns the detail message for this <code>SOAPException</code> + * Returns the detail message for this {@code SOAPException} * object. * <P> - * If there is an embedded <code>Throwable</code> object, and if the - * <code>SOAPException</code> object has no detail message of its + * If there is an embedded {@code Throwable} object, and if the + * {@code SOAPException} object has no detail message of its * own, this method will return the detail message from the embedded - * <code>Throwable</code> object. + * {@code Throwable} object. * * @return the error or warning message for this - * <code>SOAPException</code> or, if it has none, the - * message of the embedded <code>Throwable</code> object, + * {@code SOAPException} or, if it has none, the + * message of the embedded {@code Throwable} object, * if there is one */ public String getMessage() { @@ -113,11 +113,11 @@ } /** - * Returns the <code>Throwable</code> object embedded in this - * <code>SOAPException</code> if there is one. Otherwise, this method - * returns <code>null</code>. + * Returns the {@code Throwable} object embedded in this + * {@code SOAPException} if there is one. Otherwise, this method + * returns {@code null}. * - * @return the embedded <code>Throwable</code> object or <code>null</code> + * @return the embedded {@code Throwable} object or {@code null} * if there is none */ @@ -126,29 +126,29 @@ } /** - * Initializes the <code>cause</code> field of this <code>SOAPException</code> - * object with the given <code>Throwable</code> object. + * Initializes the {@code cause} field of this {@code SOAPException} + * object with the given {@code Throwable} object. * <P> * This method can be called at most once. It is generally called from * within the constructor or immediately after the constructor has - * returned a new <code>SOAPException</code> object. - * If this <code>SOAPException</code> object was created with the + * returned a new {@code SOAPException} object. + * If this {@code SOAPException} object was created with the * constructor {@link #SOAPException(Throwable)} or * {@link #SOAPException(String,Throwable)}, meaning that its - * <code>cause</code> field already has a value, this method cannot be + * {@code cause} field already has a value, this method cannot be * called even once. * - * @param cause the <code>Throwable</code> object that caused this - * <code>SOAPException</code> object to be thrown. The value of this + * @param cause the {@code Throwable} object that caused this + * {@code SOAPException} object to be thrown. The value of this * parameter is saved for later retrieval by the * {@link #getCause()} method. A <tt>null</tt> value is * permitted and indicates that the cause is nonexistent or * unknown. - * @return a reference to this <code>SOAPException</code> instance - * @throws IllegalArgumentException if <code>cause</code> is this - * <code>Throwable</code> object. (A <code>Throwable</code> object + * @return a reference to this {@code SOAPException} instance + * @throws IllegalArgumentException if {@code cause} is this + * {@code Throwable} object. (A {@code Throwable} object * cannot be its own cause.) - * @throws IllegalStateException if the cause for this <code>SOAPException</code> object + * @throws IllegalStateException if the cause for this {@code SOAPException} object * has already been initialized */ public synchronized Throwable initCause(Throwable cause) {
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFactory.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFactory.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -30,18 +30,18 @@ import org.w3c.dom.Element; /** - * <code>SOAPFactory</code> is a factory for creating various objects + * {@code SOAPFactory} is a factory for creating various objects * that exist in the SOAP XML tree. - * <code>SOAPFactory</code> can be + * {@code SOAPFactory} can be * used to create XML fragments that will eventually end up in the * SOAP part. These fragments can be inserted as children of the * {@link SOAPHeaderElement} or {@link SOAPBodyElement} or * {@link SOAPEnvelope} or other {@link SOAPElement} objects. * - * <code>SOAPFactory</code> also has methods to create - * <code>javax.xml.soap.Detail</code> objects as well as - * <code>java.xml.soap.Name</code> objects. + * {@code SOAPFactory} also has methods to create + * {@code javax.xml.soap.Detail} objects as well as + * {@code java.xml.soap.Name} objects. * * @since 1.6 */ @@ -49,34 +49,34 @@ /** * A constant representing the property used to lookup the name of - * a <code>SOAPFactory</code> implementation class. + * a {@code SOAPFactory} implementation class. */ static private final String SOAP_FACTORY_PROPERTY = "javax.xml.soap.SOAPFactory"; /** - * Class name of default <code>SOAPFactory</code> implementation. + * Class name of default {@code SOAPFactory} implementation. */ static final String DEFAULT_SOAP_FACTORY = "com.sun.xml.internal.messaging.saaj.soap.ver1_1.SOAPFactory1_1Impl"; /** - * Creates a <code>SOAPElement</code> object from an existing DOM - * <code>Element</code>. If the DOM <code>Element</code> that is passed in - * as an argument is already a <code>SOAPElement</code> then this method + * Creates a {@code SOAPElement} object from an existing DOM + * {@code Element}. If the DOM {@code Element} that is passed in + * as an argument is already a {@code SOAPElement} then this method * must return it unmodified without any further work. Otherwise, a new - * <code>SOAPElement</code> is created and a deep copy is made of the - * <code>domElement</code> argument. The concrete type of the return value - * will depend on the name of the <code>domElement</code> argument. If any - * part of the tree rooted in <code>domElement</code> violates SOAP rules, a - * <code>SOAPException</code> will be thrown. + * {@code SOAPElement} is created and a deep copy is made of the + * {@code domElement} argument. The concrete type of the return value + * will depend on the name of the {@code domElement} argument. If any + * part of the tree rooted in {@code domElement} violates SOAP rules, a + * {@code SOAPException} will be thrown. * - * @param domElement - the <code>Element</code> to be copied. + * @param domElement - the {@code Element} to be copied. * - * @return a new <code>SOAPElement</code> that is a copy of <code>domElement</code>. + * @return a new {@code SOAPElement} that is a copy of {@code domElement}. * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * * @since 1.6, SAAJ 1.3 */ @@ -85,41 +85,41 @@ } /** - * Creates a <code>SOAPElement</code> object initialized with the - * given <code>Name</code> object. The concrete type of the return value - * will depend on the name given to the new <code>SOAPElement</code>. For - * instance, a new <code>SOAPElement</code> with the name + * Creates a {@code SOAPElement} object initialized with the + * given {@code Name} object. The concrete type of the return value + * will depend on the name given to the new {@code SOAPElement}. For + * instance, a new {@code SOAPElement} with the name * "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a - * <code>SOAPEnvelope</code> that supports SOAP 1.2 behavior to be created. + * {@code SOAPEnvelope} that supports SOAP 1.2 behavior to be created. * - * @param name a <code>Name</code> object with the XML name for + * @param name a {@code Name} object with the XML name for * the new element * - * @return the new <code>SOAPElement</code> object that was + * @return the new {@code SOAPElement} object that was * created * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * @see SOAPFactory#createElement(javax.xml.namespace.QName) */ public abstract SOAPElement createElement(Name name) throws SOAPException; /** - * Creates a <code>SOAPElement</code> object initialized with the - * given <code>QName</code> object. The concrete type of the return value - * will depend on the name given to the new <code>SOAPElement</code>. For - * instance, a new <code>SOAPElement</code> with the name + * Creates a {@code SOAPElement} object initialized with the + * given {@code QName} object. The concrete type of the return value + * will depend on the name given to the new {@code SOAPElement}. For + * instance, a new {@code SOAPElement} with the name * "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a - * <code>SOAPEnvelope</code> that supports SOAP 1.2 behavior to be created. + * {@code SOAPEnvelope} that supports SOAP 1.2 behavior to be created. * - * @param qname a <code>QName</code> object with the XML name for + * @param qname a {@code QName} object with the XML name for * the new element * - * @return the new <code>SOAPElement</code> object that was + * @return the new {@code SOAPElement} object that was * created * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object * @see SOAPFactory#createElement(Name) * @since 1.6, SAAJ 1.3 */ @@ -128,38 +128,38 @@ } /** - * Creates a <code>SOAPElement</code> object initialized with the + * Creates a {@code SOAPElement} object initialized with the * given local name. * - * @param localName a <code>String</code> giving the local name for + * @param localName a {@code String} giving the local name for * the new element * - * @return the new <code>SOAPElement</code> object that was + * @return the new {@code SOAPElement} object that was * created * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object */ public abstract SOAPElement createElement(String localName) throws SOAPException; /** - * Creates a new <code>SOAPElement</code> object with the given + * Creates a new {@code SOAPElement} object with the given * local name, prefix and uri. The concrete type of the return value - * will depend on the name given to the new <code>SOAPElement</code>. For - * instance, a new <code>SOAPElement</code> with the name + * will depend on the name given to the new {@code SOAPElement}. For + * instance, a new {@code SOAPElement} with the name * "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a - * <code>SOAPEnvelope</code> that supports SOAP 1.2 behavior to be created. + * {@code SOAPEnvelope} that supports SOAP 1.2 behavior to be created. * - * @param localName a <code>String</code> giving the local name + * @param localName a {@code String} giving the local name * for the new element - * @param prefix the prefix for this <code>SOAPElement</code> - * @param uri a <code>String</code> giving the URI of the + * @param prefix the prefix for this {@code SOAPElement} + * @param uri a {@code String} giving the URI of the * namespace to which the new element belongs * * @exception SOAPException if there is an error in creating the - * <code>SOAPElement</code> object + * {@code SOAPElement} object */ public abstract SOAPElement createElement( String localName, @@ -168,51 +168,51 @@ throws SOAPException; /** - * Creates a new <code>Detail</code> object which serves as a container - * for <code>DetailEntry</code> objects. + * Creates a new {@code Detail} object which serves as a container + * for {@code DetailEntry} objects. * <P> - * This factory method creates <code>Detail</code> objects for use in - * situations where it is not practical to use the <code>SOAPFault</code> + * This factory method creates {@code Detail} objects for use in + * situations where it is not practical to use the {@code SOAPFault} * abstraction. * - * @return a <code>Detail</code> object + * @return a {@code Detail} object * @throws SOAPException if there is a SOAP error * @throws UnsupportedOperationException if the protocol specified - * for the SOAPFactory was <code>DYNAMIC_SOAP_PROTOCOL</code> + * for the SOAPFactory was {@code DYNAMIC_SOAP_PROTOCOL} */ public abstract Detail createDetail() throws SOAPException; /** - *Creates a new <code>SOAPFault</code> object initialized with the given <code>reasonText</code> - * and <code>faultCode</code> + *Creates a new {@code SOAPFault} object initialized with the given {@code reasonText} + * and {@code faultCode} *@param reasonText the ReasonText/FaultString for the fault *@param faultCode the FaultCode for the fault - *@return a <code>SOAPFault</code> object + *@return a {@code SOAPFault} object *@throws SOAPException if there is a SOAP error *@since 1.6, SAAJ 1.3 */ public abstract SOAPFault createFault(String reasonText, QName faultCode) throws SOAPException; /** - *Creates a new default <code>SOAPFault</code> object - *@return a <code>SOAPFault</code> object + *Creates a new default {@code SOAPFault} object + *@return a {@code SOAPFault} object *@throws SOAPException if there is a SOAP error *@since 1.6, SAAJ 1.3 */ public abstract SOAPFault createFault() throws SOAPException; /** - * Creates a new <code>Name</code> object initialized with the + * Creates a new {@code Name} object initialized with the * given local name, namespace prefix, and namespace URI. * <P> - * This factory method creates <code>Name</code> objects for use in - * situations where it is not practical to use the <code>SOAPEnvelope</code> + * This factory method creates {@code Name} objects for use in + * situations where it is not practical to use the {@code SOAPEnvelope} * abstraction. * - * @param localName a <code>String</code> giving the local name - * @param prefix a <code>String</code> giving the prefix of the namespace - * @param uri a <code>String</code> giving the URI of the namespace - * @return a <code>Name</code> object initialized with the given + * @param localName a {@code String} giving the local name + * @param prefix a {@code String} giving the prefix of the namespace + * @param uri a {@code String} giving the URI of the namespace + * @return a {@code Name} object initialized with the given * local name, namespace prefix, and namespace URI * @throws SOAPException if there is a SOAP error */ @@ -223,22 +223,22 @@ throws SOAPException; /** - * Creates a new <code>Name</code> object initialized with the + * Creates a new {@code Name} object initialized with the * given local name. * <P> - * This factory method creates <code>Name</code> objects for use in - * situations where it is not practical to use the <code>SOAPEnvelope</code> + * This factory method creates {@code Name} objects for use in + * situations where it is not practical to use the {@code SOAPEnvelope} * abstraction. * - * @param localName a <code>String</code> giving the local name - * @return a <code>Name</code> object initialized with the given + * @param localName a {@code String} giving the local name + * @return a {@code Name} object initialized with the given * local name * @throws SOAPException if there is a SOAP error */ public abstract Name createName(String localName) throws SOAPException; /** - * Creates a new <code>SOAPFactory</code> object that is an instance of + * Creates a new {@code SOAPFactory} object that is an instance of * the default implementation (SOAP 1.1), * * This method uses the following ordered lookup procedure to determine the SOAPFactory implementation class to load: @@ -252,10 +252,10 @@ * <LI> Use the SAAJMetaFactory instance to locate the SOAPFactory implementation class. * </UL> * - * @return a new instance of a <code>SOAPFactory</code> + * @return a new instance of a {@code SOAPFactory} * * @exception SOAPException if there was an error creating the - * default <code>SOAPFactory</code> + * default {@code SOAPFactory} * @see SAAJMetaFactory */ public static SOAPFactory newInstance() @@ -275,21 +275,21 @@ } /** - * Creates a new <code>SOAPFactory</code> object that is an instance of + * Creates a new {@code SOAPFactory} object that is an instance of * the specified implementation, this method uses the SAAJMetaFactory to * locate the implementation class and create the SOAPFactory instance. * - * @return a new instance of a <code>SOAPFactory</code> + * @return a new instance of a {@code SOAPFactory} * * @param protocol a string constant representing the protocol of the * specified SOAP factory implementation. May be - * either <code>DYNAMIC_SOAP_PROTOCOL</code>, - * <code>DEFAULT_SOAP_PROTOCOL</code> (which is the same - * as) <code>SOAP_1_1_PROTOCOL</code>, or - * <code>SOAP_1_2_PROTOCOL</code>. + * either {@code DYNAMIC_SOAP_PROTOCOL}, + * {@code DEFAULT_SOAP_PROTOCOL} (which is the same + * as) {@code SOAP_1_1_PROTOCOL}, or + * {@code SOAP_1_2_PROTOCOL}. * * @exception SOAPException if there was an error creating the - * specified <code>SOAPFactory</code> + * specified {@code SOAPFactory} * @see SAAJMetaFactory * @since 1.6, SAAJ 1.3 */
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFault.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFault.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -31,16 +31,16 @@ import javax.xml.namespace.QName; /** - * An element in the <code>SOAPBody</code> object that contains + * An element in the {@code SOAPBody} object that contains * error and/or status information. This information may relate to - * errors in the <code>SOAPMessage</code> object or to problems + * errors in the {@code SOAPMessage} object or to problems * that are not related to the content in the message itself. Problems * not related to the message itself are generally errors in * processing, such as the inability to communicate with an upstream * server. * <P> - * Depending on the <code>protocol</code> specified while creating the - * <code>MessageFactory</code> instance, a <code>SOAPFault</code> has + * Depending on the {@code protocol} specified while creating the + * {@code MessageFactory} instance, a {@code SOAPFault} has * sub-elements as defined in the SOAP 1.1/SOAP 1.2 specification. * * @since 1.6 @@ -48,14 +48,14 @@ public interface SOAPFault extends SOAPBodyElement { /** - * Sets this <code>SOAPFault</code> object with the given fault code. + * Sets this {@code SOAPFault} object with the given fault code. * * <P> Fault codes, which give information about the fault, are defined * in the SOAP 1.1 specification. A fault code is mandatory and must - * be of type <code>Name</code>. This method provides a convenient + * be of type {@code Name}. This method provides a convenient * way to set a fault code. For example, * - * <PRE> + * <pre>{@code * SOAPEnvelope se = ...; * // Create a qualified name in the SOAP namespace with a localName * // of "Client". Note that prefix parameter is optional and is null @@ -64,10 +64,10 @@ * SOAPConstants.URI_NS_SOAP_ENVELOPE); * SOAPFault fault = ...; * fault.setFaultCode(qname); - * </PRE> + * }</pre> * It is preferable to use this method over {@link #setFaultCode(String)}. * - * @param faultCodeQName a <code>Name</code> object giving the fault + * @param faultCodeQName a {@code Name} object giving the fault * code to be set. It must be namespace qualified. * @see #getFaultCodeAsName * @@ -79,16 +79,16 @@ public void setFaultCode(Name faultCodeQName) throws SOAPException; /** - * Sets this <code>SOAPFault</code> object with the given fault code. + * Sets this {@code SOAPFault} object with the given fault code. * * It is preferable to use this method over {@link #setFaultCode(Name)}. * - * @param faultCodeQName a <code>QName</code> object giving the fault + * @param faultCodeQName a {@code QName} object giving the fault * code to be set. It must be namespace qualified. * @see #getFaultCodeAsQName * * @exception SOAPException if there was an error in adding the - * <code>faultcode</code> element to the underlying XML tree. + * {@code faultcode} element to the underlying XML tree. * * @see #setFaultCode(Name) * @see #getFaultCodeAsQName() @@ -98,14 +98,14 @@ public void setFaultCode(QName faultCodeQName) throws SOAPException; /** - * Sets this <code>SOAPFault</code> object with the give fault code. + * Sets this {@code SOAPFault} object with the give fault code. * <P> * Fault codes, which given information about the fault, are defined in * the SOAP 1.1 specification. This element is mandatory in SOAP 1.1. * Because the fault code is required to be a QName it is preferable to * use the {@link #setFaultCode(Name)} form of this method. * - * @param faultCode a <code>String</code> giving the fault code to be set. + * @param faultCode a {@code String} giving the fault code to be set. * It must be of the form "prefix:localName" where the prefix has * been defined in a namespace declaration. * @see #setFaultCode(Name) @@ -113,21 +113,21 @@ * @see SOAPElement#addNamespaceDeclaration * * @exception SOAPException if there was an error in adding the - * <code>faultCode</code> to the underlying XML tree. + * {@code faultCode} to the underlying XML tree. */ public void setFaultCode(String faultCode) throws SOAPException; /** * Gets the mandatory SOAP 1.1 fault code for this - * <code>SOAPFault</code> object as a SAAJ <code>Name</code> object. + * {@code SOAPFault} object as a SAAJ {@code Name} object. * The SOAP 1.1 specification requires the value of the "faultcode" * element to be of type QName. This method returns the content of the * element as a QName in the form of a SAAJ Name object. This method - * should be used instead of the <code>getFaultCode</code> method since + * should be used instead of the {@code getFaultCode} method since * it allows applications to easily access the namespace name without * additional parsing. * - * @return a <code>Name</code> representing the faultcode + * @return a {@code Name} representing the faultcode * @see #setFaultCode(Name) * * @since 1.6, SAAJ 1.2 @@ -137,9 +137,9 @@ /** * Gets the fault code for this - * <code>SOAPFault</code> object as a <code>QName</code> object. + * {@code SOAPFault} object as a {@code QName} object. * - * @return a <code>QName</code> representing the faultcode + * @return a {@code QName} representing the faultcode * * @see #setFaultCode(QName) * @@ -148,12 +148,12 @@ public QName getFaultCodeAsQName(); /** - * Gets the Subcodes for this <code>SOAPFault</code> as an iterator over - * <code>QNames</code>. + * Gets the Subcodes for this {@code SOAPFault} as an iterator over + * {@code QNames}. * - * @return an <code>Iterator</code> that accesses a sequence of - * <code>QNames</code>. This <code>Iterator</code> should not support - * the optional <code>remove</code> method. The order in which the + * @return an {@code Iterator} that accesses a sequence of + * {@code QNames}. This {@code Iterator} should not support + * the optional {@code remove} method. The order in which the * Subcodes are returned reflects the hierarchy of Subcodes present * in the fault from top to bottom. * @@ -166,9 +166,9 @@ /** * Removes any Subcodes that may be contained by this - * <code>SOAPFault</code>. Subsequent calls to - * <code>getFaultSubcodes</code> will return an empty iterator until a call - * to <code>appendFaultSubcode</code> is made. + * {@code SOAPFault}. Subsequent calls to + * {@code getFaultSubcodes} will return an empty iterator until a call + * to {@code appendFaultSubcode} is made. * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Subcode. @@ -179,7 +179,7 @@ /** * Adds a Subcode to the end of the sequence of Subcodes contained by this - * <code>SOAPFault</code>. Subcodes, which were introduced in SOAP 1.2, are + * {@code SOAPFault}. Subcodes, which were introduced in SOAP 1.2, are * represented by a recursive sequence of subelements rooted in the * mandatory Code subelement of a SOAP Fault. * @@ -194,83 +194,83 @@ public void appendFaultSubcode(QName subcode) throws SOAPException; /** - * Gets the fault code for this <code>SOAPFault</code> object. + * Gets the fault code for this {@code SOAPFault} object. * - * @return a <code>String</code> with the fault code + * @return a {@code String} with the fault code * @see #getFaultCodeAsName * @see #setFaultCode */ public String getFaultCode(); /** - * Sets this <code>SOAPFault</code> object with the given fault actor. + * Sets this {@code SOAPFault} object with the given fault actor. * <P> * The fault actor is the recipient in the message path who caused the * fault to happen. * <P> - * If this <code>SOAPFault</code> supports SOAP 1.2 then this call is + * If this {@code SOAPFault} supports SOAP 1.2 then this call is * equivalent to {@link #setFaultRole(String)} * - * @param faultActor a <code>String</code> identifying the actor that - * caused this <code>SOAPFault</code> object + * @param faultActor a {@code String} identifying the actor that + * caused this {@code SOAPFault} object * @see #getFaultActor * * @exception SOAPException if there was an error in adding the - * <code>faultActor</code> to the underlying XML tree. + * {@code faultActor} to the underlying XML tree. */ public void setFaultActor(String faultActor) throws SOAPException; /** - * Gets the fault actor for this <code>SOAPFault</code> object. + * Gets the fault actor for this {@code SOAPFault} object. * <P> - * If this <code>SOAPFault</code> supports SOAP 1.2 then this call is + * If this {@code SOAPFault} supports SOAP 1.2 then this call is * equivalent to {@link #getFaultRole()} * - * @return a <code>String</code> giving the actor in the message path - * that caused this <code>SOAPFault</code> object + * @return a {@code String} giving the actor in the message path + * that caused this {@code SOAPFault} object * @see #setFaultActor */ public String getFaultActor(); /** - * Sets the fault string for this <code>SOAPFault</code> object + * Sets the fault string for this {@code SOAPFault} object * to the given string. * <P> * If this - * <code>SOAPFault</code> is part of a message that supports SOAP 1.2 then + * {@code SOAPFault} is part of a message that supports SOAP 1.2 then * this call is equivalent to: - * <pre> + * <pre>{@code * addFaultReasonText(faultString, Locale.getDefault()); - * </pre> + * }</pre> * - * @param faultString a <code>String</code> giving an explanation of + * @param faultString a {@code String} giving an explanation of * the fault * @see #getFaultString * * @exception SOAPException if there was an error in adding the - * <code>faultString</code> to the underlying XML tree. + * {@code faultString} to the underlying XML tree. */ public void setFaultString(String faultString) throws SOAPException; /** - * Sets the fault string for this <code>SOAPFault</code> object + * Sets the fault string for this {@code SOAPFault} object * to the given string and localized to the given locale. * <P> * If this - * <code>SOAPFault</code> is part of a message that supports SOAP 1.2 then + * {@code SOAPFault} is part of a message that supports SOAP 1.2 then * this call is equivalent to: - * <pre> + * <pre>{@code * addFaultReasonText(faultString, locale); - * </pre> + * }</pre> * - * @param faultString a <code>String</code> giving an explanation of + * @param faultString a {@code String} giving an explanation of * the fault * @param locale a {@link java.util.Locale Locale} object indicating - * the native language of the <code>faultString</code> + * the native language of the {@code faultString} * @see #getFaultString * * @exception SOAPException if there was an error in adding the - * <code>faultString</code> to the underlying XML tree. + * {@code faultString} to the underlying XML tree. * * @since 1.6, SAAJ 1.2 */ @@ -278,20 +278,20 @@ throws SOAPException; /** - * Gets the fault string for this <code>SOAPFault</code> object. + * Gets the fault string for this {@code SOAPFault} object. * <P> * If this - * <code>SOAPFault</code> is part of a message that supports SOAP 1.2 then + * {@code SOAPFault} is part of a message that supports SOAP 1.2 then * this call is equivalent to: - * <pre> + * <pre>{@code * String reason = null; * try { * reason = (String) getFaultReasonTexts().next(); * } catch (SOAPException e) {} * return reason; - * </pre> + * }</pre> * - * @return a <code>String</code> giving an explanation of + * @return a {@code String} giving an explanation of * the fault * @see #setFaultString(String) * @see #setFaultString(String, Locale) @@ -299,22 +299,22 @@ public String getFaultString(); /** - * Gets the locale of the fault string for this <code>SOAPFault</code> + * Gets the locale of the fault string for this {@code SOAPFault} * object. * <P> * If this - * <code>SOAPFault</code> is part of a message that supports SOAP 1.2 then + * {@code SOAPFault} is part of a message that supports SOAP 1.2 then * this call is equivalent to: - * <pre> + * <pre>{@code * Locale locale = null; * try { * locale = (Locale) getFaultReasonLocales().next(); * } catch (SOAPException e) {} * return locale; - * </pre> + * }</pre> * - * @return a <code>Locale</code> object indicating the native language of - * the fault string or <code>null</code> if no locale was specified + * @return a {@code Locale} object indicating the native language of + * the fault string or {@code null} if no locale was specified * @see #setFaultString(String, Locale) * * @since 1.6, SAAJ 1.2 @@ -322,11 +322,11 @@ public Locale getFaultStringLocale(); /** - * Returns true if this <code>SOAPFault</code> has a <code>Detail</code> + * Returns true if this {@code SOAPFault} has a {@code Detail} * subelement and false otherwise. Equivalent to - * <code>(getDetail()!=null)</code>. + * {@code (getDetail()!=null)}. * - * @return true if this <code>SOAPFault</code> has a <code>Detail</code> + * @return true if this {@code SOAPFault} has a {@code Detail} * subelement and false otherwise. * * @since 1.6, SAAJ 1.3 @@ -334,44 +334,44 @@ public boolean hasDetail(); /** - * Returns the optional detail element for this <code>SOAPFault</code> + * Returns the optional detail element for this {@code SOAPFault} * object. * <P> - * A <code>Detail</code> object carries application-specific error + * A {@code Detail} object carries application-specific error * information, the scope of the error information is restricted to - * faults in the <code>SOAPBodyElement</code> objects if this is a + * faults in the {@code SOAPBodyElement} objects if this is a * SOAP 1.1 Fault. * - * @return a <code>Detail</code> object with application-specific + * @return a {@code Detail} object with application-specific * error information if present, null otherwise */ public Detail getDetail(); /** - * Creates an optional <code>Detail</code> object and sets it as the - * <code>Detail</code> object for this <code>SOAPFault</code> + * Creates an optional {@code Detail} object and sets it as the + * {@code Detail} object for this {@code SOAPFault} * object. * <P> * It is illegal to add a detail when the fault already * contains a detail. Therefore, this method should be called * only after the existing detail has been removed. * - * @return the new <code>Detail</code> object + * @return the new {@code Detail} object * * @exception SOAPException if this - * <code>SOAPFault</code> object already contains a - * valid <code>Detail</code> object + * {@code SOAPFault} object already contains a + * valid {@code Detail} object */ public Detail addDetail() throws SOAPException; /** - * Returns an <code>Iterator</code> over a distinct sequence of - * <code>Locale</code>s for which there are associated Reason Text items. - * Any of these <code>Locale</code>s can be used in a call to - * <code>getFaultReasonText</code> in order to obtain a localized version + * Returns an {@code Iterator} over a distinct sequence of + * {@code Locale}s for which there are associated Reason Text items. + * Any of these {@code Locale}s can be used in a call to + * {@code getFaultReasonText} in order to obtain a localized version * of the Reason Text string. * - * @return an <code>Iterator</code> over a sequence of <code>Locale</code> + * @return an {@code Iterator} over a sequence of {@code Locale} * objects for which there are associated Reason Text items. * * @exception SOAPException if there was an error in retrieving @@ -384,11 +384,11 @@ public Iterator getFaultReasonLocales() throws SOAPException; /** - * Returns an <code>Iterator</code> over a sequence of - * <code>String</code> objects containing all of the Reason Text items for - * this <code>SOAPFault</code>. + * Returns an {@code Iterator} over a sequence of + * {@code String} objects containing all of the Reason Text items for + * this {@code SOAPFault}. * - * @return an <code>Iterator</code> over env:Fault/env:Reason/env:Text items. + * @return an {@code Iterator} over env:Fault/env:Reason/env:Text items. * * @exception SOAPException if there was an error in retrieving * the fault Reason texts. @@ -400,14 +400,14 @@ public Iterator getFaultReasonTexts() throws SOAPException; /** - * Returns the Reason Text associated with the given <code>Locale</code>. + * Returns the Reason Text associated with the given {@code Locale}. * If more than one such Reason Text exists the first matching Text is * returned * - * @param locale -- the <code>Locale</code> for which a localized + * @param locale -- the {@code Locale} for which a localized * Reason Text is desired * - * @return the Reason Text associated with <code>locale</code> + * @return the Reason Text associated with {@code locale} * * @see #getFaultString * @@ -423,23 +423,23 @@ /** * Appends or replaces a Reason Text item containing the specified * text message and an <i>xml:lang</i> derived from - * <code>locale</code>. If a Reason Text item with this + * {@code locale}. If a Reason Text item with this * <i>xml:lang</i> already exists its text value will be replaced - * with <code>text</code>. - * The <code>locale</code> parameter should not be <code>null</code> + * with {@code text}. + * The {@code locale} parameter should not be {@code null} * <P> * Code sample: * - * <PRE> + * <pre>{@code * SOAPFault fault = ...; * fault.addFaultReasonText("Version Mismatch", Locale.ENGLISH); - * </PRE> + * }</pre> * * @param text -- reason message string * @param locale -- Locale object representing the locale of the message * * @exception SOAPException if there was an error in adding the Reason text - * or the <code>locale</code> passed was <code>null</code>. + * or the {@code locale} passed was {@code null}. * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Reason. * @@ -450,11 +450,11 @@ /** * Returns the optional Node element value for this - * <code>SOAPFault</code> object. The Node element is + * {@code SOAPFault} object. The Node element is * optional in SOAP 1.2. * * @return Content of the env:Fault/env:Node element as a String - * or <code>null</code> if none + * or {@code null} if none * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Node. @@ -465,11 +465,11 @@ /** * Creates or replaces any existing Node element value for - * this <code>SOAPFault</code> object. The Node element + * this {@code SOAPFault} object. The Node element * is optional in SOAP 1.2. * * @exception SOAPException if there was an error in setting the - * Node for this <code>SOAPFault</code> object. + * Node for this {@code SOAPFault} object. * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Node. * @@ -480,11 +480,11 @@ /** * Returns the optional Role element value for this - * <code>SOAPFault</code> object. The Role element is + * {@code SOAPFault} object. The Role element is * optional in SOAP 1.2. * * @return Content of the env:Fault/env:Role element as a String - * or <code>null</code> if none + * or {@code null} if none * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Role. @@ -495,13 +495,13 @@ /** * Creates or replaces any existing Role element value for - * this <code>SOAPFault</code> object. The Role element + * this {@code SOAPFault} object. The Role element * is optional in SOAP 1.2. * * @param uri - the URI of the Role * * @exception SOAPException if there was an error in setting the - * Role for this <code>SOAPFault</code> object. + * Role for this {@code SOAPFault} object. * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Role.
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFaultElement.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFaultElement.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,11 +27,11 @@ /** * A representation of the contents in - * a <code>SOAPFault</code> object. The <code>Detail</code> interface - * is a <code>SOAPFaultElement</code>. + * a {@code SOAPFault} object. The {@code Detail} interface + * is a {@code SOAPFaultElement}. * <P> - * Content is added to a <code>SOAPFaultElement</code> using the - * <code>SOAPElement</code> method <code>addTextNode</code>. + * Content is added to a {@code SOAPFaultElement} using the + * {@code SOAPElement} method {@code addTextNode}. * * @since 1.6 */
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeader.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeader.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,49 +34,49 @@ * element. A SOAP header element consists of XML data that affects * the way the application-specific content is processed by the message * provider. For example, transaction semantics, authentication information, - * and so on, can be specified as the content of a <code>SOAPHeader</code> + * and so on, can be specified as the content of a {@code SOAPHeader} * object. * <P> - * A <code>SOAPEnvelope</code> object contains an empty - * <code>SOAPHeader</code> object by default. If the <code>SOAPHeader</code> + * A {@code SOAPEnvelope} object contains an empty + * {@code SOAPHeader} object by default. If the {@code SOAPHeader} * object, which is optional, is not needed, it can be retrieved and deleted * with the following line of code. The variable <i>se</i> is a - * <code>SOAPEnvelope</code> object. - * <PRE> + * {@code SOAPEnvelope} object. + * <pre>{@code * se.getHeader().detachNode(); - * </PRE> + * }</pre> * - * A <code>SOAPHeader</code> object is created with the <code>SOAPEnvelope</code> - * method <code>addHeader</code>. This method, which creates a new header and adds it + * A {@code SOAPHeader} object is created with the {@code SOAPEnvelope} + * method {@code addHeader}. This method, which creates a new header and adds it * to the envelope, may be called only after the existing header has been removed. * - * <PRE> + * <pre>{@code * se.getHeader().detachNode(); * SOAPHeader sh = se.addHeader(); - * </PRE> + * }</pre> * <P> - * A <code>SOAPHeader</code> object can have only <code>SOAPHeaderElement</code> - * objects as its immediate children. The method <code>addHeaderElement</code> - * creates a new <code>HeaderElement</code> object and adds it to the - * <code>SOAPHeader</code> object. In the following line of code, the - * argument to the method <code>addHeaderElement</code> is a <code>Name</code> - * object that is the name for the new <code>HeaderElement</code> object. - * <PRE> + * A {@code SOAPHeader} object can have only {@code SOAPHeaderElement} + * objects as its immediate children. The method {@code addHeaderElement} + * creates a new {@code HeaderElement} object and adds it to the + * {@code SOAPHeader} object. In the following line of code, the + * argument to the method {@code addHeaderElement} is a {@code Name} + * object that is the name for the new {@code HeaderElement} object. + * <pre>{@code * SOAPHeaderElement shElement = sh.addHeaderElement(name); - * </PRE> + * }</pre> * * @see SOAPHeaderElement * @since 1.6 */ public interface SOAPHeader extends SOAPElement { /** - * Creates a new <code>SOAPHeaderElement</code> object initialized with the - * specified name and adds it to this <code>SOAPHeader</code> object. + * Creates a new {@code SOAPHeaderElement} object initialized with the + * specified name and adds it to this {@code SOAPHeader} object. * - * @param name a <code>Name</code> object with the name of the new - * <code>SOAPHeaderElement</code> object - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @param name a {@code Name} object with the name of the new + * {@code SOAPHeaderElement} object + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs * @see SOAPHeader#addHeaderElement(javax.xml.namespace.QName) */ @@ -84,13 +84,13 @@ throws SOAPException; /** - * Creates a new <code>SOAPHeaderElement</code> object initialized with the - * specified qname and adds it to this <code>SOAPHeader</code> object. + * Creates a new {@code SOAPHeaderElement} object initialized with the + * specified qname and adds it to this {@code SOAPHeader} object. * - * @param qname a <code>QName</code> object with the qname of the new - * <code>SOAPHeaderElement</code> object - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @param qname a {@code QName} object with the qname of the new + * {@code SOAPHeaderElement} object + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs * @see SOAPHeader#addHeaderElement(Name) * @since 1.6, SAAJ 1.3 @@ -99,19 +99,19 @@ throws SOAPException; /** - * Returns an <code>Iterator</code> over all the <code>SOAPHeaderElement</code> objects - * in this <code>SOAPHeader</code> object + * Returns an {@code Iterator} over all the {@code SOAPHeaderElement} objects + * in this {@code SOAPHeader} object * that have the specified <i>actor</i> and that have a MustUnderstand attribute - * whose value is equivalent to <code>true</code>. + * whose value is equivalent to {@code true}. * <p> * In SOAP 1.2 the <i>env:actor</i> attribute is replaced by the <i>env:role</i> * attribute, but with essentially the same semantics. * - * @param actor a <code>String</code> giving the URI of the <code>actor</code> / <code>role</code> + * @param actor a {@code String} giving the URI of the {@code actor} / {@code role} * for which to search - * @return an <code>Iterator</code> object over all the - * <code>SOAPHeaderElement</code> objects that contain the specified - * <code>actor</code> / <code>role</code> and are marked as MustUnderstand + * @return an {@code Iterator} object over all the + * {@code SOAPHeaderElement} objects that contain the specified + * {@code actor} / {@code role} and are marked as MustUnderstand * @see #examineHeaderElements * @see #extractHeaderElements * @see SOAPConstants#URI_SOAP_ACTOR_NEXT @@ -121,8 +121,8 @@ public Iterator examineMustUnderstandHeaderElements(String actor); /** - * Returns an <code>Iterator</code> over all the <code>SOAPHeaderElement</code> objects - * in this <code>SOAPHeader</code> object + * Returns an {@code Iterator} over all the {@code SOAPHeaderElement} objects + * in this {@code SOAPHeader} object * that have the specified <i>actor</i>. * * An <i>actor</i> is a global attribute that indicates the intermediate @@ -130,40 +130,40 @@ * receiver. An actor receives the message and processes it before sending * it on to the next actor. The default actor is the ultimate intended * recipient for the message, so if no actor attribute is included in a - * <code>SOAPHeader</code> object, it is sent to the ultimate receiver + * {@code SOAPHeader} object, it is sent to the ultimate receiver * along with the message body. * <p> * In SOAP 1.2 the <i>env:actor</i> attribute is replaced by the <i>env:role</i> * attribute, but with essentially the same semantics. * - * @param actor a <code>String</code> giving the URI of the <code>actor</code> / <code>role</code> + * @param actor a {@code String} giving the URI of the {@code actor} / {@code role} * for which to search - * @return an <code>Iterator</code> object over all the - * <code>SOAPHeaderElement</code> objects that contain the specified - * <code>actor</code> / <code>role</code> + * @return an {@code Iterator} object over all the + * {@code SOAPHeaderElement} objects that contain the specified + * {@code actor} / {@code role} * @see #extractHeaderElements * @see SOAPConstants#URI_SOAP_ACTOR_NEXT */ public Iterator examineHeaderElements(String actor); /** - * Returns an <code>Iterator</code> over all the <code>SOAPHeaderElement</code> objects - * in this <code>SOAPHeader</code> object + * Returns an {@code Iterator} over all the {@code SOAPHeaderElement} objects + * in this {@code SOAPHeader} object * that have the specified <i>actor</i> and detaches them - * from this <code>SOAPHeader</code> object. + * from this {@code SOAPHeader} object. * <P> * This method allows an actor to process the parts of the - * <code>SOAPHeader</code> object that apply to it and to remove + * {@code SOAPHeader} object that apply to it and to remove * them before passing the message on to the next actor. * <p> * In SOAP 1.2 the <i>env:actor</i> attribute is replaced by the <i>env:role</i> * attribute, but with essentially the same semantics. * - * @param actor a <code>String</code> giving the URI of the <code>actor</code> / <code>role</code> + * @param actor a {@code String} giving the URI of the {@code actor} / {@code role} * for which to search - * @return an <code>Iterator</code> object over all the - * <code>SOAPHeaderElement</code> objects that contain the specified - * <code>actor</code> / <code>role</code> + * @return an {@code Iterator} object over all the + * {@code SOAPHeaderElement} objects that contain the specified + * {@code actor} / {@code role} * * @see #examineHeaderElements * @see SOAPConstants#URI_SOAP_ACTOR_NEXT @@ -171,14 +171,14 @@ public Iterator extractHeaderElements(String actor); /** - * Creates a new NotUnderstood <code>SOAPHeaderElement</code> object initialized - * with the specified name and adds it to this <code>SOAPHeader</code> object. + * Creates a new NotUnderstood {@code SOAPHeaderElement} object initialized + * with the specified name and adds it to this {@code SOAPHeader} object. * This operation is supported only by SOAP 1.2. * - * @param name a <code>QName</code> object with the name of the - * <code>SOAPHeaderElement</code> object that was not understood. - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @param name a {@code QName} object with the name of the + * {@code SOAPHeaderElement} object that was not understood. + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs. * @exception UnsupportedOperationException if this is a SOAP 1.1 Header. * @since 1.6, SAAJ 1.3 @@ -187,15 +187,15 @@ throws SOAPException; /** - * Creates a new Upgrade <code>SOAPHeaderElement</code> object initialized + * Creates a new Upgrade {@code SOAPHeaderElement} object initialized * with the specified List of supported SOAP URIs and adds it to this - * <code>SOAPHeader</code> object. + * {@code SOAPHeader} object. * This operation is supported on both SOAP 1.1 and SOAP 1.2 header. * - * @param supportedSOAPURIs an <code>Iterator</code> object with the URIs of SOAP + * @param supportedSOAPURIs an {@code Iterator} object with the URIs of SOAP * versions supported. - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs. * @since 1.6, SAAJ 1.3 */ @@ -203,14 +203,14 @@ throws SOAPException; /** - * Creates a new Upgrade <code>SOAPHeaderElement</code> object initialized + * Creates a new Upgrade {@code SOAPHeaderElement} object initialized * with the specified array of supported SOAP URIs and adds it to this - * <code>SOAPHeader</code> object. + * {@code SOAPHeader} object. * This operation is supported on both SOAP 1.1 and SOAP 1.2 header. * * @param supportedSoapUris an array of the URIs of SOAP versions supported. - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs. * @since 1.6, SAAJ 1.3 */ @@ -218,14 +218,14 @@ throws SOAPException; /** - * Creates a new Upgrade <code>SOAPHeaderElement</code> object initialized + * Creates a new Upgrade {@code SOAPHeaderElement} object initialized * with the specified supported SOAP URI and adds it to this - * <code>SOAPHeader</code> object. + * {@code SOAPHeader} object. * This operation is supported on both SOAP 1.1 and SOAP 1.2 header. * * @param supportedSoapUri the URI of SOAP the version that is supported. - * @return the new <code>SOAPHeaderElement</code> object that was - * inserted into this <code>SOAPHeader</code> object + * @return the new {@code SOAPHeaderElement} object that was + * inserted into this {@code SOAPHeader} object * @exception SOAPException if a SOAP error occurs. * @since 1.6, SAAJ 1.3 */ @@ -233,12 +233,12 @@ throws SOAPException; /** - * Returns an <code>Iterator</code> over all the <code>SOAPHeaderElement</code> objects - * in this <code>SOAPHeader</code> object. + * Returns an {@code Iterator} over all the {@code SOAPHeaderElement} objects + * in this {@code SOAPHeader} object. * - * @return an <code>Iterator</code> object over all the - * <code>SOAPHeaderElement</code> objects contained by this - * <code>SOAPHeader</code> + * @return an {@code Iterator} object over all the + * {@code SOAPHeaderElement} objects contained by this + * {@code SOAPHeader} * @see #extractAllHeaderElements * * @since 1.6, SAAJ 1.2 @@ -246,13 +246,13 @@ public Iterator examineAllHeaderElements(); /** - * Returns an <code>Iterator</code> over all the <code>SOAPHeaderElement</code> objects - * in this <code>SOAPHeader</code> object and detaches them - * from this <code>SOAPHeader</code> object. + * Returns an {@code Iterator} over all the {@code SOAPHeaderElement} objects + * in this {@code SOAPHeader} object and detaches them + * from this {@code SOAPHeader} object. * - * @return an <code>Iterator</code> object over all the - * <code>SOAPHeaderElement</code> objects contained by this - * <code>SOAPHeader</code> + * @return an {@code Iterator} object over all the + * {@code SOAPHeaderElement} objects contained by this + * {@code SOAPHeader} * * @see #examineAllHeaderElements *
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeaderElement.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeaderElement.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,25 +28,25 @@ /** * An object representing the contents in the SOAP header part of the * SOAP envelope. - * The immediate children of a <code>SOAPHeader</code> object can - * be represented only as <code>SOAPHeaderElement</code> objects. + * The immediate children of a {@code SOAPHeader} object can + * be represented only as {@code SOAPHeaderElement} objects. * <P> - * A <code>SOAPHeaderElement</code> object can have other - * <code>SOAPElement</code> objects as its children. + * A {@code SOAPHeaderElement} object can have other + * {@code SOAPElement} objects as its children. * * @since 1.6 */ public interface SOAPHeaderElement extends SOAPElement { /** - * Sets the actor associated with this <code>SOAPHeaderElement</code> + * Sets the actor associated with this {@code SOAPHeaderElement} * object to the specified actor. The default value of an actor is: - * <code>SOAPConstants.URI_SOAP_ACTOR_NEXT</code> + * {@code SOAPConstants.URI_SOAP_ACTOR_NEXT} * <P> - * If this <code>SOAPHeaderElement</code> supports SOAP 1.2 then this call is + * If this {@code SOAPHeaderElement} supports SOAP 1.2 then this call is * equivalent to {@link #setRole(String)} * - * @param actorURI a <code>String</code> giving the URI of the actor + * @param actorURI a {@code String} giving the URI of the actor * to set * * @exception IllegalArgumentException if there is a problem in @@ -57,10 +57,10 @@ public void setActor(String actorURI); /** - * Sets the <code>Role</code> associated with this <code>SOAPHeaderElement</code> - * object to the specified <code>Role</code>. + * Sets the {@code Role} associated with this {@code SOAPHeaderElement} + * object to the specified {@code Role}. * - * @param uri - the URI of the <code>Role</code> + * @param uri - the URI of the {@code Role} * * @throws SOAPException if there is an error in setting the role * @@ -73,20 +73,20 @@ /** * Returns the uri of the <i>actor</i> attribute of this - * <code>SOAPHeaderElement</code>. + * {@code SOAPHeaderElement}. *<P> - * If this <code>SOAPHeaderElement</code> supports SOAP 1.2 then this call is + * If this {@code SOAPHeaderElement} supports SOAP 1.2 then this call is * equivalent to {@link #getRole()} - * @return a <code>String</code> giving the URI of the actor + * @return a {@code String} giving the URI of the actor * @see #setActor */ public String getActor(); /** * Returns the value of the <i>Role</i> attribute of this - * <code>SOAPHeaderElement</code>. + * {@code SOAPHeaderElement}. * - * @return a <code>String</code> giving the URI of the <code>Role</code> + * @return a {@code String} giving the URI of the {@code Role} * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Role. @@ -96,16 +96,16 @@ public String getRole(); /** - * Sets the mustUnderstand attribute for this <code>SOAPHeaderElement</code> + * Sets the mustUnderstand attribute for this {@code SOAPHeaderElement} * object to be either true or false. * <P> * If the mustUnderstand attribute is on, the actor who receives the - * <code>SOAPHeaderElement</code> must process it correctly. This - * ensures, for example, that if the <code>SOAPHeaderElement</code> + * {@code SOAPHeaderElement} must process it correctly. This + * ensures, for example, that if the {@code SOAPHeaderElement} * object modifies the message, that the message is being modified correctly. * - * @param mustUnderstand <code>true</code> to set the mustUnderstand - * attribute to true; <code>false</code> to set it to false + * @param mustUnderstand {@code true} to set the mustUnderstand + * attribute to true; {@code false} to set it to false * * @exception IllegalArgumentException if there is a problem in * setting the mustUnderstand attribute @@ -116,16 +116,16 @@ /** * Returns the boolean value of the mustUnderstand attribute for this - * <code>SOAPHeaderElement</code>. + * {@code SOAPHeaderElement}. * - * @return <code>true</code> if the mustUnderstand attribute of this - * <code>SOAPHeaderElement</code> object is turned on; <code>false</code> + * @return {@code true} if the mustUnderstand attribute of this + * {@code SOAPHeaderElement} object is turned on; {@code false} * otherwise */ public boolean getMustUnderstand(); /** - * Sets the <i>relay</i> attribute for this <code>SOAPHeaderElement</code> to be + * Sets the <i>relay</i> attribute for this {@code SOAPHeaderElement} to be * either true or false. * <P> * The SOAP relay attribute is set to true to indicate that the SOAP header @@ -133,7 +133,7 @@ * but not actually process it. This attribute is ignored on header blocks * whose mustUnderstand attribute is set to true or that are targeted at * the ultimate reciever (which is the default). The default value of this - * attribute is <code>false</code>. + * attribute is {@code false}. * * @param relay the new value of the <i>relay</i> attribute * @@ -151,10 +151,10 @@ /** * Returns the boolean value of the <i>relay</i> attribute for this - * <code>SOAPHeaderElement</code> + * {@code SOAPHeaderElement} * - * @return <code>true</code> if the relay attribute is turned on; - * <code>false</code> otherwise + * @return {@code true} if the relay attribute is turned on; + * {@code false} otherwise * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Relay attribute.
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPMessage.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPMessage.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -55,12 +55,12 @@ * object, and the {@code SOAPEnvelope} object is used to retrieve the * {@code SOAPBody} and {@code SOAPHeader} objects. * - * <PRE> + * <pre>{@code * SOAPPart sp = message.getSOAPPart(); * SOAPEnvelope se = sp.getEnvelope(); * SOAPBody sb = se.getBody(); * SOAPHeader sh = se.getHeader(); - * </PRE> + * }</pre> * * <P> * In addition to the mandatory {@code SOAPPart} object, a {@code SOAPMessage} @@ -103,14 +103,15 @@ * @since 1.6 */ public abstract class SOAPMessage { + /** - * Specifies the character type encoding for the SOAP Message. Valid values - * include "utf-8" and "utf-16". See vendor documentation for additional - * supported values. The default is "utf-8". - * - * @see SOAPMessage#setProperty(String, Object) SOAPMessage.setProperty - * @since 1.6, SAAJ 1.2 - */ + * Specifies the character type encoding for the SOAP Message. Valid values + * include "utf-8" and "utf-16". See vendor documentation for additional + * supported values. The default is "utf-8". + * + * @see SOAPMessage#setProperty(String, Object) SOAPMessage.setProperty + * @since 1.6, SAAJ 1.2 + */ public static final String CHARACTER_SET_ENCODING = "javax.xml.soap.character-set-encoding"; @@ -146,25 +147,24 @@ public abstract String getContentDescription(); /** - * Gets the SOAP part of this {@code SOAPMessage} object. - * <P> - * {@code SOAPMessage} object contains one or more attachments, the - * SOAP Part must be the first MIME body part in the message. - * - * @return the {@code SOAPPart} object for this {@code SOAPMessage} - * object - */ + * Gets the SOAP part of this {@code SOAPMessage} object. + * <p> + * {@code SOAPMessage} object contains one or more attachments, the + * SOAP Part must be the first MIME body part in the message. + * + * @return the {@code SOAPPart} object for this {@code SOAPMessage} + * object + */ public abstract SOAPPart getSOAPPart(); /** - * Gets the SOAP Body contained in this {@code SOAPMessage} object. - * - * @return the {@code SOAPBody} object contained by this {@code SOAPMessage} - * object - * @exception SOAPException - * if the SOAP Body does not exist or cannot be retrieved - * @since 1.6, SAAJ 1.2 - */ + * Gets the SOAP Body contained in this {@code SOAPMessage} object. + * + * @return the {@code SOAPBody} object contained by this {@code SOAPMessage} + * object + * @throws SOAPException if the SOAP Body does not exist or cannot be retrieved + * @since 1.6, SAAJ 1.2 + */ public SOAPBody getSOAPBody() throws SOAPException { throw new UnsupportedOperationException("getSOAPBody must be overridden by all subclasses of SOAPMessage"); } @@ -183,41 +183,40 @@ } /** - * Removes all {@code AttachmentPart} objects that have been added - * to this {@code SOAPMessage} object. - * <P> - * This method does not touch the SOAP part. - */ + * Removes all {@code AttachmentPart} objects that have been added + * to this {@code SOAPMessage} object. + * <p> + * This method does not touch the SOAP part. + */ public abstract void removeAllAttachments(); /** - * Gets a count of the number of attachments in this message. This count - * does not include the SOAP part. - * - * @return the number of {@code AttachmentPart} objects that are - * part of this {@code SOAPMessage} object - */ + * Gets a count of the number of attachments in this message. This count + * does not include the SOAP part. + * + * @return the number of {@code AttachmentPart} objects that are + * part of this {@code SOAPMessage} object + */ public abstract int countAttachments(); /** - * Retrieves all the {@code AttachmentPart} objects that are part of - * this {@code SOAPMessage} object. - * - * @return an iterator over all the attachments in this message - */ + * 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 {@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 {@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 - */ + * 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 {@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 + */ public abstract Iterator getAttachments(MimeHeaders headers); /**
--- a/src/java.xml.ws/share/classes/javax/xml/soap/SOAPPart.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/SOAPPart.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -54,9 +54,9 @@ * 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. - * <PRE> + * <pre>{@code * SOAPPart soapPart = message.getSOAPPart(); - * </PRE> + * }</pre> * <P> * A {@code SOAPPart} object contains a {@code SOAPEnvelope} object, * which in turn contains a {@code SOAPBody} object and a
--- a/src/java.xml.ws/share/classes/javax/xml/soap/Text.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/soap/Text.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,7 +26,7 @@ package javax.xml.soap; /** - * A representation of a node whose value is text. A <code>Text</code> object + * A representation of a node whose value is text. A {@code Text} object * may represent text that is content or text that is a comment. * * @since 1.6 @@ -34,10 +34,10 @@ public interface Text extends Node, org.w3c.dom.Text { /** - * Retrieves whether this <code>Text</code> object represents a comment. + * Retrieves whether this {@code Text} object represents a comment. * - * @return <code>true</code> if this <code>Text</code> object is a - * comment; <code>false</code> otherwise + * @return {@code true} if this {@code Text} object is a + * comment; {@code false} otherwise */ public boolean isComment(); }
--- a/src/java.xml.ws/share/classes/javax/xml/ws/AsyncHandler.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/AsyncHandler.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -25,7 +25,7 @@ package javax.xml.ws; -/** The <code>AsyncHandler</code> interface is implemented by +/** The {@code AsyncHandler} interface is implemented by * clients that wish to receive callback notification of the completion of * service endpoint operations invoked asynchronously. *
--- a/src/java.xml.ws/share/classes/javax/xml/ws/BindingProvider.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/BindingProvider.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -29,7 +29,7 @@ import javax.xml.ws.wsaddressing.W3CEndpointReference; /** - * The <code>BindingProvider</code> interface provides access to the + * The {@code BindingProvider} interface provides access to the * protocol binding and associated context objects for request and * response message processing. * @@ -40,14 +40,14 @@ public interface BindingProvider { /** * Standard property: User name for authentication. - * <p>Type: <code>java.lang.String</code> + * <p>Type: {@code java.lang.String} **/ public static final String USERNAME_PROPERTY = "javax.xml.ws.security.auth.username"; /** * Standard property: Password for authentication. - * <p>Type: <code>java.lang.String</code> + * <p>Type: {@code java.lang.String} **/ public static final String PASSWORD_PROPERTY = "javax.xml.ws.security.auth.password"; @@ -57,7 +57,7 @@ * URI scheme for the endpoint address specification MUST * correspond to the protocol/transport binding for the * binding in use. - * <p>Type: <code>java.lang.String</code> + * <p>Type: {@code java.lang.String} **/ public static final String ENDPOINT_ADDRESS_PROPERTY = "javax.xml.ws.service.endpoint.address"; @@ -66,10 +66,10 @@ * Standard property: This boolean property is used by a service * client to indicate whether or not it wants to participate in * a session with a service endpoint. If this property is set to - * <code>true</code>, the service client indicates that it wants the session - * to be maintained. If set to <code>false</code>, the session is not maintained. - * The default value for this property is <code>false</code>. - * <p>Type: <code>java.lang.Boolean</code> + * {@code true}, the service client indicates that it wants the session + * to be maintained. If set to {@code false}, the session is not maintained. + * The default value for this property is {@code false}. + * <p>Type: {@code java.lang.Boolean} **/ public static final String SESSION_MAINTAIN_PROPERTY = "javax.xml.ws.session.maintain"; @@ -77,29 +77,29 @@ /** * Standard property for SOAPAction. This boolean property * indicates whether or not the value of the - * <code>javax.xml.ws.soap.http.soapaction.uri</code> property + * {@code javax.xml.ws.soap.http.soapaction.uri} property * is used for the value of the SOAPAction. The - * default value of this property is <code>false</code> indicating + * default value of this property is {@code false} indicating * that the - * <code>javax.xml.ws.soap.http.soapaction.uri</code> property + * {@code javax.xml.ws.soap.http.soapaction.uri} property * is not used for the value of the SOAPAction, however, * if WS-Addressing is enabled, the default value is - * <code>true</code>. + * {@code true}. * - * <p>Type: <code>java.lang.Boolean</code> + * <p>Type: {@code java.lang.Boolean} **/ public static final String SOAPACTION_USE_PROPERTY = "javax.xml.ws.soap.http.soapaction.use"; /** * Standard property for SOAPAction. Indicates the SOAPAction - * URI if the <code>javax.xml.ws.soap.http.soapaction.use</code> - * property is set to <code>true</code>. If WS-Addressing + * URI if the {@code javax.xml.ws.soap.http.soapaction.use} + * property is set to {@code true}. If WS-Addressing * is enabled, this value will also be used for the value of the * WS-Addressing Action header. If this property is not set, * the default SOAPAction and WS-Addressing Action will be sent. * - * <p>Type: <code>java.lang.String</code> + * <p>Type: {@code java.lang.String} **/ public static final String SOAPACTION_URI_PROPERTY = "javax.xml.ws.soap.http.soapaction.uri"; @@ -139,18 +139,18 @@ /** - * Returns the <code>EndpointReference</code> associated with - * this <code>BindingProvider</code> instance. + * Returns the {@code EndpointReference} associated with + * this {@code BindingProvider} instance. * <p> - * If the Binding for this <code>bindingProvider</code> is + * If the Binding for this {@code bindingProvider} is * either SOAP1.1/HTTP or SOAP1.2/HTTP, then a - * <code>W3CEndpointReference</code> MUST be returned. + * {@code W3CEndpointReference} MUST be returned. * * @return EndpointReference of the target endpoint associated with this - * <code>BindingProvider</code> instance. + * {@code BindingProvider} instance. * * @throws java.lang.UnsupportedOperationException If this - * <code>BindingProvider</code> uses the XML/HTTP binding. + * {@code BindingProvider} uses the XML/HTTP binding. * * @see W3CEndpointReference * @@ -160,21 +160,21 @@ /** - * Returns the <code>EndpointReference</code> associated with - * this <code>BindingProvider</code> instance. The instance - * returned will be of type <code>clazz</code>. + * Returns the {@code EndpointReference} associated with + * this {@code BindingProvider} instance. The instance + * returned will be of type {@code clazz}. * - * @param clazz Specifies the type of <code>EndpointReference</code> + * @param clazz Specifies the type of {@code EndpointReference} * that MUST be returned. * @return EndpointReference of the target endpoint associated with this - * <code>BindingProvider</code> instance. MUST be of type - * <code>clazz</code>. + * {@code BindingProvider} instance. MUST be of type + * {@code clazz}. - * @throws WebServiceException If the Class <code>clazz</code> + * @throws WebServiceException If the Class {@code clazz} * is not supported by this implementation. * @throws java.lang.UnsupportedOperationException If this - * <code>BindingProvider</code> uses the XML/HTTP binding. + * {@code BindingProvider} uses the XML/HTTP binding. * * @since 1.6, JAX-WS 2.1 */
--- a/src/java.xml.ws/share/classes/javax/xml/ws/BindingType.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/BindingType.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,7 +32,7 @@ import java.lang.annotation.RetentionPolicy; /** - * The <code>BindingType</code> annotation is used to + * The {@code BindingType} annotation is used to * specify the binding to use for a web service * endpoint implementation class. * <p> @@ -50,7 +50,7 @@ * A binding identifier (a URI). * If not specified, the default is the SOAP 1.1 / HTTP binding. * <p> - * See the <code>SOAPBinding</code> and <code>HTTPBinding</code> + * See the {@code SOAPBinding} and {@code HTTPBinding} * for the definition of the standard binding identifiers. * * @see javax.xml.ws.Binding
--- a/src/java.xml.ws/share/classes/javax/xml/ws/Endpoint.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/Endpoint.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -37,23 +37,23 @@ * A Web service endpoint. * * <p>Endpoints are created using the static methods defined in this - * class. An endpoint is always tied to one <code>Binding</code> + * class. An endpoint is always tied to one {@code Binding} * and one implementor, both set at endpoint creation time. * * <p>An endpoint is either in a published or an unpublished state. - * The <code>publish</code> methods can be used to start publishing + * The {@code publish} methods can be used to start publishing * an endpoint, at which point it starts accepting incoming requests. - * Conversely, the <code>stop</code> method can be used to stop + * Conversely, the {@code stop} method can be used to stop * accepting incoming requests and take the endpoint down. * Once stopped, an endpoint cannot be published again. * - * <p>An <code>Executor</code> may be set on the endpoint in order + * <p>An {@code Executor} may be set on the endpoint in order * to gain better control over the threads used to dispatch incoming * requests. For instance, thread pooling with certain parameters - * can be enabled by creating a <code>ThreadPoolExecutor</code> and + * can be enabled by creating a {@code ThreadPoolExecutor} and * registering it with the endpoint. * - * <p>Handler chains can be set using the contained <code>Binding</code>. + * <p>Handler chains can be set using the contained {@code Binding}. * * <p>An endpoint may have a list of metadata documents, such as WSDL * and XMLSchema documents, bound to it. At publishing time, the @@ -114,8 +114,8 @@ * * @param implementor The endpoint implementor. * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the <code>features - * </code> 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. @@ -135,7 +135,7 @@ * {@link javax.xml.ws.Endpoint#publish(Object)} methods. * * @param bindingId A URI specifying the binding to use. If the bindingID is - * <code>null</code> and no binding is specified via a BindingType + * {@code null} and no binding is specified via a BindingType * annotation then a default SOAP 1.1 / HTTP binding MUST be used. * * @param implementor The endpoint implementor. @@ -156,14 +156,14 @@ * {@link javax.xml.ws.Endpoint#publish(Object)} methods. * * @param bindingId A URI specifying the binding to use. If the bindingID is - * <code>null</code> and no binding is specified via a BindingType + * {@code null} and no binding is specified via a BindingType * annotation then a default SOAP 1.1 / HTTP binding MUST be used. * * @param implementor The endpoint implementor. * * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the <code>features - * </code> 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 @@ -205,9 +205,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a <code>java.lang.SecurityManger</code> + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * <code>WebServicePermission("publishEndpoint")</code> permission. + * {@code WebServicePermission("publishEndpoint")} permission. **/ public abstract void publish(String address); @@ -231,9 +231,9 @@ * @return The newly created endpoint. * * @throws java.lang.SecurityException - * If a <code>java.lang.SecurityManger</code> + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * <code>WebServicePermission("publishEndpoint")</code> permission. + * {@code WebServicePermission("publishEndpoint")} permission. * **/ public static Endpoint publish(String address, Object implementor) { @@ -258,14 +258,14 @@ * URI schemes. * @param implementor The endpoint implementor. * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the <code>features - * </code> 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. * * @throws java.lang.SecurityException - * If a <code>java.lang.SecurityManger</code> + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * <code>WebServicePermission("publishEndpoint")</code> permission. + * {@code WebServicePermission("publishEndpoint")} permission. * @since 1.7, JAX-WS 2.2 */ public static Endpoint publish(String address, Object implementor, WebServiceFeature ... features) { @@ -294,9 +294,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a <code>java.lang.SecurityManger</code> + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * <code>WebServicePermission("publishEndpoint")</code> permission. + * {@code WebServicePermission("publishEndpoint")} permission. **/ public abstract void publish(Object serverContext); @@ -327,9 +327,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a <code>java.lang.SecurityManger</code> + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * <code>WebServicePermission("publishEndpoint")</code> permission. + * {@code WebServicePermission("publishEndpoint")} permission. * @since 1.7, JAX-WS 2.2 */ public void publish(HttpContext serverContext) { @@ -348,14 +348,14 @@ /** * Returns true if the endpoint is in the published state. * - * @return <code>true</code> if the endpoint is in the published state. + * @return {@code true} if the endpoint is in the published state. **/ public abstract boolean isPublished(); /** * Returns a list of metadata documents for the service. * - * @return <code>List<javax.xml.transform.Source></code> A list of metadata documents for the service + * @return {@code List<javax.xml.transform.Source>} A list of metadata documents for the service **/ public abstract List<javax.xml.transform.Source> getMetadata(); @@ -372,12 +372,12 @@ public abstract void setMetadata(List<javax.xml.transform.Source> metadata); /** - * Returns the executor for this <code>Endpoint</code>instance. + * Returns the executor for this {@code Endpoint}instance. * * The executor is used to dispatch an incoming request to * the implementor object. * - * @return The <code>java.util.concurrent.Executor</code> to be + * @return The {@code java.util.concurrent.Executor} to be * used to dispatch a request. * * @see java.util.concurrent.Executor @@ -385,17 +385,17 @@ public abstract java.util.concurrent.Executor getExecutor(); /** - * Sets the executor for this <code>Endpoint</code> instance. + * Sets the executor for this {@code Endpoint} instance. * * The executor is used to dispatch an incoming request to * the implementor object. * - * If this <code>Endpoint</code> is published using the - * <code>publish(Object)</code> method and the specified server + * If this {@code Endpoint} is published using the + * {@code publish(Object)} method and the specified server * context defines its own threading behavior, the executor * may be ignored. * - * @param executor The <code>java.util.concurrent.Executor</code> + * @param executor The {@code java.util.concurrent.Executor} * to be used to dispatch a request. * * @throws SecurityException If the instance does not support @@ -408,7 +408,7 @@ /** - * Returns the property bag for this <code>Endpoint</code> instance. + * Returns the property bag for this {@code Endpoint} instance. * * @return Map<String,Object> The property bag * associated with this instance. @@ -416,7 +416,7 @@ public abstract Map<String,Object> getProperties(); /** - * Sets the property bag for this <code>Endpoint</code> instance. + * Sets the property bag for this {@code Endpoint} instance. * * @param properties The property bag associated with * this instance. @@ -424,24 +424,24 @@ public abstract void setProperties(Map<String,Object> properties); /** - * Returns the <code>EndpointReference</code> associated with - * this <code>Endpoint</code> instance. + * Returns the {@code EndpointReference} associated with + * this {@code Endpoint} instance. * <p> - * If the Binding for this <code>bindingProvider</code> is + * If the Binding for this {@code bindingProvider} is * either SOAP1.1/HTTP or SOAP1.2/HTTP, then a - * <code>W3CEndpointReference</code> MUST be returned. + * {@code W3CEndpointReference} MUST be returned. * * @param referenceParameters Reference parameters to be associated with the - * returned <code>EndpointReference</code> instance. - * @return EndpointReference of this <code>Endpoint</code> instance. - * If the returned <code>EndpointReference</code> is of type - * <code>W3CEndpointReference</code> then it MUST contain the - * the specified <code>referenceParameters</code>. + * returned {@code EndpointReference} instance. + * @return EndpointReference of this {@code Endpoint} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * @throws WebServiceException If any error in the creation of - * the <code>EndpointReference</code> or if the <code>Endpoint</code> is + * the {@code EndpointReference} or if the {@code Endpoint} is * not in the published state. - * @throws UnsupportedOperationException If this <code>BindingProvider</code> + * @throws UnsupportedOperationException If this {@code BindingProvider} * uses the XML/HTTP binding. * * @see W3CEndpointReference @@ -452,23 +452,23 @@ /** - * Returns the <code>EndpointReference</code> associated with - * this <code>Endpoint</code> instance. + * Returns the {@code EndpointReference} associated with + * this {@code Endpoint} instance. * * @param clazz Specifies the type of EndpointReference that MUST be returned. * @param referenceParameters Reference parameters to be associated with the - * returned <code>EndpointReference</code> instance. - * @return EndpointReference of type <code>clazz</code> of this - * <code>Endpoint</code> instance. - * If the returned <code>EndpointReference</code> is of type - * <code>W3CEndpointReference</code> then it MUST contain the - * the specified <code>referenceParameters</code>. + * returned {@code EndpointReference} instance. + * @return EndpointReference of type {@code clazz} of this + * {@code Endpoint} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * @throws WebServiceException If any error in the creation of - * the <code>EndpointReference</code> or if the <code>Endpoint</code> is - * not in the published state or if the <code>clazz</code> is not a supported - * <code>EndpointReference</code> type. - * @throws UnsupportedOperationException If this <code>BindingProvider</code> + * the {@code EndpointReference} or if the {@code Endpoint} is + * not in the published state or if the {@code clazz} is not a supported + * {@code EndpointReference} type. + * @throws UnsupportedOperationException If this {@code BindingProvider} * uses the XML/HTTP binding. * * @@ -478,7 +478,7 @@ Element... referenceParameters); /** - * By settng a <code>EndpointContext</code>, JAX-WS runtime knows about + * By settng a {@code EndpointContext}, JAX-WS runtime knows about * addresses of other endpoints in an application. If multiple endpoints * share different ports of a WSDL, then the multiple port addresses * are patched when the WSDL is accessed.
--- a/src/java.xml.ws/share/classes/javax/xml/ws/EndpointContext.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/EndpointContext.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -25,11 +25,10 @@ package javax.xml.ws; -import javax.xml.ws.Endpoint; import java.util.Set; /** - * <code>EndpointContext</code> allows multiple endpoints in an application + * {@code EndpointContext} allows multiple endpoints in an application * to share any information. For example, servlet application's war may * contain multiple endpoints and these endpoints can get addresses of each * other by sharing this context. If multiple endpoints share different
--- a/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -44,35 +44,35 @@ * need not be concerned with its contents. The web service * developer should use this class strictly as a mechanism to * reference a remote web service endpoint. See the {@link Service} APIs - * that clients can use to that utilize an <code>EndpointReference</code>. + * that clients can use to that utilize an {@code EndpointReference}. * See the {@link javax.xml.ws.Endpoint}, and * {@link javax.xml.ws.BindingProvider} APIs on how - * <code>EndpointReferences</code> can be created for published + * {@code EndpointReferences} can be created for published * endpoints. * <p> * Concrete implementations of this class will represent - * an <code>EndpointReference</code> for a particular version of Addressing. + * an {@code EndpointReference} for a particular version of Addressing. * For example the {@link W3CEndpointReference} is for use * with W3C Web Services Addressing 1.0 - Core Recommendation. * If JAX-WS implementors need to support different versions * of addressing, they should write their own - * <code>EndpointReference</code> subclass for that version. + * {@code EndpointReference} subclass for that version. * This will allow a JAX-WS implementation to create - * a vendor specific <code>EndpointReferences</code> that the + * a vendor specific {@code EndpointReferences} that the * vendor can use to flag a different version of * addressing. * <p> * Web service developers that wish to pass or return - * <code>EndpointReference</code> in Java methods in an + * {@code EndpointReference} in Java methods in an * SEI should use - * concrete instances of an <code>EndpointReference</code> such - * as the <code>W3CEndpointReference</code>. This way the + * concrete instances of an {@code EndpointReference} such + * as the {@code W3CEndpointReference}. This way the * schema mapped from the SEI will be more descriptive of the * type of endpoint reference being passed. * <p> * JAX-WS implementors are expected to extract the XML infoset - * from an <CODE>EndpointReferece</CODE> using the - * <code>{@link EndpointReference#writeTo}</code> + * from an {@code EndpointReferece} using the + * {@link EndpointReference#writeTo} * method. * <p> * JAXB will bind this class to xs:anyType. If a better binding @@ -92,68 +92,68 @@ /** * Factory method to read an EndpointReference from the infoset contained in - * <code>eprInfoset</code>. This method delegates to the vendor specific + * {@code eprInfoset}. This method delegates to the vendor specific * implementation of the {@link javax.xml.ws.spi.Provider#readEndpointReference} method. * - * @param eprInfoset The <code>EndpointReference</code> infoset to be unmarshalled + * @param eprInfoset The {@code EndpointReference} infoset to be unmarshalled * - * @return the EndpointReference unmarshalled from <code>eprInfoset</code> - * never <code>null</code> + * @return the EndpointReference unmarshalled from {@code eprInfoset} + * never {@code null} * @throws WebServiceException * if an error occurs while creating the - * <code>EndpointReference</code> from the <CODE>eprInfoset</CODE> + * {@code EndpointReference} from the {@code eprInfoset} * @throws java.lang.IllegalArgumentException - * if the <code>null</code> <code>eprInfoset</code> value is given. + * if the {@code null} {@code eprInfoset} value is given. */ public static EndpointReference readFrom(Source eprInfoset) { return Provider.provider().readEndpointReference(eprInfoset); } /** - * write this <code>EndpointReference</code> to the specified infoset format + * write this {@code EndpointReference} to the specified infoset format * * @param result for writing infoset * @throws WebServiceException * if there is an error writing the - * <code>EndpointReference</code> to the specified <code>result</code>. + * {@code EndpointReference} to the specified {@code result}. * * @throws java.lang.IllegalArgumentException - * If the <code>null</code> <code>result</code> value is given. + * If the {@code null} {@code result} value is given. */ public abstract void writeTo(Result result); /** - * The <code>getPort</code> method returns a proxy. If there + * The {@code getPort} method returns a proxy. If there * are any reference parameters in the - * <code>EndpointReference</code> instance, then those reference + * {@code EndpointReference} instance, then those reference * parameters MUST appear as SOAP headers, indicating them to be * reference parameters, on all messages sent to the endpoint. - * The parameter <code>serviceEndpointInterface</code> specifies + * The parameter {@code serviceEndpointInterface} specifies * the service endpoint interface that is supported by the * returned proxy. - * The <code>EndpointReference</code> instance specifies the + * The {@code EndpointReference} instance 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 from this <code>EndpointReference</code> or from - * annotations on the <code>serviceEndpointInterface</code>. For this method + * the WSDL Metadata from this {@code EndpointReference} or from + * annotations on the {@code serviceEndpointInterface}. For this method * to successfully return a proxy, WSDL metadata MUST be available and the - * <code>EndpointReference</code> instance MUST contain an implementation understood - * <code>serviceName</code> metadata. + * {@code EndpointReference} instance MUST contain an implementation understood + * {@code serviceName} metadata. * <p> - * Because this port is not created from a <code>Service</code> object, handlers - * will not automatically be configured, and the <code>HandlerResolver</code> - * and <code>Executor</code> cannot be get or set for this port. The - * <code>BindingProvider().getBinding().setHandlerChain()</code> + * Because this port is not created from a {@code Service} object, handlers + * will not automatically be configured, and the {@code HandlerResolver} + * and {@code Executor} cannot be get or set for this port. The + * {@code BindingProvider().getBinding().setHandlerChain()} * method can be used to manually configure handlers for this port. * * * @param serviceEndpointInterface Service endpoint interface - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features An array of {@code WebServiceFeatures} to configure on the + * 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 @@ -163,10 +163,10 @@ * <LI>If there is any missing WSDL metadata * as required by this method * <LI>If this - * <code>endpointReference</code> + * {@code endpointReference} * is invalid * <LI>If an illegal - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified * <LI>If a feature is enabled that is not compatible with * this port or is unsupported.
--- a/src/java.xml.ws/share/classes/javax/xml/ws/Holder.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/Holder.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ import java.io.Serializable; /** - * Holds a value of type <code>T</code>. + * Holds a value of type {@code T}. * * @since 1.6, JAX-WS 2.0 */ @@ -42,7 +42,7 @@ public T value; /** - * Creates a new holder with a <code>null</code> value. + * Creates a new holder with a {@code null} value. */ public Holder() { }
--- a/src/java.xml.ws/share/classes/javax/xml/ws/LogicalMessage.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/LogicalMessage.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ import javax.xml.transform.Source; import javax.xml.bind.JAXBContext; -/** The <code>LogicalMessage</code> interface represents a +/** The {@code LogicalMessage} interface represents a * protocol agnostic XML message and contains methods that * provide access to the payload of the message. * @@ -38,17 +38,17 @@ /** Gets the message payload as an XML source, may be called * multiple times on the same LogicalMessage instance, always - * returns a new <code>Source</code> that may be used to retrieve the entire + * returns a new {@code Source} that may be used to retrieve the entire * message payload. * - * <p>If the returned <code>Source</code> is an instance of - * <code>DOMSource</code>, then + * <p>If the returned {@code Source} is an instance of + * {@code DOMSource}, then * modifications to the encapsulated DOM tree change the message * payload in-place, there is no need to susequently call - * <code>setPayload</code>. Other types of <code>Source</code> provide only + * {@code setPayload}. Other types of {@code Source} provide only * read access to the message payload. * - * @return The contained message payload; returns <code>null</code> if no + * @return The contained message payload; returns {@code null} if no * payload is present in this message. **/ public Source getPayload(); @@ -65,11 +65,11 @@ /** Gets the message payload as a JAXB object. Note that there is no * connection between the returned object and the message payload, - * changes to the payload require calling <code>setPayload</code>. + * changes to the payload require calling {@code setPayload}. * * @param context The JAXBContext that should be used to unmarshall * the message payload - * @return The contained message payload; returns <code>null</code> if no + * @return The contained message payload; returns {@code null} if no * payload is present in this message * @throws WebServiceException If an error occurs when using a supplied * JAXBContext to unmarshall the payload. The cause of
--- a/src/java.xml.ws/share/classes/javax/xml/ws/ProtocolException.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/ProtocolException.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -25,7 +25,7 @@ package javax.xml.ws; -/** The <code>ProtocolException</code> class is a +/** The {@code ProtocolException} class is a * base class for exceptions related to a specific protocol binding. Subclasses * are used to communicate protocol level fault information to clients and may * be used on the server to control the protocol specific fault representation. @@ -34,9 +34,9 @@ **/ public class ProtocolException extends WebServiceException { /** - * Constructs a new protocol exception with <code>null</code> as its detail message. The + * Constructs a new protocol exception with {@code null} as its detail message. The * cause is not initialized, and may subsequently be initialized by a call - * to <code>Throwable.initCause(java.lang.Throwable)</code>. + * to {@code Throwable.initCause(java.lang.Throwable)}. */ public ProtocolException() { super(); @@ -45,7 +45,7 @@ /** * Constructs a new protocol exception with the specified detail message. * The cause is not initialized, and may subsequently be initialized by a - * call to <code>Throwable.initCause(java.lang.Throwable)</code>. + * call to {@code Throwable.initCause(java.lang.Throwable)}. * * @param message the detail message. The detail message is saved for later * retrieval by the Throwable.getMessage() method. @@ -64,7 +64,7 @@ * @param message the detail message (which is saved for later retrieval by * the Throwable.getMessage() method). * @param cause the cause (which is saved for later retrieval by the - * <code>Throwable.getCause()</code> method). (A <code>null</code> value is permitted, and indicates + * {@code Throwable.getCause()} method). (A {@code null} value is permitted, and indicates * that the cause is nonexistent or unknown.) */ public ProtocolException(String message, Throwable cause) { @@ -73,13 +73,13 @@ /** * Constructs a new runtime exception with the specified cause and a detail - * message of <code>(cause==null ? null : cause.toString())</code> (which typically + * message of {@code (cause==null ? null : cause.toString())} (which typically * contains the class and detail message of cause). This constructor is * useful for runtime exceptions that are little more than wrappers for * other throwables. * * @param cause the cause (which is saved for later retrieval by the - * <code>Throwable.getCause()</code> method). (A <code>null</code> value is permitted, and indicates + * {@code Throwable.getCause()} method). (A {@code null} value is permitted, and indicates * that the cause is nonexistent or unknown.) */ public ProtocolException(Throwable cause) {
--- a/src/java.xml.ws/share/classes/javax/xml/ws/Provider.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/Provider.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,16 +26,16 @@ package javax.xml.ws; /** - * <p>Service endpoints may implement the <code>Provider</code> + * <p>Service endpoints may implement the {@code Provider} * interface as a dynamic alternative to an SEI. * - * <p>Implementations are required to support <code>Provider<Source></code>, - * <code>Provider<SOAPMessage></code> and - * <code>Provider<DataSource></code>, depending on the binding + * <p>Implementations are required to support {@code Provider<Source>}, + * {@code Provider<SOAPMessage>} and + * {@code Provider<DataSource>}, depending on the binding * in use and the service mode. * - * <p>The <code>ServiceMode</code> annotation can be used to control whether - * the <code>Provider</code> instance will receive entire protocol messages + * <p>The {@code ServiceMode} annotation can be used to control whether + * the {@code Provider} instance will receive entire protocol messages * or just message payloads. * * @since 1.6, JAX-WS 2.0 @@ -50,11 +50,11 @@ * message. * * @param request The request message or message payload. - * @return The response message or message payload. May be <code>null</code> if + * @return The response message or message payload. May be {@code null} if there is no response. * @throws WebServiceException If there is an error processing request. - * The cause of the <code>WebServiceException</code> may be set to a subclass - * of <code>ProtocolException</code> to control the protocol level + * The cause of the {@code WebServiceException} may be set to a subclass + * of {@code ProtocolException} to control the protocol level * representation of the exception. * @see javax.xml.ws.handler.MessageContext * @see javax.xml.ws.ProtocolException
--- a/src/java.xml.ws/share/classes/javax/xml/ws/RequestWrapper.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/RequestWrapper.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -33,11 +33,11 @@ /** * Used to annotate methods in the Service Endpoint Interface with the request - * wrapper bean to be used at runtime. The default value of the <code>localName</code> is - * the <code>operationName</code>, as defined in <code>WebMethod</code> annotation and the - * <code>targetNamespace</code> is the target namespace of the SEI. + * wrapper bean to be used at runtime. The default value of the {@code localName} is + * the {@code operationName}, as defined in {@code WebMethod} annotation and the + * {@code targetNamespace} is the target namespace of the SEI. * <p> When starting from Java this annotation is used resolve - * overloading conflicts in document literal mode. Only the <code>className</code> + * overloading conflicts in document literal mode. Only the {@code className} * is required in this case. * * @since 1.6, JAX-WS 2.0
--- a/src/java.xml.ws/share/classes/javax/xml/ws/RespectBinding.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/RespectBinding.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,18 +34,18 @@ /** - * This feature clarifies the use of the <code>wsdl:binding</code> + * This feature clarifies the use of the {@code wsdl:binding} * in a JAX-WS runtime. * <p> * This annotation MUST only be used in conjunction the - * <code>javax.jws.WebService</code>, {@link WebServiceProvider}, + * {@code javax.jws.WebService}, {@link WebServiceProvider}, * {@link WebServiceRef} annotations. - * When used with the <code>javax.jws.WebService</code> 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 <code>WebServiceRef</code> 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 <code>RespectBinding</code> + * proxy, and endpoint MUST honor the values of the {@code RespectBinding} * annotation. * <p> *
--- a/src/java.xml.ws/share/classes/javax/xml/ws/RespectBindingFeature.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/RespectBindingFeature.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ import javax.xml.ws.soap.AddressingFeature; /** - * This feature clarifies the use of the <code>wsdl:binding</code> + * This feature clarifies the use of the {@code wsdl:binding} * in a JAX-WS runtime. * * This feature can be used during the creation of SEI proxy, and @@ -38,26 +38,26 @@ * <p> * This feature is only useful with web services that have an * associated WSDL. Enabling this feature requires that a JAX-WS - * implementation inspect the <code>wsdl:binding</code> for an - * endpoint at runtime to make sure that all <code>wsdl:extensions</code> - * that have the <code>required</code> attribute set to <code>true</code> + * implementation inspect the {@code wsdl:binding} for an + * endpoint at runtime to make sure that all {@code wsdl:extensions} + * that have the {@code required} attribute set to {@code true} * are understood and are being used. * <p> * The following describes the affects of this feature with respect * to be enabled or disabled: * <ul> * <li> ENABLED: In this Mode, a JAX-WS runtime MUST assure that all - * required <code>wsdl:binding</code> extensions(including policies) are + * required {@code wsdl:binding} extensions(including policies) are * either understood and used by the runtime, or explicitly disabled by the * web service application. A web service can disable a particular * extension if there is a corresponding {@link WebServiceFeature} or annotation. * Similarly, a web service client can disable - * particular extension using the corresponding <code>WebServiceFeature</code> while + * particular extension using the corresponding {@code WebServiceFeature} while * creating a proxy or Dispatch instance. * The runtime MUST also make sure that binding of - * SEI parameters/return values respect the <code>wsdl:binding</code>. - * With this feature enabled, if a required (<code>wsdl:required="true"</code>) - * <code>wsdl:binding</code> extension is in the WSDL and it is not + * SEI parameters/return values respect the {@code wsdl:binding}. + * With this feature enabled, if a required ({@code wsdl:required="true"}) + * {@code wsdl:binding} extension is in the WSDL and it is not * supported by a JAX-WS runtime and it has not * been explicitly turned off by the web service developer, then * that JAX-WS runtime MUST behave appropriately based on whether it is @@ -71,8 +71,8 @@ * </ul> * * <li> DISABLED: In this Mode, an implementation may choose whether - * to inspect the <code>wsdl:binding</code> or not and to what degree - * the <code>wsdl:binding</code> will be inspected. For example, + * to inspect the {@code wsdl:binding} or not and to what degree + * the {@code wsdl:binding} will be inspected. For example, * one implementation may choose to behave as if this feature is enabled, * another implementation may only choose to verify the SEI's * parameter/return type bindings. @@ -91,7 +91,7 @@ /** - * Creates an <code>RespectBindingFeature</code>. + * Creates an {@code RespectBindingFeature}. * The instance created will be enabled. */ public RespectBindingFeature() {
--- a/src/java.xml.ws/share/classes/javax/xml/ws/Response.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/Response.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,14 +28,14 @@ import java.util.Map; import java.util.concurrent.Future; -/** The <code>Response</code> interface provides methods used to obtain the +/** The {@code Response} interface provides methods used to obtain the * payload and context of a message sent in response to an operation * invocation. * * <p>For asynchronous operation invocations it provides additional methods - * to check the status of the request. The <code>get(...)</code> methods may + * to check the status of the request. The {@code get(...)} methods may * throw the standard - * set of exceptions and their cause may be a <code>RemoteException</code> or a + * set of exceptions and their cause may be a {@code RemoteException} or a * {@link WebServiceException} that represents the error that occured during the * asynchronous method invocation.</p> * @@ -44,7 +44,7 @@ public interface Response<T> extends Future<T> { /** Gets the contained response context. * - * @return The contained response context. May be <code>null</code> if a + * @return The contained response context. May be {@code null} if a * response is not yet available. * **/
--- a/src/java.xml.ws/share/classes/javax/xml/ws/ResponseWrapper.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/ResponseWrapper.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,11 +32,11 @@ import java.lang.annotation.RetentionPolicy; /** * Used to annotate methods in the Service Endpoint Interface with the response - * wrapper bean to be used at runtime. The default value of the <code>localName</code> is - * the <code>operationName</code> as defined in <code>WebMethod</code> annotation appended with - * <code>Response</code> and the <code>targetNamespace</code> is the target namespace of the SEI. + * wrapper bean to be used at runtime. The default value of the {@code localName} is + * the {@code operationName} as defined in {@code WebMethod} annotation appended with + * {@code Response} and the {@code targetNamespace} is the target namespace of the SEI. * <p> When starting from Java this annotation is used resolve - * overloading conflicts in document literal mode. Only the <code>className</code> + * overloading conflicts in document literal mode. Only the {@code className} * is required in this case. * * @since 1.6, JAX-WS 2.0
--- a/src/java.xml.ws/share/classes/javax/xml/ws/Service.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/Service.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -33,8 +33,8 @@ import javax.xml.ws.spi.Provider; /** - * <code>Service</code> objects provide the client view of a Web service. - * <p><code>Service</code> acts as a factory of the following: + * {@code Service} objects provide the client view of a Web service. + * <p>{@code Service} acts as a factory of the following: * <ul> * <li>Proxies for a target service endpoint.</li> * <li>Instances of {@link javax.xml.ws.Dispatch} for @@ -44,17 +44,17 @@ * </ul> * * <p>The ports available on a service can be enumerated using the - * <code>getPorts</code> method. Alternatively, you can pass a - * service endpoint interface to the unary <code>getPort</code> method + * {@code getPorts} method. Alternatively, you can pass a + * service endpoint interface to the unary {@code getPort} method * and let the runtime select a compatible port. * - * <p>Handler chains for all the objects created by a <code>Service</code> - * can be set by means of a <code>HandlerResolver</code>. + * <p>Handler chains for all the objects created by a {@code Service} + * can be set by means of a {@code HandlerResolver}. * - * <p>An <code>Executor</code> may be set on the service in order + * <p>An {@code Executor} may be set on the service in order * to gain better control over the threads used to dispatch asynchronous * callbacks. For instance, thread pooling with certain parameters - * can be enabled by creating a <code>ThreadPoolExecutor</code> and + * can be enabled by creating a {@code ThreadPoolExecutor} and * registering it with the service. * * @since 1.6, JAX-WS 2.0 @@ -67,8 +67,8 @@ private ServiceDelegate delegate; /** - * The orientation of a dynamic client or service. <code>MESSAGE</code> provides - * access to entire protocol message, <code>PAYLOAD</code> to protocol message + * The orientation of a dynamic client or service. {@code MESSAGE} provides + * access to entire protocol message, {@code PAYLOAD} to protocol message * payload only. **/ public enum Mode { MESSAGE, PAYLOAD } @@ -87,9 +87,9 @@ /** - * The <code>getPort</code> method returns a proxy. A service client + * The {@code getPort} method returns a proxy. A service client * uses this proxy to invoke operations on the target - * service endpoint. The <code>serviceEndpointInterface</code> + * service endpoint. The {@code serviceEndpointInterface} * specifies the service endpoint interface that is supported by * the created dynamic proxy instance. * @@ -108,8 +108,8 @@ * <LI>If there is any missing WSDL metadata * as required by this method. * <LI>If an illegal - * <code>serviceEndpointInterface</code> - * or <code>portName</code> is specified. + * {@code serviceEndpointInterface} + * or {@code portName} is specified. * </UL> * @see java.lang.reflect.Proxy * @see java.lang.reflect.InvocationHandler @@ -120,9 +120,9 @@ } /** - * The <code>getPort</code> method returns a proxy. A service client + * The {@code getPort} method returns a proxy. A service client * uses this proxy to invoke operations on the target - * service endpoint. The <code>serviceEndpointInterface</code> + * service endpoint. The {@code serviceEndpointInterface} * specifies the service endpoint interface that is supported by * the created dynamic proxy instance. * @@ -131,8 +131,8 @@ * @param serviceEndpointInterface Service endpoint interface * supported by the dynamic proxy instance. * @param features A list of WebServiceFeatures to configure on the - * proxy. Supported features not in the <code>features - * </code> 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. @@ -144,8 +144,8 @@ * <LI>If there is any missing WSDL metadata * as required by this method. * <LI>If an illegal - * <code>serviceEndpointInterface</code> - * or <code>portName</code> is specified. + * {@code serviceEndpointInterface} + * or {@code portName} is specified. * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. * </UL> @@ -162,8 +162,8 @@ /** - * The <code>getPort</code> method returns a proxy. The parameter - * <code>serviceEndpointInterface</code> specifies the service + * The {@code getPort} method returns a proxy. The parameter + * {@code serviceEndpointInterface} specifies the service * endpoint interface that is supported by the returned proxy. * In the implementation of this method, the JAX-WS * runtime system takes the responsibility of selecting a protocol @@ -180,7 +180,7 @@ * <LI>If there is any missing WSDL metadata * as required by this method. * <LI>If an illegal - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified. * </UL> **/ @@ -190,8 +190,8 @@ /** - * The <code>getPort</code> method returns a proxy. The parameter - * <code>serviceEndpointInterface</code> specifies the service + * The {@code getPort} method returns a proxy. The parameter + * {@code serviceEndpointInterface} specifies the service * endpoint interface that is supported by the returned proxy. * In the implementation of this method, the JAX-WS * runtime system takes the responsibility of selecting a protocol @@ -200,8 +200,8 @@ * * @param serviceEndpointInterface Service endpoint interface. * @param features A list of WebServiceFeatures to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * @return Object instance that supports the * specified service endpoint interface. * @throws WebServiceException @@ -211,7 +211,7 @@ * <LI>If there is any missing WSDL metadata * as required by this method. * <LI>If an illegal - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified. * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. @@ -228,31 +228,31 @@ /** - * The <code>getPort</code> method returns a proxy. - * The parameter <code>endpointReference</code> specifies the + * The {@code getPort} method returns a proxy. + * The parameter {@code endpointReference} specifies the * endpoint that will be invoked by the returned proxy. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. - * The parameter <code>serviceEndpointInterface</code> specifies + * The parameter {@code serviceEndpointInterface} specifies * the service endpoint interface that is supported 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 associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> metadata + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} metadata * also has a WSDL, then the WSDL from this instance MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. * The returned proxy should not be reconfigured by the client. - * If this <code>Service</code> instance has a known proxy + * If this {@code Service} instance has a known proxy * port that matches the information contained in * the WSDL, * then that proxy is returned, otherwise a WebServiceException @@ -260,20 +260,20 @@ * <p> * Calling this method has the same behavior as the following * <pre> - * <code>port = service.getPort(portName, serviceEndpointInterface);</code> + * {@code port = service.getPort(portName, serviceEndpointInterface);} * </pre> - * where the <code>portName</code> is retrieved from the - * metadata of the <code>endpointReference</code> or from the - * <code>serviceEndpointInterface</code> and the WSDL - * associated with this <code>Service</code> instance. + * where the {@code portName} is retrieved from the + * metadata of the {@code endpointReference} or from the + * {@code serviceEndpointInterface} and the WSDL + * associated with this {@code Service} instance. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the * returned proxy. * @param serviceEndpointInterface Service endpoint interface. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features A list of {@code WebServiceFeatures} to configure on the + * 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 @@ -282,16 +282,16 @@ * of the proxy. * <LI>If there is any missing WSDL metadata * as required by this method. - * <LI>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> of this - * <code>Service</code> instance. - * <LI>If a <code>portName</code> cannot be extracted - * from the WSDL or <code>endpointReference</code> metadata. + * <LI>If the {@code endpointReference} metadata does + * not match the {@code serviceName} of this + * {@code Service} instance. + * <LI>If a {@code portName} cannot be extracted + * from the WSDL or {@code endpointReference} metadata. * <LI>If an invalid - * <code>endpointReference</code> + * {@code endpointReference} * is specified. * <LI>If an invalid - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified. * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. @@ -307,7 +307,7 @@ /** * Creates a new port for the service. Ports created in this way contain * no WSDL port type information and can only be used for creating - * <code>Dispatch</code>instances. + * {@code Dispatch}instances. * * @param portName Qualified name for the target service endpoint. * @param bindingId A String identifier of a binding. @@ -325,14 +325,14 @@ /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the client's choosing. * * @param portName Qualified name for the target service endpoint * @param type The class of object used for messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code>, <code>javax.xml.soap.SOAPMessage</code> - * and <code>javax.activation.DataSource</code>, depending on + * {@code javax.xml.transform.Source}, {@code javax.xml.soap.SOAPMessage} + * and {@code javax.activation.DataSource}, depending on * the binding in use. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the client will work with complete @@ -343,7 +343,7 @@ * * @return Dispatch instance. * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * * @see javax.xml.transform.Source * @see javax.xml.soap.SOAPMessage @@ -354,26 +354,26 @@ /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the client's choosing. * * @param portName Qualified name for the target service endpoint * @param type The class of object used for messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code> and <code>javax.xml.soap.SOAPMessage</code>. + * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the client will work with complete * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the client will work with - * SOAP messages or the contents of a SOAP body. Mode MUST be <code>MESSAGE</code> - * when type is <code>SOAPMessage</code>. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * SOAP messages or the contents of a SOAP body. Mode MUST be {@code MESSAGE} + * when type is {@code SOAPMessage}. + * @param features A list of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance. * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object or if a + * the {@code Dispatch} object or if a * feature is enabled that is not compatible with * this port or is unsupported. * @@ -390,64 +390,64 @@ /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the client's choosing. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. * 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 dispatch accordingly from - * the WSDL associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} * also has a WSDL in its metadata, then the WSDL from this instance MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. - * An implementation MUST be able to retrieve the <code>portName</code> from the - * <code>endpointReference</code> metadata. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. + * An implementation MUST be able to retrieve the {@code portName} from the + * {@code endpointReference} metadata. * <p> * This method behaves the same as calling * <pre> - * <code>dispatch = service.createDispatch(portName, type, mode, features);</code> + * {@code dispatch = service.createDispatch(portName, type, mode, features);} * </pre> - * where the <code>portName</code> is retrieved from the - * WSDL or <code>EndpointReference</code> metadata. + * where the {@code portName} is retrieved from the + * WSDL or {@code EndpointReference} metadata. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the - * returned <code>Dispatch</code> object. + * returned {@code Dispatch} object. * @param type The class of object used to messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code> and <code>javax.xml.soap.SOAPMessage</code>. + * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the client will work with complete * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the client will work with - * SOAP messages or the contents of a SOAP body. Mode MUST be <code>MESSAGE</code> - * when type is <code>SOAPMessage</code>. - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * SOAP messages or the contents of a SOAP body. Mode MUST be {@code MESSAGE} + * when type is {@code SOAPMessage}. + * @param features An array of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException * <UL> * <LI>If there is any missing WSDL metadata * as required by this method. - * <li>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> or <code>portName</code> + * <li>If the {@code endpointReference} metadata does + * not match the {@code serviceName} or {@code portName} * of a WSDL associated - * with this <code>Service</code> instance. - * <li>If the <code>portName</code> cannot be determined - * from the <code>EndpointReference</code> metadata. + * with this {@code Service} instance. + * <li>If the {@code portName} cannot be determined + * from the {@code EndpointReference} metadata. * <li>If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * <li>If a feature is enabled that is not * compatible with this port or is unsupported. * </UL> @@ -465,7 +465,7 @@ } /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. * * @param portName Qualified name for the target service endpoint @@ -479,7 +479,7 @@ * * @return Dispatch instance. * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * * @see javax.xml.bind.JAXBContext **/ @@ -490,7 +490,7 @@ /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. * * @param portName Qualified name for the target service endpoint @@ -501,13 +501,13 @@ * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the client will work with * SOAP messages or the contents of a SOAP body. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features A list of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance. * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object or if a + * the {@code Dispatch} object or if a * feature is enabled that is not compatible with * this port or is unsupported. * @@ -523,39 +523,39 @@ /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. * 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 dispatch accordingly from - * the WSDL associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} * also has a WSDL in its metadata, then the WSDL from this instance * MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. - * An implementation MUST be able to retrieve the <code>portName</code> from the - * <code>endpointReference</code> metadata. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. + * An implementation MUST be able to retrieve the {@code portName} from the + * {@code endpointReference} metadata. * <p> * This method behavies the same as calling * <pre> - * <code>dispatch = service.createDispatch(portName, context, mode, features);</code> + * {@code dispatch = service.createDispatch(portName, context, mode, features);} * </pre> - * where the <code>portName</code> is retrieved from the - * WSDL or <code>endpointReference</code> metadata. + * where the {@code portName} is retrieved from the + * WSDL or {@code endpointReference} metadata. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the - * returned <code>Dispatch</code> object. + * returned {@code Dispatch} object. * @param context The JAXB context used to marshall and unmarshall * messages or message payloads. * @param mode Controls whether the created dispatch instance is message @@ -563,23 +563,23 @@ * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the client will work with * SOAP messages or the contents of a SOAP body. - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features An array of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException * <UL> * <li>If there is any missing WSDL metadata * as required by this method. - * <li>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> or <code>portName</code> + * <li>If the {@code endpointReference} metadata does + * not match the {@code serviceName} or {@code portName} * of a WSDL associated - * with this <code>Service</code> instance. - * <li>If the <code>portName</code> cannot be determined - * from the <code>EndpointReference</code> metadata. + * with this {@code Service} instance. + * <li>If the {@code portName} cannot be determined + * from the {@code EndpointReference} metadata. * <li>If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * <li>if a feature is enabled that is not * compatible with this port or is unsupported. * </UL> @@ -604,12 +604,12 @@ } /** - * Returns an <code>Iterator</code> for the list of - * <code>QName</code>s of service endpoints grouped by this + * Returns an {@code Iterator} for the list of + * {@code QName}s of service endpoints grouped by this * service * - * @return Returns <code>java.util.Iterator</code> with elements - * of type <code>javax.xml.namespace.QName</code>. + * @return Returns {@code java.util.Iterator} with elements + * of type {@code javax.xml.namespace.QName}. * @throws WebServiceException If this Service class does not * have access to the required WSDL metadata. **/ @@ -630,8 +630,8 @@ /** * Returns the configured handler resolver. * - * @return HandlerResolver The <code>HandlerResolver</code> being - * used by this <code>Service</code> instance, or <code>null</code> + * @return HandlerResolver The {@code HandlerResolver} being + * used by this {@code Service} instance, or {@code null} * if there isn't one. **/ public HandlerResolver getHandlerResolver() { @@ -639,14 +639,14 @@ } /** - * Sets the <code>HandlerResolver</code> for this <code>Service</code> + * Sets the {@code HandlerResolver} for this {@code Service} * instance. * <p> * The handler resolver, if present, will be called once for each * proxy or dispatch instance that is created, and the handler chain * returned by the resolver will be set on the instance. * - * @param handlerResolver The <code>HandlerResolver</code> to use + * @param handlerResolver The {@code HandlerResolver} to use * for all subsequently created proxy/dispatch objects. * * @see javax.xml.ws.handler.HandlerResolver @@ -656,12 +656,12 @@ } /** - * Returns the executor for this <code>Service</code>instance. + * Returns the executor for this {@code Service}instance. * * The executor is used for all asynchronous invocations that * require callbacks. * - * @return The <code>java.util.concurrent.Executor</code> to be + * @return The {@code java.util.concurrent.Executor} to be * used to invoke a callback. * * @see java.util.concurrent.Executor @@ -671,12 +671,12 @@ } /** - * Sets the executor for this <code>Service</code> instance. + * Sets the executor for this {@code Service} instance. * * The executor is used for all asynchronous invocations that * require callbacks. * - * @param executor The <code>java.util.concurrent.Executor</code> + * @param executor The {@code java.util.concurrent.Executor} * to be used to invoke a callback. * * @throws SecurityException If the instance does not support @@ -690,14 +690,14 @@ } /** - * Creates a <code>Service</code> instance. + * Creates a {@code Service} instance. * * The specified WSDL document location and service qualified name MUST - * uniquely identify a <code>wsdl:service</code> element. + * uniquely identify a {@code wsdl:service} element. * - * @param wsdlDocumentLocation <code>URL</code> for the WSDL document location + * @param wsdlDocumentLocation {@code URL} for the WSDL document location * for the service - * @param serviceName <code>QName</code> for the service + * @param serviceName {@code QName} for the service * @throws WebServiceException If any error in creation of the * specified service. **/ @@ -708,15 +708,15 @@ } /** - * Creates a <code>Service</code> instance. The created instance is + * Creates a {@code Service} instance. The created instance is * configured with the web service features. * * The specified WSDL document location and service qualified name MUST - * uniquely identify a <code>wsdl:service</code> element. + * uniquely identify a {@code wsdl:service} element. * - * @param wsdlDocumentLocation <code>URL</code> for the WSDL document location + * @param wsdlDocumentLocation {@code URL} for the WSDL document location * for the service - * @param serviceName <code>QName</code> for the service + * @param serviceName {@code QName} for the service * @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. @@ -731,9 +731,9 @@ } /** - * Creates a <code>Service</code> instance. + * Creates a {@code Service} instance. * - * @param serviceName <code>QName</code> for the service + * @param serviceName {@code QName} for the service * @throws WebServiceException If any error in creation of the * specified service */ @@ -742,10 +742,10 @@ } /** - * Creates a <code>Service</code> instance. The created instance is + * Creates a {@code Service} instance. The created instance is * configured with the web service features. * - * @param serviceName <code>QName</code> for the service + * @param serviceName {@code QName} for the service * @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.
--- a/src/java.xml.ws/share/classes/javax/xml/ws/ServiceMode.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/ServiceMode.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -44,9 +44,9 @@ @Documented public @interface ServiceMode { /** - * Service mode. <code>PAYLOAD</code> indicates that the <code>Provider</code> implementation - * wishes to work with protocol message payloads only. <code>MESSAGE</code> indicates - * that the <code>Provider</code> implementation wishes to work with entire protocol + * Service mode. {@code PAYLOAD} indicates that the {@code Provider} implementation + * wishes to work with protocol message payloads only. {@code MESSAGE} indicates + * that the {@code Provider} implementation wishes to work with entire protocol * messages. **/ public Service.Mode value() default Service.Mode.PAYLOAD;
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebEndpoint.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebEndpoint.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -36,9 +36,9 @@ * methods of a generated service interface. * * <p>The information specified in this annotation is sufficient - * to uniquely identify a <code>wsdl:port</code> element - * inside a <code>wsdl:service</code>. The latter is - * determined based on the value of the <code>WebServiceClient</code> + * to uniquely identify a {@code wsdl:port} element + * inside a {@code wsdl:service}. The latter is + * determined based on the value of the {@code WebServiceClient} * annotation on the generated service interface itself. * * @since 1.6, JAX-WS 2.0
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceClient.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceClient.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -35,8 +35,8 @@ * Used to annotate a generated service interface. * * <p>The information specified in this annotation is sufficient - * to uniquely identify a <code>wsdl:service</code> - * element inside a WSDL document. This <code>wsdl:service</code> + * to uniquely identify a {@code wsdl:service} + * element inside a WSDL document. This {@code wsdl:service} * element represents the Web service for which the generated * service interface provides a client view. *
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceContext.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceContext.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,14 +32,14 @@ /** - * A <code>WebServiceContext</code> makes it possible for + * A {@code WebServiceContext} makes it possible for * a web service endpoint implementation class to access * message context and security information relative to * a request being served. * - * Typically a <code>WebServiceContext</code> is injected + * Typically a {@code WebServiceContext} is injected * into an endpoint implementation class using the - * <code>Resource</code> annotation. + * {@code Resource} annotation. * * @since 1.6, JAX-WS 2.0 * @@ -48,7 +48,7 @@ public interface WebServiceContext { /** - * Returns the <code>MessageContext</code> for the request being served + * Returns the {@code MessageContext} for the request being served * at the time this method is called. Only properties with * APPLICATION scope will be visible to the application. * @@ -68,7 +68,7 @@ * Returns the Principal that identifies the sender * of the request currently being serviced. If the * sender has not been authenticated, the method - * returns <code>null</code>. + * returns {@code null}. * * @return Principal The principal object. * @@ -85,11 +85,11 @@ * Returns a boolean indicating whether the * authenticated user is included in the specified * logical role. If the user has not been - * authenticated, the method returns <code>false</code>. + * authenticated, the method returns {@code false}. * - * @param role A <code>String</code> specifying the name of the role + * @param role A {@code String} specifying the name of the role * - * @return a <code>boolean</code> indicating whether + * @return a {@code boolean} indicating whether * the sender of the request belongs to a given role * * @throws IllegalStateException This exception is thrown @@ -99,20 +99,20 @@ public boolean isUserInRole(String role); /** - * Returns the <code>EndpointReference</code> for this + * Returns the {@code EndpointReference} for this * endpoint. * <p> - * If the {@link Binding} for this <code>bindingProvider</code> is + * If the {@link Binding} for this {@code bindingProvider} is * either SOAP1.1/HTTP or SOAP1.2/HTTP, then a - * <code>W3CEndpointReference</code> MUST be returned. + * {@code W3CEndpointReference} MUST be returned. * * @param referenceParameters Reference parameters to be associated with the - * returned <code>EndpointReference</code> instance. + * returned {@code EndpointReference} instance. * @return EndpointReference of the endpoint associated with this - * <code>WebServiceContext</code>. - * If the returned <code>EndpointReference</code> is of type - * <code>W3CEndpointReference</code> then it MUST contain the - * the specified <code>referenceParameters</code>. + * {@code WebServiceContext}. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * * @throws IllegalStateException This exception is thrown * if the method is called while no request is @@ -125,24 +125,24 @@ public EndpointReference getEndpointReference(Element... referenceParameters); /** - * Returns the <code>EndpointReference</code> associated with + * Returns the {@code EndpointReference} associated with * this endpoint. * - * @param clazz The type of <code>EndpointReference</code> that + * @param clazz The type of {@code EndpointReference} that * MUST be returned. * @param referenceParameters Reference parameters to be associated with the - * returned <code>EndpointReference</code> instance. - * @return EndpointReference of type <code>clazz</code> of the endpoint - * associated with this <code>WebServiceContext</code> instance. - * If the returned <code>EndpointReference</code> is of type - * <code>W3CEndpointReference</code> then it MUST contain the - * the specified <code>referenceParameters</code>. + * returned {@code EndpointReference} instance. + * @return EndpointReference of type {@code clazz} of the endpoint + * associated with this {@code WebServiceContext} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * * @throws IllegalStateException This exception is thrown * if the method is called while no request is * being serviced. - * @throws WebServiceException If the <code>clazz</code> type of - * <code>EndpointReference</code> is not supported. + * @throws WebServiceException If the {@code clazz} type of + * {@code EndpointReference} is not supported. * * @since 1.6, JAX-WS 2.1 **/
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceException.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceException.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -25,7 +25,7 @@ package javax.xml.ws; -/** The <code>WebServiceException</code> class is the base +/** The {@code WebServiceException} class is the base * exception class for all JAX-WS API runtime exceptions. * * @since 1.6, JAX-WS 2.0 @@ -33,7 +33,7 @@ public class WebServiceException extends java.lang.RuntimeException { - /** Constructs a new exception with <code>null</code> as its + /** Constructs a new exception with {@code null} as its * detail message. The cause is not initialized. **/ public WebServiceException() {
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceFeature.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceFeature.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,7 +34,7 @@ * JAX-WS implementors are free to define additional features if * necessary. Vendor specific features may not be portable so * caution should be used when using them. Each Feature definition - * MUST define a <code>public static final String ID</code> + * MUST define a {@code public static final String ID} * that can be used in the Feature annotation to refer * to the feature. This ID MUST be unique across all features * of all vendors. When defining a vendor specific feature ID, @@ -71,9 +71,9 @@ /** - * Returns <code>true</code> if this feature is enabled. + * Returns {@code true} if this feature is enabled. * - * @return <code>true</code> if and only if the feature is enabled . + * @return {@code true} if and only if the feature is enabled . */ public boolean isEnabled() { return enabled;
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRef.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRef.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,7 +34,7 @@ import java.lang.annotation.RetentionPolicy; /** - * The <code>WebServiceRef</code> annotation is used to + * The {@code WebServiceRef} annotation is used to * define a reference to a web service and * (optionally) an injection target for it. * It can be used to inject both service and proxy @@ -47,21 +47,21 @@ * Web service references are resources in the Java EE 5 sense. * The annotations (for example, {@link Addressing}) annotated with * meta-annotation {@link WebServiceFeatureAnnotation} - * can be used in conjunction with <code>WebServiceRef</code>. + * can be used in conjunction with {@code WebServiceRef}. * The created reference MUST be configured with annotation's web service * feature. * * <p> * For example, in the code below, the injected - * <code>StockQuoteProvider</code> proxy MUST + * {@code StockQuoteProvider} proxy MUST * have WS-Addressing enabled as specifed by the * {@link Addressing} * annotation. * * <pre><code> * public class MyClient { - * @Addressing - * @WebServiceRef(StockQuoteService.class) + * {@literal @}Addressing + * {@literal @}WebServiceRef(StockQuoteService.class) * private StockQuoteProvider stockQuoteProvider; * ... * } @@ -69,8 +69,8 @@ * * <p> * If a JAX-WS implementation encounters an unsupported or unrecognized - * annotation annotated with the <code>WebServiceFeatureAnnotation</code> - * that is specified with <code>WebServiceRef</code>, an ERROR MUST be given. + * annotation annotated with the {@code WebServiceFeatureAnnotation} + * that is specified with {@code WebServiceRef}, an ERROR MUST be given. * * @see javax.annotation.Resource * @see WebServiceFeatureAnnotation @@ -91,7 +91,7 @@ * and this MUST be specified. * * The JNDI name can be absolute(with any logical namespace) or relative - * to JNDI <code>java:comp/env</code> namespace. + * to JNDI {@code java:comp/env} namespace. */ String name() default ""; @@ -106,11 +106,11 @@ /** * A product specific name that this resource should be mapped to. - * The name of this resource, as defined by the <code>name</code> + * The name of this resource, as defined by the {@code name} * element or defaulted, is a name that is local to the application * component using the resource. (When a relative JNDI name * is specified, then it's a name in the JNDI - * <code>java:comp/env</code> namespace.) Many application servers + * {@code java:comp/env} namespace.) Many application servers * provide a way to map these local names to names of resources * known to the application server. This mapped name is often a * <i>global</i> JNDI name, but may be a name of any form. @@ -124,7 +124,7 @@ /** * The service class, always a type extending - * <code>javax.xml.ws.Service</code>. This element MUST be specified + * {@code javax.xml.ws.Service}. This element MUST be specified * whenever the type of the reference is a service endpoint interface. */ // 2.1 has Class value() default Object.class;
--- a/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRefs.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRefs.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,7 +32,7 @@ import static java.lang.annotation.RetentionPolicy.*; /** - * The <code>WebServiceRefs</code> annotation allows + * The {@code WebServiceRefs} annotation allows * multiple web service references to be declared at the * class level. * @@ -50,13 +50,13 @@ * to inject the resource along with its features. * * <p> - * <b>Example</b>: The <code>StockQuoteProvider</code> - * proxy instance, and the <code>StockQuoteService</code> service + * <b>Example</b>: The {@code StockQuoteProvider} + * proxy instance, and the {@code StockQuoteService} service * instance are injected using @WebServiceRefs. * * <pre><code> - * @WebServiceRefs({@WebServiceRef(name="service/stockquoteservice", value=StockQuoteService.class), - * @WebServiceRef(name="service/stockquoteprovider", type=StockQuoteProvider.class, value=StockQuoteService.class}) + * {@literal @}WebServiceRefs({{@literal @}WebServiceRef(name="service/stockquoteservice", value=StockQuoteService.class), + * {@literal @}WebServiceRef(name="service/stockquoteprovider", type=StockQuoteProvider.class, value=StockQuoteService.class}) * public class MyClient { * void init() { * Context ic = new InitialContext();
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/Handler.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/Handler.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,14 +28,14 @@ import javax.xml.ws.ProtocolException; import javax.xml.ws.handler.MessageContext; -/** The <code>Handler</code> interface +/** The {@code Handler} interface * is the base interface for JAX-WS handlers. * * @since 1.6, JAX-WS 2.0 **/ public interface Handler<C extends MessageContext> { - /** The <code>handleMessage</code> method is invoked for normal processing + /** The {@code handleMessage} method is invoked for normal processing * of inbound and outbound messages. Refer to the description of the handler * framework in the JAX-WS specification for full details. * @@ -43,9 +43,9 @@ * @return An indication of whether handler processing should continue for * the current message * <ul> - * <li>Return <code>true</code> to continue + * <li>Return {@code true} to continue * processing.</li> - * <li>Return <code>false</code> to block + * <li>Return {@code false} to block * processing.</li> * </ul> * @throws RuntimeException Causes the JAX-WS runtime to cease @@ -55,7 +55,7 @@ **/ public boolean handleMessage(C context); - /** The <code>handleFault</code> method is invoked for fault message + /** The {@code handleFault} method is invoked for fault message * processing. Refer to the description of the handler * framework in the JAX-WS specification for full details. * @@ -63,9 +63,9 @@ * @return An indication of whether handler fault processing should continue * for the current message * <ul> - * <li>Return <code>true</code> to continue + * <li>Return {@code true} to continue * processing.</li> - * <li>Return <code>false</code> to block + * <li>Return {@code false} to block * processing.</li> * </ul> * @throws RuntimeException Causes the JAX-WS runtime to cease
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/LogicalHandler.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/LogicalHandler.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -25,7 +25,7 @@ package javax.xml.ws.handler; -/** The <code>LogicalHandler</code> extends +/** The {@code LogicalHandler} extends * Handler to provide typesafety for the message context parameter. * * @since 1.6, JAX-WS 2.0
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/LogicalMessageContext.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/LogicalMessageContext.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,8 +27,8 @@ import javax.xml.ws.LogicalMessage; -/** The <code>LogicalMessageContext</code> interface extends - * <code>MessageContext</code> to +/** The {@code LogicalMessageContext} interface extends + * {@code MessageContext} to * provide access to a the contained message as a protocol neutral * LogicalMessage * @@ -39,7 +39,7 @@ /** Gets the message from this message context * - * @return The contained message; returns <code>null</code> if no + * @return The contained message; returns {@code null} if no * message is present in this message context **/ public LogicalMessage getMessage();
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/PortInfo.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/PortInfo.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,8 +28,8 @@ import javax.xml.namespace.QName; /** - * The <code>PortInfo</code> interface is used by a - * <code>HandlerResolver</code> to query information about + * The {@code PortInfo} interface is used by a + * {@code HandlerResolver} to query information about * the port it is being asked to create a handler chain for. * <p> * This interface is never implemented by an application,
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/soap/SOAPHandler.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/soap/SOAPHandler.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -29,7 +29,7 @@ import javax.xml.ws.handler.Handler; import java.util.Set; -/** The <code>SOAPHandler</code> class extends <code>Handler</code> +/** The {@code SOAPHandler} class extends {@code Handler} * to provide typesafety for the message context parameter and add a method * to obtain access to the headers that may be processed by the handler. * @@ -41,8 +41,8 @@ /** Gets the header blocks that can be processed by this Handler * instance. * - * @return Set of <code>QNames</code> of header blocks processed by this - * handler instance. <code>QName</code> is the qualified + * @return Set of {@code QNames} of header blocks processed by this + * handler instance. {@code QName} is the qualified * name of the outermost element of the Header block. **/ Set<QName> getHeaders();
--- a/src/java.xml.ws/share/classes/javax/xml/ws/handler/soap/SOAPMessageContext.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/handler/soap/SOAPMessageContext.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -30,9 +30,9 @@ import javax.xml.namespace.QName; import java.util.Set; -/** The interface <code>SOAPMessageContext</code> +/** The interface {@code SOAPMessageContext} * provides access to the SOAP message for either RPC request or - * response. The <code>javax.xml.soap.SOAPMessage</code> specifies + * response. The {@code javax.xml.soap.SOAPMessage} specifies * the standard Java API for the representation of a SOAP 1.1 message * with attachments. * @@ -43,20 +43,20 @@ public interface SOAPMessageContext extends javax.xml.ws.handler.MessageContext { - /** Gets the <code>SOAPMessage</code> from this message context. Modifications - * to the returned <code>SOAPMessage</code> change the message in-place, there - * is no need to subsequently call <code>setMessage</code>. + /** Gets the {@code SOAPMessage} from this message context. Modifications + * to the returned {@code SOAPMessage} change the message in-place, there + * is no need to subsequently call {@code setMessage}. * - * @return Returns the <code>SOAPMessage</code>; returns <code>null</code> if no - * <code>SOAPMessage</code> is present in this message context + * @return Returns the {@code SOAPMessage}; returns {@code null} if no + * {@code SOAPMessage} is present in this message context **/ public SOAPMessage getMessage(); /** Sets the SOAPMessage in this message context * * @param message SOAP message - * @throws WebServiceException If any error during the setting - * of the <code>SOAPMessage</code> in this message context + * @throws javax.xml.ws.WebServiceException If any error during the setting + * of the {@code SOAPMessage} in this message context * @throws java.lang.UnsupportedOperationException If this * operation is not supported **/ @@ -69,16 +69,16 @@ * @param header The XML qualified name of the SOAP header(s). * @param context The JAXBContext that should be used to unmarshall the * header - * @param allRoles If <code>true</code> then returns headers for all SOAP - * roles, if <code>false</code> then only returns headers targetted + * @param allRoles If {@code true} then returns headers for all SOAP + * roles, if {@code false} then only returns headers targetted * at the roles currently being played by this SOAP node, see - * <code>getRoles</code>. + * {@code getRoles}. * @return An array of unmarshalled headers; returns an empty array if no * message is present in this message context or no headers match * the supplied qualified name. - * @throws WebServiceException If an error occurs when using the supplied - * <code>JAXBContext</code> to unmarshall. The cause of - * the <code>WebServiceException</code> is the original <code>JAXBException</code>. + * @throws javax.xml.ws.WebServiceException If an error occurs when using the supplied + * {@code JAXBContext} to unmarshall. The cause of + * the {@code WebServiceException} is the original {@code JAXBException}. **/ public Object[] getHeaders(QName header, JAXBContext context, boolean allRoles); @@ -87,13 +87,13 @@ * of the handler chain. * Note that SOAP actor roles apply to the SOAP node and * are managed using {@link javax.xml.ws.soap.SOAPBinding#setRoles} and - * {@link javax.xml.ws.soap.SOAPBinding#getRoles}. <code>Handler</code> instances in + * {@link javax.xml.ws.soap.SOAPBinding#getRoles}. {@code Handler} instances in * the handler chain use this information about the SOAP actor * roles to process the SOAP header blocks. Note that the * SOAP actor roles are invariant during the processing of * SOAP message through the handler chain. * - * @return Array of <code>String</code> for SOAP actor roles + * @return Array of {@code String} for SOAP actor roles **/ public Set<String> getRoles(); }
--- a/src/java.xml.ws/share/classes/javax/xml/ws/http/HTTPBinding.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/http/HTTPBinding.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -28,7 +28,7 @@ import javax.xml.ws.Binding; -/** The <code>HTTPBinding</code> interface is an +/** The {@code HTTPBinding} interface is an * abstraction for the XML/HTTP binding. * * @since 1.6, JAX-WS 2.0
--- a/src/java.xml.ws/share/classes/javax/xml/ws/http/HTTPException.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/http/HTTPException.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,7 +26,7 @@ package javax.xml.ws.http; -/** The <code>HTTPException</code> exception represents a +/** The {@code HTTPException} exception represents a * XML/HTTP fault. * * <p>Since there is no standard format for faults or exceptions @@ -39,7 +39,7 @@ private int statusCode; /** Constructor for the HTTPException - * @param statusCode <code>int</code> for the HTTP status code + * @param statusCode {@code int} for the HTTP status code **/ public HTTPException(int statusCode) { super();
--- a/src/java.xml.ws/share/classes/javax/xml/ws/soap/Addressing.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/soap/Addressing.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -46,12 +46,12 @@ * This annotation MUST only be used in conjunction with the * {@link javax.jws.WebService}, {@link WebServiceProvider}, * and {@link WebServiceRef} annotations. - * When used with a <code>javax.jws.WebService</code> annotation, this + * When used with a {@code javax.jws.WebService} annotation, this * annotation MUST only be used on the service endpoint implementation * class. - * When used with a <code>WebServiceRef</code> 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 <code>Addressing</code> + * proxy, and endpoint MUST honor the values of the {@code Addressing} * annotation. * <p> * This annotation's behaviour is defined by the corresponding feature
--- a/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPBinding.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPBinding.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -70,7 +70,7 @@ /** Sets the roles played by the SOAP binding instance. * * @param roles The set of roles played by the binding instance. - * @throws WebServiceException On an error in the configuration of + * @throws javax.xml.ws.WebServiceException On an error in the configuration of * the list of roles. **/ public void setRoles(Set<String> roles); @@ -88,7 +88,7 @@ * * @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 + * @throws javax.xml.ws.WebServiceException If the specified setting is not supported * by this binding instance. * **/
--- a/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPFaultException.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPFaultException.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,18 +27,18 @@ import javax.xml.soap.SOAPFault; -/** The <code>SOAPFaultException</code> exception represents a +/** The {@code SOAPFaultException} exception represents a * SOAP 1.1 or 1.2 fault. * - * <p>A <code>SOAPFaultException</code> wraps a SAAJ <code>SOAPFault</code> + * <p>A {@code SOAPFaultException} wraps a SAAJ {@code SOAPFault} * that manages the SOAP-specific representation of faults. - * The <code>createFault</code> method of - * <code>javax.xml.soap.SOAPFactory</code> may be used to create an instance - * of <code>javax.xml.soap.SOAPFault</code> for use with the - * constructor. <code>SOAPBinding</code> contains an accessor for the - * <code>SOAPFactory</code> used by the binding instance. + * The {@code createFault} method of + * {@code javax.xml.soap.SOAPFactory} may be used to create an instance + * of {@code javax.xml.soap.SOAPFault} for use with the + * constructor. {@code SOAPBinding} contains an accessor for the + * {@code SOAPFactory} used by the binding instance. * - * <p>Note that the value of <code>getFault</code> is the only part of the + * <p>Note that the value of {@code getFault} is the only part of the * exception used when searializing a SOAP fault. * * <p>Refer to the SOAP specification for a complete @@ -55,7 +55,7 @@ private SOAPFault fault; /** Constructor for SOAPFaultException - * @param fault <code>SOAPFault</code> representing the fault + * @param fault {@code SOAPFault} representing the fault * * @see javax.xml.soap.SOAPFactory#createFault **/ @@ -64,9 +64,9 @@ this.fault = fault; } - /** Gets the embedded <code>SOAPFault</code> instance. + /** Gets the embedded {@code SOAPFault} instance. * - * @return <code>javax.xml.soap.SOAPFault</code> SOAP + * @return {@code javax.xml.soap.SOAPFault} SOAP * fault element **/ public javax.xml.soap.SOAPFault getFault() {
--- a/src/java.xml.ws/share/classes/javax/xml/ws/spi/FactoryFinder.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/spi/FactoryFinder.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,7 +34,7 @@ /** * Creates an instance of the specified class using the specified - * <code>ClassLoader</code> object. + * {@code ClassLoader} object. * * @exception WebServiceException if the given class could not be found * or could not be instantiated @@ -56,22 +56,22 @@ } /** - * Finds the implementation <code>Class</code> object for the given - * factory name, or if that fails, finds the <code>Class</code> object + * Finds the implementation {@code Class} object for the given + * factory name, or if that fails, finds the {@code Class} object * for the given fallback class name. The arguments supplied MUST be * used in order. If using the first argument is successful, the second * one will not be used. * <P> * This method is package private so that this code can be shared. * - * @return the <code>Class</code> object of the specified message factory; - * may not be <code>null</code> + * @return the {@code Class} object of the specified message factory; + * may not be {@code null} * * @param factoryId the name of the factory to find, which is * a system property * @param fallbackClassName the implementation class name, which is * to be used only if nothing else - * is found; <code>null</code> to indicate that + * is found; {@code null} to indicate that * there is no fallback class name * @exception WebServiceException if there is an error */
--- a/src/java.xml.ws/share/classes/javax/xml/ws/spi/Invoker.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/spi/Invoker.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -37,8 +37,8 @@ * for a web service invocation. Finally, Invoker does the actual * invocation of web service on endpoint instance. * - * Container also injects the provided <code>WebServiceContext</code> and takes - * care of invoking <code>javax.annotation.PostConstruct</code> methods, + * Container also injects the provided {@code WebServiceContext} and takes + * care of invoking {@code javax.annotation.PostConstruct} methods, * if present, on the endpoint implementation. * * @see Provider#createEndpoint(String, Class, Invoker, WebServiceFeature...) @@ -51,7 +51,7 @@ /** * JAX-WS runtimes calls this method to ask container to inject * WebServiceContext on the endpoint instance. The - * <code>WebServiceContext</code> object uses thread-local information + * {@code WebServiceContext} object uses thread-local information * to return the correct information during the actual endpoint invocation * regardless of how many threads are concurrently being used to serve * requests. @@ -70,7 +70,7 @@ /** * JAX-WS runtime calls this method to do the actual web service * invocation on endpoint instance. The injected - * <code>WebServiceContext.getMessageContext()</code> gives the correct + * {@code WebServiceContext.getMessageContext()} gives the correct * information for this invocation. * * @param m Method to be invoked on the service
--- a/src/java.xml.ws/share/classes/javax/xml/ws/spi/Provider.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/spi/Provider.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -288,7 +288,7 @@ * method can automatically determine the {@code address} of * an endpoint that is published by the same Java EE application and is * identified by the {@code serviceName} and - * {@code portName} propeties. If the {@code address} is + * {@code portName} properties. 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
--- a/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -37,11 +37,11 @@ /** - * Service delegates are used internally by <code>Service</code> objects + * Service delegates are used internally by {@code Service} objects * to allow pluggability of JAX-WS implementations. * <p> - * Every <code>Service</code> object has its own delegate, created using - * the {@link javax.xml.ws.spi.Provider#createServiceDelegate} method. A <code>Service</code> + * Every {@code Service} object has its own delegate, created using + * the {@link javax.xml.ws.spi.Provider#createServiceDelegate} method. A {@code Service} * object delegates all of its instance methods to its delegate. * * @see javax.xml.ws.Service @@ -55,9 +55,9 @@ } /** - * The <code>getPort</code> method returns a proxy. A service client + * The {@code getPort} method returns a proxy. A service client * uses this proxy to invoke operations on the target - * service endpoint. The <code>serviceEndpointInterface</code> + * service endpoint. The {@code serviceEndpointInterface} * specifies the service endpoint interface that is supported by * the created dynamic proxy instance. * @@ -76,8 +76,8 @@ * <LI>If there is any missing WSDL metadata * as required by this method * <LI>If an illegal - * <code>serviceEndpointInterface</code> - * or <code>portName</code> is specified + * {@code serviceEndpointInterface} + * or {@code portName} is specified * </UL> * @see java.lang.reflect.Proxy * @see java.lang.reflect.InvocationHandler @@ -86,9 +86,9 @@ Class<T> serviceEndpointInterface); /** - * The <code>getPort</code> method returns a proxy. A service client + * The {@code getPort} method returns a proxy. A service client * uses this proxy to invoke operations on the target - * service endpoint. The <code>serviceEndpointInterface</code> + * service endpoint. The {@code serviceEndpointInterface} * specifies the service endpoint interface that is supported by * the created dynamic proxy instance. * @@ -97,8 +97,8 @@ * @param serviceEndpointInterface Service endpoint interface * supported by the dynamic proxy or instance * @param features A list of WebServiceFeatures to configure on the - * proxy. Supported features not in the <code>features - * </code> 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 @@ -110,8 +110,8 @@ * <LI>If there is any missing WSDL metadata * as required by this method * <LI>If an illegal - * <code>serviceEndpointInterface</code> - * or <code>portName</code> is specified + * {@code serviceEndpointInterface} + * or {@code portName} is specified * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. * </UL> @@ -125,31 +125,31 @@ Class<T> serviceEndpointInterface, WebServiceFeature... features); /** - * The <code>getPort</code> method returns a proxy. - * The parameter <code>endpointReference</code> specifies the + * The {@code getPort} method returns a proxy. + * The parameter {@code endpointReference} specifies the * endpoint that will be invoked by the returned proxy. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. - * The parameter <code>serviceEndpointInterface</code> specifies + * The parameter {@code serviceEndpointInterface} specifies * the service endpoint interface that is supported 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 associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> metadata + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} metadata * also has a WSDL, then the WSDL from this instance MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. * The returned proxy should not be reconfigured by the client. - * If this <code>Service</code> instance has a known proxy + * If this {@code Service} instance has a known proxy * port that matches the information contained in * the WSDL, * then that proxy is returned, otherwise a WebServiceException @@ -157,20 +157,20 @@ * <p> * Calling this method has the same behavior as the following * <pre> - * <code>port = service.getPort(portName, serviceEndpointInterface);</code> + * {@code port = service.getPort(portName, serviceEndpointInterface);} * </pre> - * where the <code>portName</code> is retrieved from the - * metadata of the <code>endpointReference</code> or from the - * <code>serviceEndpointInterface</code> and the WSDL - * associated with this <code>Service</code> instance. + * where the {@code portName} is retrieved from the + * metadata of the {@code endpointReference} or from the + * {@code serviceEndpointInterface} and the WSDL + * associated with this {@code Service} instance. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the * returned proxy. * @param serviceEndpointInterface Service endpoint interface. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features A list of {@code WebServiceFeatures} to configure on the + * 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 @@ -179,16 +179,16 @@ * of the proxy. * <LI>If there is any missing WSDL metadata * as required by this method. - * <LI>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> of this - * <code>Service</code> instance. - * <LI>If a <code>portName</code> cannot be extracted - * from the WSDL or <code>endpointReference</code> metadata. + * <LI>If the {@code endpointReference} metadata does + * not match the {@code serviceName} of this + * {@code Service} instance. + * <LI>If a {@code portName} cannot be extracted + * from the WSDL or {@code endpointReference} metadata. * <LI>If an invalid - * <code>endpointReference</code> + * {@code endpointReference} * is specified. * <LI>If an invalid - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified. * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. @@ -201,8 +201,8 @@ /** - * The <code>getPort</code> method returns a proxy. The parameter - * <code>serviceEndpointInterface</code> specifies the service + * The {@code getPort} method returns a proxy. The parameter + * {@code serviceEndpointInterface} specifies the service * endpoint interface that is supported by the returned proxy. * In the implementation of this method, the JAX-WS * runtime system takes the responsibility of selecting a protocol @@ -219,7 +219,7 @@ * <LI>If there is any missing WSDL metadata * as required by this method * <LI>If an illegal - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified * </UL> **/ @@ -227,8 +227,8 @@ /** - * The <code>getPort</code> method returns a proxy. The parameter - * <code>serviceEndpointInterface</code> specifies the service + * The {@code getPort} method returns a proxy. The parameter + * {@code serviceEndpointInterface} specifies the service * endpoint interface that is supported by the returned proxy. * In the implementation of this method, the JAX-WS * runtime system takes the responsibility of selecting a protocol @@ -236,9 +236,9 @@ * The returned proxy should not be reconfigured by the client. * * @param serviceEndpointInterface Service endpoint interface - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features An array of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * @return Object instance that supports the * specified service endpoint interface * @throws WebServiceException @@ -248,7 +248,7 @@ * <LI>If there is any missing WSDL metadata * as required by this method * <LI>If an illegal - * <code>serviceEndpointInterface</code> + * {@code serviceEndpointInterface} * is specified * <LI>If a feature is enabled that is not compatible * with this port or is unsupported. @@ -265,7 +265,7 @@ /** * Creates a new port for the service. Ports created in this way contain * no WSDL port type information and can only be used for creating - * <code>Dispatch</code>instances. + * {@code Dispatch}instances. * * @param portName Qualified name for the target service endpoint * @param bindingId A URI identifier of a binding. @@ -283,23 +283,23 @@ /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the user's choosing. * * @param portName Qualified name for the target service endpoint * @param type The class of object used for messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code> and <code>javax.xml.soap.SOAPMessage</code>. + * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the user will work with complete * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the user will work with - * SOAP messages or the contents of a SOAP body. Mode MUST be <code>MESSAGE</code> - * when type is <code>SOAPMessage</code>. + * SOAP messages or the contents of a SOAP body. Mode MUST be {@code MESSAGE} + * when type is {@code SOAPMessage}. * * @return Dispatch instance * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object + * the {@code Dispatch} object * @see javax.xml.transform.Source * @see javax.xml.soap.SOAPMessage **/ @@ -307,26 +307,26 @@ Service.Mode mode); /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the user's choosing. * * @param portName Qualified name for the target service endpoint * @param type The class of object used for messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code> and <code>javax.xml.soap.SOAPMessage</code>. + * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the user will work with complete * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the user will work with - * SOAP messages or the contents of a SOAP body. Mode MUST be <code>MESSAGE</code> - * when type is <code>SOAPMessage</code>. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * SOAP messages or the contents of a SOAP body. Mode MUST be {@code MESSAGE} + * when type is {@code SOAPMessage}. + * @param features A list of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object or if a + * the {@code Dispatch} object or if a * feature is enabled that is not compatible with * this port or is unsupported. * @@ -340,64 +340,64 @@ Service.Mode mode, WebServiceFeature... features); /** - * Creates a <code>Dispatch</code> instance for use with objects of + * Creates a {@code Dispatch} instance for use with objects of * the user's choosing. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. * 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 dispatch accordingly from - * the WSDL associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} * also has a WSDL in its metadata, then the WSDL from this instance MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. - * An implementation MUST be able to retrieve the <code>portName</code> from the - * <code>endpointReference</code> metadata. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. + * An implementation MUST be able to retrieve the {@code portName} from the + * {@code endpointReference} metadata. * <p> * This method behaves the same as calling * <pre> - * <code>dispatch = service.createDispatch(portName, type, mode, features);</code> + * {@code dispatch = service.createDispatch(portName, type, mode, features);} * </pre> - * where the <code>portName</code> is retrieved from the - * WSDL or <code>EndpointReference</code> metadata. + * where the {@code portName} is retrieved from the + * WSDL or {@code EndpointReference} metadata. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the - * returned <code>Dispatch</code> object. + * returned {@code Dispatch} object. * @param type The class of object used to messages or message * payloads. Implementations are required to support - * <code>javax.xml.transform.Source</code> and <code>javax.xml.soap.SOAPMessage</code>. + * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}. * @param mode Controls whether the created dispatch instance is message * or payload oriented, i.e. whether the user will work with complete * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the user will work with - * SOAP messages or the contents of a SOAP body. Mode MUST be <code>MESSAGE</code> - * when type is <code>SOAPMessage</code>. - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * SOAP messages or the contents of a SOAP body. Mode MUST be {@code MESSAGE} + * when type is {@code SOAPMessage}. + * @param features An array of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException * <UL> * <LI>If there is any missing WSDL metadata * as required by this method. - * <li>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> or <code>portName</code> + * <li>If the {@code endpointReference} metadata does + * not match the {@code serviceName} or {@code portName} * of a WSDL associated - * with this <code>Service</code> instance. - * <li>If the <code>portName</code> cannot be determined - * from the <code>EndpointReference</code> metadata. + * with this {@code Service} instance. + * <li>If the {@code portName} cannot be determined + * from the {@code EndpointReference} metadata. * <li>If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * <li>If a feature is enabled that is not * compatible with this port or is unsupported. * </UL> @@ -415,7 +415,7 @@ /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. * * @param portName Qualified name for the target service endpoint @@ -429,7 +429,7 @@ * * @return Dispatch instance * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object + * the {@code Dispatch} object * * @see javax.xml.bind.JAXBContext **/ @@ -438,7 +438,7 @@ /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. * * @param portName Qualified name for the target service endpoint @@ -449,13 +449,13 @@ * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the user will work with * SOAP messages or the contents of a SOAP body. - * @param features A list of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features A list of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException If any error in the creation of - * the <code>Dispatch</code> object or if a + * the {@code Dispatch} object or if a * feature is enabled that is not compatible with * this port or is unsupported. * @@ -468,39 +468,39 @@ JAXBContext context, Service.Mode mode, WebServiceFeature... features); /** - * Creates a <code>Dispatch</code> instance for use with JAXB + * Creates a {@code Dispatch} instance for use with JAXB * generated objects. If there * are any reference parameters in the - * <code>endpointReference</code>, 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 <code>endpointReference's</code> address MUST be used + * The {@code endpointReference's} address MUST be used * for invocations on the endpoint. * 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 dispatch accordingly from - * the WSDL associated with this <code>Service</code> instance or - * from the metadata from the <code>endpointReference</code>. - * If this <code>Service</code> instance has a WSDL and - * the <code>endpointReference</code> + * the WSDL associated with this {@code Service} instance or + * from the metadata from the {@code endpointReference}. + * If this {@code Service} instance has a WSDL and + * the {@code endpointReference} * also has a WSDL in its metadata, then the WSDL from this instance * MUST be used. - * If this <code>Service</code> instance does not have a WSDL and - * the <code>endpointReference</code> does have a WSDL, then the - * WSDL from the <code>endpointReference</code> MAY be used. - * An implementation MUST be able to retrieve the <code>portName</code> from the - * <code>endpointReference</code> metadata. + * If this {@code Service} instance does not have a WSDL and + * the {@code endpointReference} does have a WSDL, then the + * WSDL from the {@code endpointReference} MAY be used. + * An implementation MUST be able to retrieve the {@code portName} from the + * {@code endpointReference} metadata. * <p> * This method behavies the same as calling * <pre> - * <code>dispatch = service.createDispatch(portName, context, mode, features);</code> + * {@code dispatch = service.createDispatch(portName, context, mode, features);} * </pre> - * where the <code>portName</code> is retrieved from the - * WSDL or <code>endpointReference</code> metadata. + * where the {@code portName} is retrieved from the + * WSDL or {@code endpointReference} metadata. * - * @param endpointReference The <code>EndpointReference</code> + * @param endpointReference The {@code EndpointReference} * for the target service endpoint that will be invoked by the - * returned <code>Dispatch</code> object. + * returned {@code Dispatch} object. * @param context The JAXB context used to marshall and unmarshall * messages or message payloads. * @param mode Controls whether the created dispatch instance is message @@ -508,23 +508,23 @@ * protocol messages or message payloads. E.g. when using the SOAP * protocol, this parameter controls whether the user will work with * SOAP messages or the contents of a SOAP body. - * @param features An array of <code>WebServiceFeatures</code> to configure on the - * proxy. Supported features not in the <code>features - * </code> parameter will have their default values. + * @param features An array of {@code WebServiceFeatures} to configure on the + * proxy. Supported features not in the {@code features + * } parameter will have their default values. * * @return Dispatch instance * @throws WebServiceException * <UL> * <li>If there is any missing WSDL metadata * as required by this method. - * <li>If the <code>endpointReference</code> metadata does - * not match the <code>serviceName</code> or <code>portName</code> + * <li>If the {@code endpointReference} metadata does + * not match the {@code serviceName} or {@code portName} * of a WSDL associated - * with this <code>Service</code> instance. - * <li>If the <code>portName</code> cannot be determined - * from the <code>EndpointReference</code> metadata. + * with this {@code Service} instance. + * <li>If the {@code portName} cannot be determined + * from the {@code EndpointReference} metadata. * <li>If any error in the creation of - * the <code>Dispatch</code> object. + * the {@code Dispatch} object. * <li>if a feature is enabled that is not * compatible with this port or is unsupported. * </UL> @@ -546,12 +546,12 @@ public abstract QName getServiceName(); /** - * Returns an <code>Iterator</code> for the list of - * <code>QName</code>s of service endpoints grouped by this + * Returns an {@code Iterator} for the list of + * {@code QName}s of service endpoints grouped by this * service * - * @return Returns <code>java.util.Iterator</code> with elements - * of type <code>javax.xml.namespace.QName</code> + * @return Returns {@code java.util.Iterator} with elements + * of type {@code javax.xml.namespace.QName} * @throws WebServiceException If this Service class does not * have access to the required WSDL metadata **/ @@ -568,21 +568,21 @@ /** * Returns the configured handler resolver. * - * @return HandlerResolver The <code>HandlerResolver</code> being - * used by this <code>Service</code> instance, or <code>null</code> + * @return HandlerResolver The {@code HandlerResolver} being + * used by this {@code Service} instance, or {@code null} * if there isn't one. **/ public abstract HandlerResolver getHandlerResolver(); /** - * Sets the <code>HandlerResolver</code> for this <code>Service</code> + * Sets the {@code HandlerResolver} for this {@code Service} * instance. * <p> * The handler resolver, if present, will be called once for each * proxy or dispatch instance that is created, and the handler chain * returned by the resolver will be set on the instance. * - * @param handlerResolver The <code>HandlerResolver</code> to use + * @param handlerResolver The {@code HandlerResolver} to use * for all subsequently created proxy/dispatch objects. * * @see javax.xml.ws.handler.HandlerResolver @@ -590,12 +590,12 @@ public abstract void setHandlerResolver(HandlerResolver handlerResolver); /** - * Returns the executor for this <code>Service</code>instance. + * Returns the executor for this {@code Service}instance. * * The executor is used for all asynchronous invocations that * require callbacks. * - * @return The <code>java.util.concurrent.Executor</code> to be + * @return The {@code java.util.concurrent.Executor} to be * used to invoke a callback. * * @see java.util.concurrent.Executor @@ -603,12 +603,12 @@ public abstract java.util.concurrent.Executor getExecutor(); /** - * Sets the executor for this <code>Service</code> instance. + * Sets the executor for this {@code Service} instance. * * The executor is used for all asynchronous invocations that * require callbacks. * - * @param executor The <code>java.util.concurrent.Executor</code> + * @param executor The {@code java.util.concurrent.Executor} * to be used to invoke a callback. * * @throws SecurityException If the instance does not support
--- a/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/HttpExchange.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/HttpExchange.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -41,7 +41,7 @@ * for examining the request from the client, and for building and * sending the response. * <p> - * A <code>HttpExchange</code> must be closed to free or reuse + * A {@code HttpExchange} must be closed to free or reuse * underlying resources. The effect of failing to close an exchange * is undefined. * @@ -277,7 +277,7 @@ /** * Returns an attribute that is associated with this - * <code>HttpExchange</code>. JAX-WS handlers and endpoints may then + * {@code HttpExchange}. JAX-WS handlers and endpoints may then * access the attribute via {@link MessageContext}. * <p> * Servlet containers must expose {@link MessageContext#SERVLET_CONTEXT}, @@ -299,7 +299,7 @@ /** * Gives all the attribute names that are associated with - * this <code>HttpExchange</code>. + * this {@code HttpExchange}. * * @return set of all attribute names * @see #getAttribute(String) @@ -308,7 +308,7 @@ /** * Returns the {@link Principal} that represents the authenticated - * user for this <code>HttpExchange</code>. + * user for this {@code HttpExchange}. * * @return Principal for an authenticated user, or * <tt>null</tt> if not authenticated
--- a/src/java.xml.ws/share/classes/javax/xml/ws/wsaddressing/W3CEndpointReference.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/wsaddressing/W3CEndpointReference.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -90,7 +90,7 @@ * If the source does NOT contain a valid W3C WS-Addressing * EndpointReference. * @throws NullPointerException - * If the <code>null</code> <code>source</code> value is given + * If the {@code null} {@code source} value is given */ public W3CEndpointReference(Source source) { try {
--- a/src/java.xml.ws/share/classes/javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.java Thu Jul 16 13:51:53 2015 -0700 +++ b/src/java.xml.ws/share/classes/javax/xml/ws/wsaddressing/W3CEndpointReferenceBuilder.java Thu Jul 16 19:27:53 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -38,35 +38,35 @@ /** - * This class is used to build <code>W3CEndpointReference</code> + * This class is used to build {@code W3CEndpointReference} * instances. The intended use of this clsss is for * an application component, for example a factory component, - * to create an <code>W3CEndpointReference</code> for a + * to create an {@code W3CEndpointReference} for a * web service endpoint published by the same * Java EE application. It can also be used to create - * <code>W3CEndpointReferences</code> for an Java SE based - * endpoint by providing the <code>address</code> property. + * {@code W3CEndpointReferences} for an Java SE based + * endpoint by providing the {@code address} property. * <p> - * When creating a <code>W3CEndpointReference</code> for an + * When creating a {@code W3CEndpointReference} for an * endpoint that is not published by the same Java EE application, - * the <code>address</code> property MUST be specified. + * the {@code address} property MUST be specified. * <p> - * When creating a <code>W3CEndpointReference</code> for an endpoint - * published by the same Java EE application, the <code>address</code> - * property MAY be <code>null</code> but then the <code>serviceName</code> - * and <code>endpointName</code> MUST specify an endpoint published by + * When creating a {@code W3CEndpointReference} for an endpoint + * published by the same Java EE application, the {@code address} + * property MAY be {@code null} but then the {@code serviceName} + * and {@code endpointName} MUST specify an endpoint published by * the same Java EE application. * <p> - * When the <code>wsdlDocumentLocation</code> is specified it MUST refer - * to a valid WSDL document and the <code>serviceName</code> and - * <code>endpointName</code> (if specified) MUST match a service and port + * When the {@code wsdlDocumentLocation} is specified it MUST refer + * to a valid WSDL document and the {@code serviceName} and + * {@code endpointName} (if specified) MUST match a service and port * in the WSDL document. * * @since 1.6, JAX-WS 2.1 */ public final class W3CEndpointReferenceBuilder { /** - * Creates a new <code>W3CEndpointReferenceBuilder</code> instance. + * Creates a new {@code W3CEndpointReferenceBuilder} instance. */ public W3CEndpointReferenceBuilder() { referenceParameters = new ArrayList<Element>(); @@ -76,20 +76,20 @@ } /** - * Sets the <code>address</code> to the - * <code>W3CEndpointReference</code> instance's - * <code>wsa:Address</code>. + * Sets the {@code address} to the + * {@code W3CEndpointReference} instance's + * {@code wsa:Address}. * <p> - * The <code>address</code> MUST be set to a non-<code>null</code> - * value when building a <code>W3CEndpointReference</code> for a + * The {@code address} MUST be set to a non-{@code null} + * value when building a {@code W3CEndpointReference} for a * web service endpoint that is not published by the same * Java EE application or when running on Java SE. * * @param address The address of the endpoint to be targeted - * by the returned <code>W3CEndpointReference</code>. + * by the returned {@code W3CEndpointReference}. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>address</code> set to the <code>wsa:Address</code>. + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code address} set to the {@code wsa:Address}. */ public W3CEndpointReferenceBuilder address(String address) { this.address = address; @@ -97,19 +97,19 @@ } /** - * Sets the <code>interfaceName</code> as the - * <code>wsam:InterfaceName</code> element in the - * <code>wsa:Metadata</code> element. + * Sets the {@code interfaceName} as the + * {@code wsam:InterfaceName} element in the + * {@code wsa:Metadata} element. * * See <a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr"> * 2.1 Referencing WSDL Metadata from an EPR</a> for more details. * * @param interfaceName The port type name of the endpoint to be targeted - * by the returned <code>W3CEndpointReference</code>. + * by the returned {@code W3CEndpointReference}. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>interfaceName</code> as <code>wsam:InterfaceName</code> - * element added to the <code>wsa:Metadata</code> element + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code interfaceName} as {@code wsam:InterfaceName} + * element added to the {@code wsa:Metadata} element * @since 1.7 */ public W3CEndpointReferenceBuilder interfaceName(QName interfaceName) { @@ -118,22 +118,22 @@ } /** - * Sets the <code>serviceName</code> as the - * <code>wsam:ServiceName</code> element in the - * <code>wsa:Metadata</code> element. + * Sets the {@code serviceName} as the + * {@code wsam:ServiceName} element in the + * {@code wsa:Metadata} element. * * See <a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr"> * 2.1 Referencing WSDL Metadata from an EPR</a> for more details. * * @param serviceName The service name of the endpoint to be targeted - * by the returned <code>W3CEndpointReference</code>. This property - * may also be used with the <code>endpointName</code> (portName) - * property to lookup the <code>address</code> of a web service + * by the returned {@code W3CEndpointReference}. This property + * may also be used with the {@code endpointName} (portName) + * property to lookup the {@code address} of a web service * endpoint that is published by the same Java EE application. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>serviceName</code> as <code>wsam:ServiceName</code> - * element added to the <code>wsa:Metadata</code> element + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code serviceName} as {@code wsam:ServiceName} + * element added to the {@code wsa:Metadata} element * */ public W3CEndpointReferenceBuilder serviceName(QName serviceName) { @@ -142,30 +142,31 @@ } /** - * Sets the <code>endpointName</code> as - * <code>wsam:ServiceName/@EndpointName</code> in the - * <code>wsa:Metadata</code> element. This method can only be called + * Sets the {@code endpointName} as + * {@code wsam:ServiceName/@EndpointName} in the + * {@code wsa:Metadata} element. This method can only be called * after the {@link #serviceName} method has been called. * <p> * See <a href="http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/#refmetadatfromepr"> * 2.1 Referencing WSDL Metadata from an EPR</a> for more details. * * @param endpointName The name of the endpoint to be targeted - * by the returned <code>W3CEndpointReference</code>. The - * <code>endpointName</code> (portName) property may also be - * used with the <code>serviceName</code> property to lookup - * the <code>address</code> of a web service + * by the returned {@code W3CEndpointReference}. The + * {@code endpointName} (portName) property may also be + * used with the {@code serviceName} property to lookup + * the {@code address} of a web service * endpoint published by the same Java EE application. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>endpointName</code> as - * <code>wsam:ServiceName/@EndpointName</code> in the - * <code>wsa:Metadata</code> element. + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code endpointName} as + * {@code wsam:ServiceName/@EndpointName} in the + * {@code wsa:Metadata} element. * - * @throws IllegalStateException, if the <code>serviceName</code> - * has not been set. - * @throws IllegalArgumentException, if the <code>endpointName</code>'s - * Namespace URI doesn't match <code>serviceName</code>'s Namespace URI + * @throws java.lang.IllegalStateException if the {@code serviceName} + * has not been set + * + * @throws java.lang.IllegalArgumentException if the {@code endpointName}'s + * Namespace URI doesn't match {@code serviceName}'s Namespace URI * */ public W3CEndpointReferenceBuilder endpointName(QName endpointName) { @@ -178,8 +179,8 @@ } /** - * Sets the <code>wsdlDocumentLocation</code> that will be referenced - * as <code>wsa:Metadata/@wsdli:wsdlLocation</code>. The namespace name + * Sets the {@code wsdlDocumentLocation} that will be referenced + * as {@code wsa:Metadata/@wsdli:wsdlLocation}. The namespace name * for the wsdli:wsdlLocation's value can be taken from the WSDL itself. * * <p> @@ -187,10 +188,10 @@ * 2.1 Referencing WSDL Metadata from an EPR</a> for more details. * * @param wsdlDocumentLocation The location of the WSDL document to - * be referenced in the <code>wsa:Metadata</code> of the - * <code>W3CEndpointReference</code>. - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>wsdlDocumentLocation</code> that is to be referenced. + * be referenced in the {@code wsa:Metadata} of the + * {@code W3CEndpointReference}. + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code wsdlDocumentLocation} that is to be referenced. */ public W3CEndpointReferenceBuilder wsdlDocumentLocation(String wsdlDocumentLocation) { this.wsdlDocumentLocation = wsdlDocumentLocation; @@ -198,19 +199,19 @@ } /** - * Adds the <code>referenceParameter</code> to the - * <code>W3CEndpointReference</code> instance - * <code>wsa:ReferenceParameters</code> element. + * Adds the {@code referenceParameter} to the + * {@code W3CEndpointReference} instance + * {@code wsa:ReferenceParameters} element. * * @param referenceParameter The element to be added to the - * <code>wsa:ReferenceParameters</code> element. + * {@code wsa:ReferenceParameters} element. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>referenceParameter</code> added to the - * <code>wsa:ReferenceParameters</code> element. + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code referenceParameter} added to the + * {@code wsa:ReferenceParameters} element. * - * @throws java.lang.IllegalArgumentException if <code>referenceParameter</code> - * is <code>null</code>. + * @throws java.lang.IllegalArgumentException if {@code referenceParameter} + * is {@code null}. */ public W3CEndpointReferenceBuilder referenceParameter(Element referenceParameter) { if (referenceParameter == null) @@ -220,19 +221,19 @@ } /** - * Adds the <code>metadataElement</code> to the - * <code>W3CEndpointReference</code> instance's - * <code>wsa:Metadata</code> element. + * Adds the {@code metadataElement} to the + * {@code W3CEndpointReference} instance's + * {@code wsa:Metadata} element. * * @param metadataElement The element to be added to the - * <code>wsa:Metadata</code> element. + * {@code wsa:Metadata} element. * - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the <code>metadataElement</code> added to the - * <code>wsa:Metadata</code> element. + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the {@code metadataElement} added to the + * {@code wsa:Metadata} element. * - * @throws java.lang.IllegalArgumentException if <code>metadataElement</code> - * is <code>null</code>. + * @throws java.lang.IllegalArgumentException if {@code metadataElement} + * is {@code null}. */ public W3CEndpointReferenceBuilder metadata(Element metadataElement) { if (metadataElement == null) @@ -243,16 +244,16 @@ /** * Adds an extension element to the - * <code>W3CEndpointReference</code> instance's - * <code>wsa:EndpointReference</code> element. + * {@code W3CEndpointReference} instance's + * {@code wsa:EndpointReference} element. * * @param element The extension element to be added to the - * <code>W3CEndpointReference</code> - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the extension <code>element</code> added to the - * <code>W3CEndpointReference</code> instance. - * @throws java.lang.IllegalArgumentException if <code>element</code> - * is <code>null</code>. + * {@code W3CEndpointReference} + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the extension {@code element} added to the + * {@code W3CEndpointReference} instance. + * @throws java.lang.IllegalArgumentException if {@code element} + * is {@code null}. * * @since 1.7, JAX-WS 2.2 */ @@ -266,17 +267,17 @@ /** * Adds an extension attribute to the - * <code>W3CEndpointReference</code> instance's - * <code>wsa:EndpointReference</code> element. + * {@code W3CEndpointReference} instance's + * {@code wsa:EndpointReference} element. * * @param name The name of the extension attribute to be added to the - * <code>W3CEndpointReference</code> + * {@code W3CEndpointReference} * @param value extension attribute value - * @return A <code>W3CEndpointReferenceBuilder</code> instance with - * the extension attribute added to the <code>W3CEndpointReference</code> + * @return A {@code W3CEndpointReferenceBuilder} instance with + * the extension attribute added to the {@code W3CEndpointReference} * instance. - * @throws java.lang.IllegalArgumentException if <code>name</code> - * or <code>value</code> is <code>null</code>. + * @throws java.lang.IllegalArgumentException if {@code name} + * or {@code value} is {@code null}. * * @since 1.7, JAX-WS 2.2 */ @@ -289,48 +290,48 @@ } /** - * Builds a <code>W3CEndpointReference</code> from the accumulated - * properties set on this <code>W3CEndpointReferenceBuilder</code> + * Builds a {@code W3CEndpointReference} from the accumulated + * properties set on this {@code W3CEndpointReferenceBuilder} * instance. * <p> - * This method can be used to create a <code>W3CEndpointReference</code> - * for any endpoint by specifying the <code>address</code> 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 <code>W3CEndpointReference</code> for + * can also be used to create a {@code W3CEndpointReference} for * an endpoint that is published by the same Java EE application. - * This method can automatically determine the <code>address</code> of + * This method can automatically determine the {@code address} of * an endpoint published by the same Java EE application that is identified by the - * <code>serviceName</code> and - * <code>endpointName</code> properties. If the <code>address</code> is - * <code>null</code> and the <code>serviceName</code> and - * <code>endpointName</code> + * {@code serviceName} and + * {@code endpointName} properties. If the {@code address} is + * {@code null} and the {@code serviceName} and + * {@code endpointName} * do not identify an endpoint published by the same Java EE application, a - * <code>java.lang.IllegalStateException</code> MUST be thrown. + * {@code java.lang.IllegalStateException} MUST be thrown. * * - * @return <code>W3CEndpointReference</code> from the accumulated - * properties set on this <code>W3CEndpointReferenceBuilder</code> - * instance. This method never returns <code>null</code>. + * @return {@code W3CEndpointReference} from the accumulated + * properties set on this {@code W3CEndpointReferenceBuilder} + * instance. This method never returns {@code null}. * * @throws IllegalStateException * <ul> - * <li>If the <code>address</code>, <code>serviceName</code> and - * <code>endpointName</code> are all <code>null</code>. - * <li>If the <code>serviceName</code> service is <code>null</code> and the - * <code>endpointName</code> is NOT <code>null</code>. - * <li>If the <code>address</code> property is <code>null</code> and - * the <code>serviceName</code> and <code>endpointName</code> do not + * <li>If the {@code address}, {@code serviceName} and + * {@code endpointName} are all {@code null}. + * <li>If the {@code serviceName} service is {@code null} and the + * {@code endpointName} is NOT {@code null}. + * <li>If the {@code address} property is {@code null} and + * the {@code serviceName} and {@code endpointName} do not * specify a valid endpoint published by the same Java EE * application. - * <li>If the <code>serviceName</code> is NOT <code>null</code> + * <li>If the {@code serviceName} is NOT {@code null} * and is not present in the specified WSDL. - * <li>If the <code>endpointName</code> port is not <code>null</code> and it - * is not present in <code>serviceName</code> service in the WSDL. - * <li>If the <code>wsdlDocumentLocation</code> is NOT <code>null</code> + * <li>If the {@code endpointName} port is not {@code null} and it + * is not present in {@code serviceName} service in the WSDL. + * <li>If the {@code wsdlDocumentLocation} is NOT {@code null} * and does not represent a valid WSDL. * </ul> * @throws WebServiceException If an error occurs while creating the - * <code>W3CEndpointReference</code>. + * {@code W3CEndpointReference}. * */ public W3CEndpointReference build() {