fix javadoc warnings

Signed-off-by: Lukas Jungmann <[email protected]>

Author: lukasj

api/src/main/java/javax/xml/ws/Action.java

@@ -1,7 +1,7 @@
 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
- * Copyright (c) 2005-2015 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005-2017 Oracle and/or its affiliates. All rights reserved.
  *
  * The contents of this file are subject to the terms of either the GNU
  * General Public License Version 2 only ("GPL") or the Common Development
@@ -62,7 +62,7 @@
  * <p>
  * <b>Example 1</b>: Specify explicit values for {@code Action} message addressing property
  * for {@code input} and {@code output} messages.
- * 
+ *
  * <pre>
  * {@literal @}WebService(targetNamespace="http://example.com/numbers")
  *  public class AddNumbersImpl {
@@ -143,21 +143,27 @@
 public @interface Action {
     /**
      * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code input}
-     * message of the operation. 
+     * message of the operation.
+     *
+     * @return {@code Action} message addressing property for the {@code input} message
      */
     String input() default "";
 
     /**
      * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code output}
-     * message of the operation. 
+     * message of the operation.
+     *
+     * @return {@code Action} message addressing property for the {@code output} message
      */
     String output() default "";
-    
+
     /**
      * Explicit value of the WS-Addressing {@code Action} message addressing property for the {@code fault}
      * message(s) of the operation. Each exception that is mapped to a fault and requires an explicit WS-Addressing
      * {@code Action} message addressing property, needs to be specified as a value in this property
      * using {@link FaultAction} annotation.
+     *
+     * @return {@code Action} message addressing property for the {@code fault} message(s)
      */
     FaultAction[] fault() default { };
 }

api/src/main/java/javax/xml/ws/AsyncHandler.java

@@ -1,7 +1,7 @@
 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
- * Copyright (c) 2005-2015 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005-2017 Oracle and/or its affiliates. All rights reserved.
  *
  * The contents of this file are subject to the terms of either the GNU
  * General Public License Version 2 only ("GPL") or the Common Development
@@ -44,6 +44,7 @@
  * clients that wish to receive callback notification of the completion of
  * service endpoint operations invoked asynchronously.
  *
+ * @param <T> The type of the message or payload
  *  @since 1.6, JAX-WS 2.0
 **/
 public interface AsyncHandler<T> {

api/src/main/java/javax/xml/ws/BindingProvider.java

@@ -1,7 +1,7 @@
 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
- * Copyright (c) 2005-2015 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005-2017 Oracle and/or its affiliates. All rights reserved.
  *
  * The contents of this file are subject to the terms of either the GNU
  * General Public License Version 2 only ("GPL") or the Common Development
@@ -43,7 +43,7 @@
 import java.util.Map;
 import javax.xml.ws.wsaddressing.W3CEndpointReference;
 
-/** 
+/**
  * The {@code BindingProvider} interface provides access to the
  * protocol binding and associated context objects for request and
  * response message processing.
@@ -53,21 +53,21 @@
  * @see javax.xml.ws.Binding
  **/
 public interface BindingProvider {
-    /** 
+    /**
      * Standard property: User name for authentication.
      * <p>Type: {@code java.lang.String}
      **/
     public static final String USERNAME_PROPERTY =
             "javax.xml.ws.security.auth.username";
-    
-    /** 
+
+    /**
      * Standard property: Password for authentication.
      * <p>Type: {@code java.lang.String}
      **/
     public static final String PASSWORD_PROPERTY =
             "javax.xml.ws.security.auth.password";
-    
-    /** 
+
+    /**
      * Standard property: Target service endpoint address. The
      * URI scheme for the endpoint address specification MUST
      * correspond to the protocol/transport binding for the
@@ -76,8 +76,8 @@ public interface BindingProvider {
      **/
     public static final String ENDPOINT_ADDRESS_PROPERTY =
             "javax.xml.ws.service.endpoint.address";
-    
-    /** 
+
+    /**
      * Standard property: This boolean property is used by a service
      * client to indicate whether or not it wants to participate in
      * a session with a service endpoint. If this property is set to
@@ -88,38 +88,38 @@ public interface BindingProvider {
      **/
     public static final String SESSION_MAINTAIN_PROPERTY =
             "javax.xml.ws.session.maintain";
-    
-    /** 
-     * Standard property for SOAPAction. This boolean property  
-     * indicates whether or not the value of the 
+
+    /**
+     * Standard property for SOAPAction. This boolean property
+     * indicates whether or not the value of the
      * {@code javax.xml.ws.soap.http.soapaction.uri} property
-     * is used for the value of the SOAPAction. The  
+     * is used for the value of the SOAPAction. The
      * default value of this property is {@code false} indicating
-     * that the 
+     * that the
      * {@code javax.xml.ws.soap.http.soapaction.uri} property
-     * is not used for the value of the SOAPAction, however, 
-     * if WS-Addressing is enabled, the default value is 
+     * is not used for the value of the SOAPAction, however,
+     * if WS-Addressing is enabled, the default value is
      * {@code true}.
-     * 
+     *
      * <p>Type: {@code java.lang.Boolean}
      **/
     public static final String SOAPACTION_USE_PROPERTY =
             "javax.xml.ws.soap.http.soapaction.use";
-    
+
     /**
-     * Standard property for SOAPAction. Indicates the SOAPAction  
+     * Standard property for SOAPAction. Indicates the SOAPAction
      * URI if the {@code javax.xml.ws.soap.http.soapaction.use}
      * property is set to {@code true}. If WS-Addressing
-     * is enabled, this value will also be used for the value of the  
-     * WS-Addressing Action header.  If this property is not set, 
+     * is enabled, this value will also be used for the value of the
+     * WS-Addressing Action header.  If this property is not set,
      * the default SOAPAction and WS-Addressing Action will be sent.
      *
      * <p>Type: {@code java.lang.String}
      **/
     public static final String SOAPACTION_URI_PROPERTY =
             "javax.xml.ws.soap.http.soapaction.uri";
 
-    /** 
+    /**
      * Get the context that is used to initialize the message context
      * for request messages.
      *
@@ -130,8 +130,8 @@ public interface BindingProvider {
      * @return The context that is used in processing request messages.
      **/
     Map<String, Object> getRequestContext();
-    
-    /** 
+
+    /**
      * Get the context that resulted from processing a response message.
      *
      * The returned context is for the most recently completed synchronous
@@ -143,16 +143,16 @@ public interface BindingProvider {
      * response messages.
      **/
     Map<String, Object> getResponseContext();
-    
-    /** 
+
+    /**
      * Get the Binding for this binding provider.
      *
      * @return The Binding for this binding provider.
      **/
     Binding getBinding();
-    
-   
-    
+
+
+
     /**
      * Returns the {@code EndpointReference} associated with
      * this {@code BindingProvider} instance.
@@ -164,21 +164,22 @@ public interface BindingProvider {
      * @return EndpointReference of the target endpoint associated with this
      * {@code BindingProvider} instance.
      *
-     * @throws java.lang.UnsupportedOperationException If this 
+     * @throws java.lang.UnsupportedOperationException If this
      * {@code BindingProvider} uses the XML/HTTP binding.
      *
      * @see W3CEndpointReference
      *
      * @since 1.6, JAX-WS 2.1
      */
     public EndpointReference getEndpointReference();
-    
-    
+
+
     /**
      * Returns the {@code EndpointReference} associated with
      * this {@code BindingProvider} instance.  The instance
      * returned will be of type {@code clazz}.
      *
+     * @param <T> the type of {@code EndpointReference}
      * @param clazz Specifies the type of {@code EndpointReference}
      * that MUST be returned.
 
@@ -188,10 +189,10 @@ public interface BindingProvider {
 
      * @throws WebServiceException If the Class {@code clazz}
      * is not supported by this implementation.
-     * @throws java.lang.UnsupportedOperationException If this 
+     * @throws java.lang.UnsupportedOperationException If this
      * {@code BindingProvider} uses the XML/HTTP binding.
      *
      * @since 1.6, JAX-WS 2.1
      */
-    public <T extends EndpointReference> T getEndpointReference(Class<T> clazz);  
+    public <T extends EndpointReference> T getEndpointReference(Class<T> clazz);
 }

api/src/main/java/javax/xml/ws/BindingType.java

@@ -1,7 +1,7 @@
 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
- * Copyright (c) 2005-2015 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005-2017 Oracle and/or its affiliates. All rights reserved.
  *
  * The contents of this file are subject to the terms of either the GNU
  * General Public License Version 2 only ("GPL") or the Common Development
@@ -45,13 +45,15 @@
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
+import javax.xml.ws.http.HTTPBinding;
+import javax.xml.ws.soap.SOAPBinding;
 
 /**
  *  The {@code BindingType} annotation is used to
  *  specify the binding to use for a web service
  *  endpoint implementation class.
  *  <p>
- *  This annotation may be overriden programmatically or via
+ *  This annotation may be overridden programmatically or via
  *  deployment descriptors, depending on the platform in use.
  *
  *  @since 1.6, JAX-WS 2.0
@@ -62,12 +64,11 @@
 @Documented
 public @interface BindingType {
      /**
-      * A binding identifier (a URI).
-      * If not specified, the default is the SOAP 1.1 / HTTP binding.
-      * <p>
-      * See the {@code SOAPBinding} and {@code HTTPBinding}
+      * A binding identifier (a URI). If not specified, the default is the SOAP 1.1 / HTTP binding.<br>
+      * See the {@link SOAPBinding} and {@link HTTPBinding}
       * for the definition of the standard binding identifiers.
       *
+      * @return A binding identifier (a URI)
       * @see javax.xml.ws.Binding
       * @see javax.xml.ws.soap.SOAPBinding#SOAP11HTTP_BINDING
       * @see javax.xml.ws.soap.SOAPBinding#SOAP12HTTP_BINDING

api/src/main/java/javax/xml/ws/Dispatch.java

@@ -1,7 +1,7 @@
 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
- * Copyright (c) 2005-2015 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005-2017 Oracle and/or its affiliates. All rights reserved.
  *
  * The contents of this file are subject to the terms of either the GNU
  * General Public License Version 2 only ("GPL") or the Common Development
@@ -49,12 +49,13 @@
  *  class acts as a factory for the creation of {@code Dispatch}
  *  instances.
  *
+ * @param <T> The type of the message or payload
  *  @since 1.6, JAX-WS 2.0
 **/
 public interface Dispatch<T> extends BindingProvider {
 
     /** Invoke a service operation synchronously.
-     * 
+     *
      * 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.
@@ -78,7 +79,7 @@ public interface Dispatch<T> extends BindingProvider {
      * 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.
      * @return The response message or message payload to the