--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java 2015-07-09 12:14:18.000000000 +0200
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java 2015-07-09 12:14:18.000000000 +0200
@@ -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 Service
objects
+ * Service delegates are used internally by {@code Service} objects
* to allow pluggability of JAX-WS implementations.
*
- * Every Service
object has its own delegate, created using
- * the {@link javax.xml.ws.spi.Provider#createServiceDelegate} method. A Service
+ * 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 getPort
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 serviceEndpointInterface
+ * service endpoint. The {@code serviceEndpointInterface}
* specifies the service endpoint interface that is supported by
* the created dynamic proxy instance.
*
@@ -76,8 +76,8 @@
*
serviceEndpointInterface
- * or portName
is specified
+ * {@code serviceEndpointInterface}
+ * or {@code portName} is specified
*
* @see java.lang.reflect.Proxy
* @see java.lang.reflect.InvocationHandler
@@ -86,9 +86,9 @@
ClassgetPort
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 serviceEndpointInterface
+ * 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 features
- *
parameter will have their default values.
+ * proxy. Supported features not in the {@code features
+ * } parameter will have their default values.
* @return Object Proxy instance that
* supports the specified service endpoint
* interface
@@ -110,8 +110,8 @@
* serviceEndpointInterface
- * or portName
is specified
+ * {@code serviceEndpointInterface}
+ * or {@code portName} is specified
* getPort
method returns a proxy.
- * The parameter endpointReference
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
- * endpointReference
, then those reference
+ * {@code endpointReference}, then those reference
* parameters MUST appear as SOAP headers, indicating them to be
* reference parameters, on all messages sent to the endpoint.
- * The endpointReference's
address MUST be used
+ * The {@code endpointReference's} address MUST be used
* for invocations on the endpoint.
- * The parameter serviceEndpointInterface
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 Service
instance or
- * from the metadata from the endpointReference
.
- * If this Service
instance has a WSDL and
- * the endpointReference
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 Service
instance does not have a WSDL and
- * the endpointReference
does have a WSDL, then the
- * WSDL from the endpointReference
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 Service
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 @@
* * Calling this method has the same behavior as the following *
- * port = service.getPort(portName, serviceEndpointInterface);
+ * {@code port = service.getPort(portName, serviceEndpointInterface);}
*
- * where the portName
is retrieved from the
- * metadata of the endpointReference
or from the
- * serviceEndpointInterface
and the WSDL
- * associated with this Service
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 EndpointReference
+ * @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 WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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.
* endpointReference
metadata does
- * not match the serviceName
of this
- * Service
instance.
- * portName
cannot be extracted
- * from the WSDL or endpointReference
metadata.
+ * endpointReference
+ * {@code endpointReference}
* is specified.
* serviceEndpointInterface
+ * {@code serviceEndpointInterface}
* is specified.
* getPort
method returns a proxy. The parameter
- * serviceEndpointInterface
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 @@
* serviceEndpointInterface
+ * {@code serviceEndpointInterface}
* is specified
*
**/
@@ -227,8 +227,8 @@
/**
- * The getPort
method returns a proxy. The parameter
- * serviceEndpointInterface
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 WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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 @@
* serviceEndpointInterface
+ * {@code serviceEndpointInterface}
* is specified
* Dispatch
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 Dispatch
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
- * javax.xml.transform.Source
and javax.xml.soap.SOAPMessage
.
+ * {@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 MESSAGE
- * when type is SOAPMessage
.
+ * 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 Dispatch
object
+ * the {@code Dispatch} object
* @see javax.xml.transform.Source
* @see javax.xml.soap.SOAPMessage
**/
@@ -307,26 +307,26 @@
Service.Mode mode);
/**
- * Creates a Dispatch
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
- * javax.xml.transform.Source
and javax.xml.soap.SOAPMessage
.
+ * {@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 MESSAGE
- * when type is SOAPMessage
.
- * @param features A list of WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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 Dispatch
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 Dispatch
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
- * endpointReference
, then those reference
+ * {@code endpointReference}, then those reference
* parameters MUST appear as SOAP headers, indicating them to be
* reference parameters, on all messages sent to the endpoint.
- * The endpointReference's
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 Service
instance or
- * from the metadata from the endpointReference
.
- * If this Service
instance has a WSDL and
- * the endpointReference
+ * 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 Service
instance does not have a WSDL and
- * the endpointReference
does have a WSDL, then the
- * WSDL from the endpointReference
MAY be used.
- * An implementation MUST be able to retrieve the portName
from the
- * endpointReference
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.
* * This method behaves the same as calling *
- * dispatch = service.createDispatch(portName, type, mode, features);
+ * {@code dispatch = service.createDispatch(portName, type, mode, features);}
*
- * where the portName
is retrieved from the
- * WSDL or EndpointReference
metadata.
+ * where the {@code portName} is retrieved from the
+ * WSDL or {@code EndpointReference} metadata.
*
- * @param endpointReference The EndpointReference
+ * @param endpointReference The {@code EndpointReference}
* for the target service endpoint that will be invoked by the
- * returned Dispatch
object.
+ * returned {@code Dispatch} object.
* @param type The class of object used to messages or message
* payloads. Implementations are required to support
- * javax.xml.transform.Source
and javax.xml.soap.SOAPMessage
.
+ * {@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 MESSAGE
- * when type is SOAPMessage
.
- * @param features An array of WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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
* endpointReference
metadata does
- * not match the serviceName
or portName
+ * Service
instance.
- * portName
cannot be determined
- * from the EndpointReference
metadata.
+ * with this {@code Service} instance.
+ * Dispatch
object.
+ * the {@code Dispatch} object.
* Dispatch
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 Dispatch
object
+ * the {@code Dispatch} object
*
* @see javax.xml.bind.JAXBContext
**/
@@ -438,7 +438,7 @@
/**
- * Creates a Dispatch
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 WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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 Dispatch
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 Dispatch
instance for use with JAXB
+ * Creates a {@code Dispatch} instance for use with JAXB
* generated objects. If there
* are any reference parameters in the
- * endpointReference
, then those reference
+ * {@code endpointReference}, then those reference
* parameters MUST appear as SOAP headers, indicating them to be
* reference parameters, on all messages sent to the endpoint.
- * The endpointReference's
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 Service
instance or
- * from the metadata from the endpointReference
.
- * If this Service
instance has a WSDL and
- * the endpointReference
+ * 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 Service
instance does not have a WSDL and
- * the endpointReference
does have a WSDL, then the
- * WSDL from the endpointReference
MAY be used.
- * An implementation MUST be able to retrieve the portName
from the
- * endpointReference
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.
* * This method behavies the same as calling *
- * dispatch = service.createDispatch(portName, context, mode, features);
+ * {@code dispatch = service.createDispatch(portName, context, mode, features);}
*
- * where the portName
is retrieved from the
- * WSDL or endpointReference
metadata.
+ * where the {@code portName} is retrieved from the
+ * WSDL or {@code endpointReference} metadata.
*
- * @param endpointReference The EndpointReference
+ * @param endpointReference The {@code EndpointReference}
* for the target service endpoint that will be invoked by the
- * returned Dispatch
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 WebServiceFeatures
to configure on the
- * proxy. Supported features not in the features
- *
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
* endpointReference
metadata does
- * not match the serviceName
or portName
+ * Service
instance.
- * portName
cannot be determined
- * from the EndpointReference
metadata.
+ * with this {@code Service} instance.
+ * Dispatch
object.
+ * the {@code Dispatch} object.
* Iterator
for the list of
- * QName
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 java.util.Iterator
with elements
- * of type javax.xml.namespace.QName
+ * @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 HandlerResolver
being
- * used by this Service
instance, or null
+ * @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 HandlerResolver
for this Service
+ * Sets the {@code HandlerResolver} for this {@code Service}
* instance.
*
* 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 HandlerResolver
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 Service
instance.
+ * Returns the executor for this {@code Service}instance.
*
* The executor is used for all asynchronous invocations that
* require callbacks.
*
- * @return The java.util.concurrent.Executor
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 Service
instance.
+ * Sets the executor for this {@code Service} instance.
*
* The executor is used for all asynchronous invocations that
* require callbacks.
*
- * @param executor The java.util.concurrent.Executor
+ * @param executor The {@code java.util.concurrent.Executor}
* to be used to invoke a callback.
*
* @throws SecurityException If the instance does not support