src/share/jaxws_classes/javax/xml/ws/spi/WebServiceFeatureAnnotation.java

Print this page
rev 507 : 8047724: @since tag cleanup in jaxws
Reviewed-by:


  48  * <p>
  49  * JAX-WS defines the following
  50  * <code>WebServiceFeature</code> annotations (<code>Addressing</code>,
  51  * <code>MTOM</code>, <code>RespectBinding</code>), however, an implementation
  52  * may define vendors specific annotations for other features.
  53  * <p>
  54  * Annotations annotated with <code>WebServiceFeatureAnnotation</code> MUST
  55  * have the same @Target of {@link WebServiceRef} annotation, so that the resulting
  56  * feature annotation can be used in conjunction with the {@link WebServiceRef}
  57  * annotation if necessary.
  58  * <p>
  59  * If a JAX-WS implementation encounters an annotation annotated
  60  * with the <code>WebServiceFeatureAnnotation</code> that it does not
  61  * recognize/support an error MUST be given.
  62  * <p>
  63  *
  64  * @see Addressing
  65  * @see MTOM
  66  * @see RespectBinding
  67  *
  68  * @since JAX-WS 2.1
  69  */
  70 @Target(ElementType.ANNOTATION_TYPE)
  71 @Retention(RetentionPolicy.RUNTIME)
  72 @Documented
  73 public @interface WebServiceFeatureAnnotation {
  74     /**
  75      * Unique identifier for the WebServiceFeature.  This
  76      * identifier MUST be unique across all implementations
  77      * of JAX-WS.
  78      */
  79     String id();
  80 
  81     /**
  82      * The <code>WebServiceFeature</code> bean that is associated
  83      * with the <code>WebServiceFeature</code> annotation
  84      */
  85     Class<? extends WebServiceFeature> bean();
  86 }


  48  * <p>
  49  * JAX-WS defines the following
  50  * <code>WebServiceFeature</code> annotations (<code>Addressing</code>,
  51  * <code>MTOM</code>, <code>RespectBinding</code>), however, an implementation
  52  * may define vendors specific annotations for other features.
  53  * <p>
  54  * Annotations annotated with <code>WebServiceFeatureAnnotation</code> MUST
  55  * have the same @Target of {@link WebServiceRef} annotation, so that the resulting
  56  * feature annotation can be used in conjunction with the {@link WebServiceRef}
  57  * annotation if necessary.
  58  * <p>
  59  * If a JAX-WS implementation encounters an annotation annotated
  60  * with the <code>WebServiceFeatureAnnotation</code> that it does not
  61  * recognize/support an error MUST be given.
  62  * <p>
  63  *
  64  * @see Addressing
  65  * @see MTOM
  66  * @see RespectBinding
  67  *
  68  * @since 1.6, JAX-WS 2.1
  69  */
  70 @Target(ElementType.ANNOTATION_TYPE)
  71 @Retention(RetentionPolicy.RUNTIME)
  72 @Documented
  73 public @interface WebServiceFeatureAnnotation {
  74     /**
  75      * Unique identifier for the WebServiceFeature.  This
  76      * identifier MUST be unique across all implementations
  77      * of JAX-WS.
  78      */
  79     String id();
  80 
  81     /**
  82      * The <code>WebServiceFeature</code> bean that is associated
  83      * with the <code>WebServiceFeature</code> annotation
  84      */
  85     Class<? extends WebServiceFeature> bean();
  86 }