java元注解 @Target注解用法

た入场券 2023-02-14 15:47 2阅读 0赞

**@Target：**

@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

**　**　**作用：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）**

![format_png][]

**　取值(ElementType)有**

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 </td> 
 <td> <code>public</code>&nbsp;<code>enum</code>&nbsp;<code>ElementType { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述类、接口(包括注解类型) 或enum声明 Class, interface (including annotation type), or enum declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>TYPE,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/** 用于描述域 Field declaration (includes enum constants) */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>FIELD,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述方法 Method declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>METHOD,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述参数 Formal parameter declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>PARAMETER,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述构造器 Constructor declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>CONSTRUCTOR,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述局部变量 Local variable declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>LOCAL_VARIABLE,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/** Annotation type declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>ANNOTATION_TYPE,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**用于描述包 Package declaration */</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>PACKAGE,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>* 用来标注类型参数 Type parameter declaration</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>* @since 1.8</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>TYPE_PARAMETER,</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>/**</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*能标注任何类型名称 Use of a type</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>* @since 1.8</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>*/</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>TYPE_USE</code> </td> 
 </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
 <tr> 
 <td> 1 </td> 
 <td> <code>ElementType.TYPE_PARAMETER(Type parameter declaration) 用来标注类型参数， 栗子如下：</code> </td> 
 </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 </td> 
 <td> <code>@Target</code><code>(ElementType.TYPE_PARAMETER)</code> <code>@Retention</code><code>(RetentionPolicy.RUNTIME)</code> <code>public</code>&nbsp;<code>@interface</code>&nbsp;<code>TypeParameterAnnotation { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; <code>}</code> &nbsp; <code>// 如下是该注解的使用例子</code> <code>public</code>&nbsp;<code>class</code>&nbsp;<code>TypeParameterClass&lt;</code><code>@TypeParameterAnnotation</code>&nbsp;<code>T&gt; { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>&lt;</code><code>@TypeParameterAnnotation</code>&nbsp;<code>U&gt; T foo(T t) { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>return</code>&nbsp;<code>null</code><code>;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}&nbsp;&nbsp;&nbsp;</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

ElementType.TYPE\_USE(Use of a type) 能标注任何类型名称，包括上面这个（ElementType.TYPE\_PARAMETER的），栗子如下：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 </td> 
 <td> <code>public</code>&nbsp;<code>class</code>&nbsp;<code>TestTypeUse { </code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@Target</code><code>(ElementType.TYPE_USE)</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@Retention</code><code>(RetentionPolicy.RUNTIME)</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>@interface</code>&nbsp;<code>TypeUseAnnotation { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>static</code>&nbsp;<code>@TypeUseAnnotation</code>&nbsp;<code>class</code>&nbsp;<code>TypeUseClass&lt;</code><code>@TypeUseAnnotation</code>&nbsp;<code>T&gt;&nbsp;</code><code>extends</code>&nbsp;<code>@TypeUseAnnotation</code>&nbsp;<code>Object { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>void</code>&nbsp;<code>foo(</code><code>@TypeUseAnnotation</code>&nbsp;<code>T t)&nbsp;</code><code>throws</code>&nbsp;<code>@TypeUseAnnotation</code>&nbsp;<code>Exception { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>// 如下注解的使用都是合法的</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@SuppressWarnings</code><code>({&nbsp;</code><code>"rawtypes"</code><code>,&nbsp;</code><code>"unused"</code><code>,&nbsp;</code><code>"resource"</code>&nbsp;<code>})</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>static</code>&nbsp;<code>void</code>&nbsp;<code>main(String[] args)&nbsp;</code><code>throws</code>&nbsp;<code>Exception { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>TypeUseClass&lt;</code><code>@TypeUseAnnotation</code>&nbsp;<code>String&gt; typeUseClass =&nbsp;</code><code>new</code>&nbsp;<code>@TypeUseAnnotation</code>&nbsp;<code>TypeUseClass&lt;&gt;();</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>typeUseClass.foo(</code><code>""</code><code>);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>List&lt;</code><code>@TypeUseAnnotation</code>&nbsp;<code>Comparable&gt; list1 =&nbsp;</code><code>new</code>&nbsp;<code>ArrayList&lt;&gt;();</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>List&lt;?&nbsp;</code><code>extends</code>&nbsp;<code>Comparable&gt; list2 =&nbsp;</code><code>new</code>&nbsp;<code>ArrayList&lt;</code><code>@TypeUseAnnotation</code>&nbsp;<code>Comparable&gt;();</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@TypeUseAnnotation</code>&nbsp;<code>String text = (</code><code>@TypeUseAnnotation</code>&nbsp;<code>String)</code><code>new</code>&nbsp;<code>Object();</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>java.util.&nbsp;</code><code>@TypeUseAnnotation</code>&nbsp;<code>Scanner console =&nbsp;</code><code>new</code>&nbsp;<code>java.util.</code><code>@TypeUseAnnotation</code>&nbsp;<code>Scanner(System.in);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDE4LmNuYmxvZ3MuY29tL2Jsb2cvODE5OTA3LzIwMTkwMS84MTk5MDctMjAxOTAxMTIyMjU3MjUyNjgtNjc4MjM2Nzg0LnBuZw?x-oss-process=image/format,png