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

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * 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

@@ -23,15 +23,12 @@
  * questions.
  */
 
 package javax.xml.ws.spi;
 
-import java.net.URL;
 import java.util.List;
-import java.util.Iterator;
 import java.util.Map;
-import java.util.ServiceLoader;
 import javax.xml.namespace.QName;
 import javax.xml.ws.*;
 import javax.xml.ws.wsaddressing.W3CEndpointReference;
 
 import org.w3c.dom.Element;

@@ -75,10 +72,11 @@
      *  <li> If a system property with the name {@code javax.xml.ws.spi.Provider}
      *  is defined, then its value is used as the name of the implementation class.
      *  <li> Finally, a platform default implementation is used.
      * </ul>
      *
+     * @return provider object
      */
     public static Provider provider() {
         try {
             return FactoryFinder.find(Provider.class, DEFAULT_JAXWSPROVIDER);
         } catch (WebServiceException ex) {

@@ -121,11 +119,10 @@
             java.net.URL wsdlDocumentLocation,
             QName serviceName, Class<? extends Service> serviceClass, WebServiceFeature ... features) {
         throw new UnsupportedOperationException("JAX-WS 2.2 implementation must override this default behaviour.");
     }
 
-
     /**
      *
      * Creates an endpoint object with the provided binding and implementation
      * object.
      *

@@ -137,11 +134,10 @@
      * @return The newly created endpoint.
      */
     public abstract Endpoint createEndpoint(String bindingId,
             Object implementor);
 
-
     /**
      * Creates and publishes an endpoint object with the specified
      * address and implementation object.
      *
      * @param address A URI specifying the address and transport/protocol

@@ -197,10 +193,11 @@
      * to successfully return a proxy, WSDL metadata MUST be available and the
      * {@code endpointReference} MUST contain an implementation understood
      * {@code serviceName} metadata.
      *
      *
+     * @param <T> Service endpoint interface
      * @param endpointReference the EndpointReference 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 {@code features