注解Annotation实现原理与示例

什么是注解&＃xff1f;

对于很多初次接触的开发者来说应该都有这个疑问&＃xff1f;Annontation是Java5开始引入的新特征&＃xff0c;中文名称叫注解。它提供了一种安全的类似注释的机制&＃xff0c;用来将任何的信息或元数据&＃xff08;metadata&＃xff09;与程序元素&＃xff08;类、方法、成员变量等&＃xff09;进行关联。为程序的元素&＃xff08;类、方法、成员变量&＃xff09;加上更直观更明了的说明&＃xff0c;这些说明信息是与程序的业务逻辑无关&＃xff0c;并且供指定的工具或框架使用。Annontation像一种修饰符一样&＃xff0c;应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。

Java注解是附加在代码中的一些元信息&＃xff0c;用于一些工具在编译、运行时进行解析和使用&＃xff0c;起到说明、配置的功能。注解不会也不能影响代码的实际逻辑&＃xff0c;仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。

注解的用处&＃xff1a;

1、生成文档。这是最常见的&＃xff0c;也是java 最早提供的注解。常用的有&＃64;param &＃64;return 等

2、跟踪代码依赖性&＃xff0c;实现替代配置文件功能。比如Dagger 2依赖注入&＃xff0c;未来java开发&＃xff0c;将大量注解配置&＃xff0c;具有很大用处;

3、在编译时进行格式检查。如&＃64;override 放在方法前&＃xff0c;如果你这个方法并不是覆盖了超类方法&＃xff0c;则编译时就能检查出。

注解的原理&＃xff1a;

注解本质是一个继承了Annotation的特殊接口&＃xff0c;其具体实现类是Java运行时生成的动态代理类。而我们通过反射获取注解时&＃xff0c;返回的是Java运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解&＃xff08;接口&＃xff09;的方法&＃xff0c;会最终调用AnnotationInvocationHandler的invoke方法。该方法会从memberValues这个Map中索引出对应的值。而memberValues的来源是Java常量池。

元注解&＃xff1a;

java.lang.annotation提供了四种元注解&＃xff0c;专门注解其他的注解&＃xff08;在自定义注解的时候&＃xff0c;需要使用到元注解&＃xff09;&＃xff1a;

&＃64;Documented –注解是否将包含在JavaDoc中

&＃64;Retention –什么时候使用该注解

&＃64;Target –注解用于什么地方

&＃64;Inherited – 是否允许子类继承该注解

1.&＃xff09;&＃64;Retention– 定义该注解的生命周期

●   RetentionPolicy.SOURCE : 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义&＃xff0c;所以它们不会写入字节码。&＃64;Override, &＃64;SuppressWarnings都属于这类注解。

●   RetentionPolicy.CLASS : 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式

●   RetentionPolicy.RUNTIME : 始终不会丢弃&＃xff0c;运行期也保留该注解&＃xff0c;因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。

2.&＃xff09;Target – 表示该注解用于什么地方。默认值为任何元素&＃xff0c;表示该注解用于什么地方。可用的ElementType参数包括

● ElementType.CONSTRUCTOR:用于描述构造器

● ElementType.FIELD:成员变量、对象、属性&＃xff08;包括enum实例&＃xff09;

● ElementType.LOCAL_VARIABLE:用于描述局部变量

● ElementType.METHOD:用于描述方法

● ElementType.PACKAGE:用于描述包

 ● ElementType.PARAMETER:用于描述参数

● ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明

3.)&＃64;Documented–一个简单的Annotations标记注解&＃xff0c;表示是否将注解信息添加在java文档中。

4.)&＃64;Inherited – 定义该注释和子类的关系

&＃64;Inherited 元注解是一个标记注解&＃xff0c;&＃64;Inherited阐述了某个被标注的类型是被继承的。如果一个使用了&＃64;Inherited修饰的annotation类型被用于一个class&＃xff0c;则这个annotation将被用于该class的子类。

常见标准的Annotation&＃xff1a;

1.&＃xff09;Override

自定义注解&＃xff1a;

自定义注解类编写的一些规则:

自定义注解实例&＃xff1a;

FruitName.java

FruitColor.java

FruitProvider.java

FruitInfoUtil.java

Apple.java

FruitRun.java 

运行结果是&＃xff1a;

 水果名称&＃xff1a;Apple

参考链接&＃xff1a;

[1]http://www.cnblogs.com/peida/archive/2013/04/26/3038503.html

版权申明&＃xff1a;内容来源网络&＃xff0c;版权归原创者所有。如有侵权烦请告知&＃xff0c;我们会尽快删除并表示歉意。谢谢。

原文链接&＃xff1a;https://www.cnblogs.com/acm-bingzi/p/javaAnnotation.html