src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRef.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
*** 30,39 ****
--- 30,40 ----
  import java.lang.annotation.Documented;
  import java.lang.annotation.Target;
  import java.lang.annotation.ElementType;
  import java.lang.annotation.Retention;
  import java.lang.annotation.RetentionPolicy;
+ import javax.annotation.Resource;
  
  /**
   * The {@code WebServiceRef} annotation is used to
   * define a reference to a web service and
   * (optionally) an injection target for it.
*** 70,85 ****
   * <p>
   * If a JAX-WS implementation encounters an unsupported or unrecognized
   * annotation annotated with the {@code WebServiceFeatureAnnotation}
   * that is specified with {@code WebServiceRef}, an ERROR MUST be given.
   *
!  * @see javax.annotation.Resource
   * @see WebServiceFeatureAnnotation
   *
   * @since 1.6, JAX-WS 2.0
   *
! **/
  
  @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD})
  @Retention(RetentionPolicy.RUNTIME)
  @Documented
  public @interface WebServiceRef {
--- 71,86 ----
   * <p>
   * If a JAX-WS implementation encounters an unsupported or unrecognized
   * annotation annotated with the {@code WebServiceFeatureAnnotation}
   * that is specified with {@code WebServiceRef}, an ERROR MUST be given.
   *
!  * @see Resource
   * @see WebServiceFeatureAnnotation
   *
   * @since 1.6, JAX-WS 2.0
   *
!  **/
  
  @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD})
  @Retention(RetentionPolicy.RUNTIME)
  @Documented
  public @interface WebServiceRef {
*** 90,108 ****
--- 91,113 ----
       * to the method.  For class annotations, there is no default
       * and this MUST be specified.
       *
       * The JNDI name can be absolute(with any logical namespace) or relative
       * to JNDI {@code java:comp/env} namespace.
+      *
+      * @return absolute or relative JNDI name
       */
      String name() default "";
  
      /**
       * The Java type of the resource.  For field annotations,
       * the default is the type of the field.  For method annotations,
       * the default is the type of the JavaBeans property.
       * For class annotations, there is no default and this MUST be
       * specified.
+      *
+      * @return type of the resource
       */
      Class<?> type() default Object.class;
  
      /**
       * A product specific name that this resource should be mapped to.
*** 117,150 ****
--- 122,162 ----
       * <p>
       * Application servers are not required to support any particular
       * form or type of mapped name, nor the ability to use mapped names.
       * The mapped name is product-dependent and often installation-dependent.
       * No use of a mapped name is portable.
+      *
+      * @return product specific resource name
       */
      String mappedName() default "";
  
      /**
       * The service class, always a type extending
       * {@code javax.xml.ws.Service}. This element MUST be specified
       * whenever the type of the reference is a service endpoint interface.
+      *
+      * @return the service class extending {@code javax.xml.ws.Service}
       */
      // 2.1 has Class value() default Object.class;
      // Fixing this raw Class type correctly in 2.2 API. This shouldn't cause
      // any compatibility issues for applications.
      Class<? extends Service> value() default Service.class;
  
      /**
       * A URL pointing to the WSDL document for the web service.
       * If not specified, the WSDL location specified by annotations
       * on the resource type is used instead.
+      *
+      * @return a URL pointing to the WSDL document
       */
      String wsdlLocation() default "";
  
      /**
       * A portable JNDI lookup name that resolves to the target
       * web service reference.
       *
+      * @return portable JNDI lookup name
       * @since 1.7, JAX-WS 2.2
       */
      String lookup() default "";
  
  }