jaxws/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java

*** 1,7 ****
  /*
!  * 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2005, 2017, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 49,68 ****
--- 49,72 ----
   *
   * @since 1.6, JAX-WS 2.0
   */
  public abstract class ServiceDelegate {
  
+     /**
+      * Default constructor.
+      */
      protected ServiceDelegate() {
      }
  
      /**
       * The {@code getPort} method returns a proxy. A service client
       * uses this proxy to invoke operations on the target
       * service endpoint. The {@code serviceEndpointInterface}
       * specifies the service endpoint interface that is supported by
       * the created dynamic proxy instance.
       *
+      * @param <T> Service endpoint interface
       * @param portName  Qualified name of the service endpoint in
       *                  the WSDL service description
       * @param serviceEndpointInterface Service endpoint interface
       *                  supported by the dynamic proxy
       * @return Object Proxy instance that
*** 90,99 ****
--- 94,104 ----
       * uses this proxy to invoke operations on the target
       * service endpoint. The {@code serviceEndpointInterface}
       * specifies the service endpoint interface that is supported by
       * the created dynamic proxy instance.
       *
+      * @param <T> Service endpoint interface
       * @param portName  Qualified name of the service endpoint in
       *                  the WSDL service description
       * @param serviceEndpointInterface Service endpoint interface
       *                  supported by the dynamic proxy or instance
       * @param features  A list of WebServiceFeatures to configure on the
*** 162,171 ****
--- 167,177 ----
       * 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 <T> Service endpoint interface.
       * @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} to configure on the
*** 207,216 ****
--- 213,223 ----
       * 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.
       * The returned proxy should not be reconfigured by the client.
       *
+      * @param <T> Service endpoint interface
       * @param serviceEndpointInterface Service endpoint interface
       * @return Object instance that supports the
       *                  specified service endpoint interface
       * @throws WebServiceException
       *                  <UL>
*** 233,242 ****
--- 240,250 ----
       * 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.
       * The returned proxy should not be reconfigured by the client.
       *
+      * @param <T> Service endpoint interface
       * @param serviceEndpointInterface Service endpoint interface
       * @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
*** 284,293 ****
--- 292,303 ----
  
      /**
       * Creates a {@code Dispatch} instance for use with objects of
       * the user's choosing.
       *
+      * @param <T> type used for messages or message payloads. Implementations are required to
+      * support {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
       * @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} and {@code javax.xml.soap.SOAPMessage}.
       * @param mode Controls whether the created dispatch instance is message
*** 308,317 ****
--- 318,329 ----
  
      /**
       * Creates a {@code Dispatch} instance for use with objects of
       * the user's choosing.
       *
+      * @param <T> type used for messages or message payloads. Implementations are required to
+      * support {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
       * @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} and {@code javax.xml.soap.SOAPMessage}.
       * @param mode Controls whether the created dispatch instance is message
*** 367,376 ****
--- 379,391 ----
       * {@code dispatch = service.createDispatch(portName, type, mode, features);}
       * </pre>
       * where the {@code portName} is retrieved from the
       * WSDL or {@code EndpointReference} metadata.
       *
+      * @param <T> type of object used to messages or message
+      * payloads. Implementations are required to support
+      * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
       * @param endpointReference  The {@code EndpointReference}
       * for the target service endpoint that will be invoked by the
       * returned {@code Dispatch} object.
       * @param type The class of object used to messages or message
       * payloads. Implementations are required to support