--- 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
- * The client is responsible for ensuring that the
- * 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 Responsehandler
.
+ * via the passed in {@code handler}.
* 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, AsyncHandlermsg
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);