javax.xml.ws.spi.WebServiceFeatureAnnotation Maven / Gradle / Ivy
/*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package javax.xml.ws.spi;
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.xml.ws.WebServiceFeature;
import javax.xml.ws.WebServiceRef;
import javax.xml.ws.WebServiceRefs;
import javax.xml.ws.RespectBinding;
import javax.xml.ws.soap.Addressing;
import javax.xml.ws.soap.MTOM;
/**
* Annotation used to identify other annotations
* as a WebServiceFeature.
*
* Each WebServiceFeature annotation annotated with
* this annotation MUST contain an
* enabled property of type
* boolean with a default value of true.
*
* JAX-WS defines the following
* WebServiceFeature annotations (Addressing,
* MTOM, RespectBinding), however, an implementation
* may define vendors specific annotations for other features.
*
* Annotations annotated with WebServiceFeatureAnnotation MUST
* have the same @Target of {@link WebServiceRef} annotation, so that the resulting
* feature annotation can be used in conjunction with the {@link WebServiceRef}
* annotation if necessary.
*
* If a JAX-WS implementation encounters an annotation annotated
* with the WebServiceFeatureAnnotation that it does not
* recognize/support an error MUST be given.
*
*
* @see Addressing
* @see MTOM
* @see RespectBinding
*
* @since JAX-WS 2.1
*/
@Target(ElementType.ANNOTATION_TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface WebServiceFeatureAnnotation {
/**
* Unique identifier for the WebServiceFeature. This
* identifier MUST be unique across all implementations
* of JAX-WS.
*/
String id();
/**
* The WebServiceFeature bean that is associated
* with the WebServiceFeature annotation
*/
Class bean();
}