41 lines
1.1 KiB
Java
41 lines
1.1 KiB
Java
|
package javax.annotation.meta;
|
||
|
|
|
||
|
|
import java.lang.annotation.Documented;
|
||
|
|
import java.lang.annotation.Retention;
|
||
|
|
import java.lang.annotation.RetentionPolicy;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* This annotation can be applied to the value() element of an annotation that
|
||
|
|
* is annotated as a TypeQualifier. This is only appropriate if the value field
|
||
|
|
* returns a value that is an Enumeration.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* Applications of the type qualifier with different values are exclusive, and
|
||
|
|
* the enumeration is an exhaustive list of the possible values.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* For example, the following defines a type qualifier such that if you know a
|
||
|
|
* value is neither {@literal @Foo(Color.Red)} or {@literal @Foo(Color.Blue)},
|
||
|
|
* then the value must be {@literal @Foo(Color.Green)}. And if you know it is
|
||
|
|
* {@literal @Foo(Color.Green)}, you know it cannot be
|
||
|
|
* {@literal @Foo(Color.Red)} or {@literal @Foo(Color.Blue)}
|
||
|
|
*
|
||
|
|
* <pre>
|
||
|
|
* @TypeQualifier
|
||
|
|
* @interface Foo {
|
||
|
|
* enum Color {
|
||
|
|
* RED, BLUE, GREEN
|
||
|
|
* };
|
||
|
|
*
|
||
|
|
* @Exhaustive
|
||
|
|
* Color value();
|
||
|
|
* }
|
||
|
|
* </pre>
|
||
|
|
*/
|
||
|
|
|
||
|
|
@Documented
|
||
|
|
@Retention(RetentionPolicy.RUNTIME)
|
||
|
|
public @interface Exhaustive {
|
||
|
|
|
||
|
|
}
|