--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java 2015-07-08 13:25:36.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java 2015-07-08 13:25:36.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 @@ *

  • If there is any missing WSDL metadata * as required by this method *
  • If an illegal - * 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 @@ Class serviceEndpointInterface); /** - * 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. * @@ -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 @@ *
  • If there is any missing WSDL metadata * as required by this method *
  • If an illegal - * serviceEndpointInterface - * or portName is specified + * {@code serviceEndpointInterface} + * or {@code portName} is specified *
  • If a feature is enabled that is not compatible * with this port or is unsupported. * @@ -125,31 +125,31 @@ Class serviceEndpointInterface, WebServiceFeature... features); /** - * The 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. *
  • If there is any missing WSDL metadata * as required by this method. - *
  • If the endpointReference metadata does - * not match the serviceName of this - * Service instance. - *
  • If a portName cannot be extracted - * from the WSDL or endpointReference metadata. + *
  • If the {@code endpointReference} metadata does + * not match the {@code serviceName} of this + * {@code Service} instance. + *
  • If a {@code portName} cannot be extracted + * from the WSDL or {@code endpointReference} metadata. *
  • If an invalid - * endpointReference + * {@code endpointReference} * is specified. *
  • If an invalid - * serviceEndpointInterface + * {@code serviceEndpointInterface} * is specified. *
  • If a feature is enabled that is not compatible * with this port or is unsupported. @@ -201,8 +201,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 @@ -219,7 +219,7 @@ *
  • If there is any missing WSDL metadata * as required by this method *
  • If an illegal - * 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 @@ *
  • If there is any missing WSDL metadata * as required by this method *
  • If an illegal - * serviceEndpointInterface + * {@code serviceEndpointInterface} * is specified *
  • 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 - * Dispatchinstances. + * {@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 * @@ -415,7 +415,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 @@ -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 * @@ -546,12 +546,12 @@ public abstract QName getServiceName(); /** - * Returns an Iterator for the list of - * QNames 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 Serviceinstance. + * 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