--- old/src/java.xml.ws/share/classes/javax/xml/ws/Dispatch.java 2015-04-21 17:20:17.640098475 +0400 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/Dispatch.java 2015-04-21 17:20:17.552098475 +0400 @@ -27,10 +27,10 @@ import java.util.concurrent.Future; -/** The Dispatch interface provides support +/** The {@code Dispatch} interface provides support * for the dynamic invocation of a service endpoint operations. The - * javax.xml.ws.Service - * class acts as a factory for the creation of Dispatch + * {@code javax.xml.ws.Service} + * class acts as a factory for the creation of {@code Dispatch} * instances. * * @since 1.6, JAX-WS 2.0 @@ -39,7 +39,7 @@ /** Invoke a service operation synchronously. * - * The client is responsible for ensuring that the msg object + * The client is responsible for ensuring that the {@code msg} object * when marshalled is formed according to the requirements of the protocol * binding in use. * @@ -50,16 +50,16 @@ * @throws WebServiceException If a fault occurs during communication with * the service * @throws WebServiceException If there is any error in the configuration of - * the Dispatch instance + * the {@code Dispatch} instance **/ public T invoke(T msg); /** Invoke a service operation asynchronously. The * method returns without waiting for the response to the operation * invocation, the results of the operation are obtained by polling the - * returned Response. + * returned {@code Response}. *

- * The client is responsible for ensuring that the msg object + * The client is responsible for ensuring that the {@code msg} object * when marshalled is formed according to the requirements of the protocol * binding in use. * @@ -68,16 +68,16 @@ * @return The response message or message payload to the * operation invocation. * @throws WebServiceException If there is any error in the configuration of - * the Dispatch instance + * the {@code Dispatch} instance **/ public Response invokeAsync(T msg); /** Invoke a service operation asynchronously. The * method returns without waiting for the response to the operation * invocation, the results of the operation are communicated to the client - * via the passed in handler. + * via the passed in {@code handler}. *

- * The client is responsible for ensuring that the msg object + * The client is responsible for ensuring that the {@code msg} object * when marshalled is formed according to the requirements of the protocol * binding in use. * @@ -85,13 +85,13 @@ * the message used to invoke the operation. * @param handler The handler object that will receive the * response to the operation invocation. - * @return A Future object that may be used to check the status + * @return A {@code Future} object that may be used to check the status * of the operation invocation. This object MUST NOT be used to try to * obtain the results of the operation - the object returned from - * Future<?>.get() is implementation dependent + * {@code Future.get()} is implementation dependent * and any use of it will result in non-portable behaviour. * @throws WebServiceException If there is any error in the configuration of - * the Dispatch instance + * the {@code Dispatch} instance **/ public Future invokeAsync(T msg, AsyncHandler handler); @@ -102,14 +102,14 @@ * the protocol in use is SOAP/HTTP, this method MUST block until * an HTTP response code has been received or an error occurs. *

- * The client is responsible for ensuring that the msg object + * The client is responsible for ensuring that the {@code msg} object * when marshalled is formed according to the requirements of the protocol * binding in use. * * @param msg An object that will form the message or payload of * the message used to invoke the operation. * @throws WebServiceException If there is any error in the configuration of - * the Dispatch instance or if an error occurs during the + * the {@code Dispatch} instance or if an error occurs during the * invocation. **/ public void invokeOneWay(T msg);