sample/java.lang.annotation.Target.txt

   1 *java.lang.annotation.Target* *Target* Indicates the kinds of program element to
   2
   3 public interface class Target
   4
   5   implements |java.lang.annotation.Annotation|
   6
   7 |java.lang.annotation.Target_Description|
   8 |java.lang.annotation.Target_Fields|
   9 |java.lang.annotation.Target_Constructors|
  10 |java.lang.annotation.Target_Methods|
  11
  12 ================================================================================
  13
  14 *java.lang.annotation.Target_Description*
  15
  16 Indicates the kinds of program element to which an annotation type is
  17 applicable. If a Target meta-annotation is not present on an annotation type
  18 declaration, the declared type may be used on any program element. If such a
  19 meta-annotation is present, the compiler will enforce the specified usage
  20 restriction.
  21
  22 For example, this meta-annotation indicates that the declared type is itself a
  23 meta-annotation type. It can only be used on annotation type declarations:
  24
  25 Target(ElementType.ANNOTATION_TYPE) public interface MetaAnnotationType { ... }
  26
  27 This meta-annotation indicates that the declared type is intended solely for
  28 use as a member type in complex annotation type declarations. It cannot be used
  29 to annotate anything directly:
  30
  31 Target({}) public interface MemberType { ... }
  32
  33 It is a compile-time error for a single ElementType constant to appear more
  34 than once in a Target annotation. For example, the following meta-annotation is
  35 illegal:
  36
  37 Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD}) public
  38 interface Bogus { ... }
  39
  40
  41