jaxws/src/java.xml.ws/share/classes/javax/xml/ws/soap/Addressing.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
*** 29,52 ****
  import java.lang.annotation.Target;
  import java.lang.annotation.ElementType;
  import java.lang.annotation.Retention;
  import java.lang.annotation.RetentionPolicy;
  
- import javax.xml.ws.BindingProvider;
  import javax.xml.ws.WebServiceRef;
- import javax.xml.ws.WebServiceRefs;
  import javax.xml.ws.WebServiceProvider;
  import javax.xml.ws.soap.AddressingFeature.Responses;
  import javax.xml.ws.spi.WebServiceFeatureAnnotation;
  
  /**
   * This annotation represents the use of WS-Addressing with either
   * the SOAP 1.1/HTTP or SOAP 1.2/HTTP binding. Using this annotation
   * with any other binding is undefined.
   * <p>
   * This annotation MUST only be used in conjunction with the
!  * {@link javax.jws.WebService}, {@link WebServiceProvider},
   *  and {@link WebServiceRef} annotations.
   * When used with a {@code javax.jws.WebService} annotation, this
   * annotation MUST only be used on the service endpoint implementation
   * class.
   * When used with a {@code WebServiceRef} annotation, this annotation
--- 29,50 ----
  import java.lang.annotation.Target;
  import java.lang.annotation.ElementType;
  import java.lang.annotation.Retention;
  import java.lang.annotation.RetentionPolicy;
  
  import javax.xml.ws.WebServiceRef;
  import javax.xml.ws.WebServiceProvider;
  import javax.xml.ws.soap.AddressingFeature.Responses;
  import javax.xml.ws.spi.WebServiceFeatureAnnotation;
  
  /**
   * This annotation represents the use of WS-Addressing with either
   * the SOAP 1.1/HTTP or SOAP 1.2/HTTP binding. Using this annotation
   * with any other binding is undefined.
   * <p>
   * This annotation MUST only be used in conjunction with the
!  * {@code javax.jws.WebService}, {@link WebServiceProvider},
   *  and {@link WebServiceRef} annotations.
   * When used with a {@code javax.jws.WebService} annotation, this
   * annotation MUST only be used on the service endpoint implementation
   * class.
   * When used with a {@code WebServiceRef} annotation, this annotation
*** 68,87 ****
--- 66,89 ----
       * Specifies if this feature is enabled or disabled. If enabled, it means
       * the endpoint supports WS-Addressing but does not require its use.
       * Corresponding
       * <a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyaddressing">
       * 3.1.1 Addressing Assertion</a> must be generated in the generated WSDL.
+      *
+      * @return {@code true} if endpoint supports WS-Addressing, {@code false} otherwise
       */
      boolean enabled() default true;
  
      /**
       * If addressing is enabled, this property determines whether the endpoint
       * requires WS-Addressing. If required is true, the endpoint requires
       * WS-Addressing and WS-Addressing headers MUST
       * be present on incoming messages. A corresponding
       * <a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyaddressing">
       * 3.1.1 Addressing Assertion</a> must be generated in the WSDL.
+      *
+      * @return {@code true} if endpoint requires WS-Addressing, {@code false} otherwise
       */
      boolean required() default false;
  
      /**
       * If addressing is enabled, this property determines whether endpoint
*** 104,113 ****
--- 106,116 ----
       * responses. It will result into
       * wsam:NonAnonymousResponses nested assertion as specified in
       * <a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicynonanonresponses">
       * 3.1.3 NonAnonymousResponses Assertion</a> in the generated WSDL.
       *
+      * @return supported response types
       * @since 1.7, JAX-WS 2.2
       */
      Responses responses() default Responses.ALL;
  
  }