什么是注解?
Annontation是Java5开始引入的新特征,为程序的元素加上更直观、更明了的说明,这些说明信息不会影响业务逻辑。
Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。
Annontation是Java5开始引入的新特征,中文名称叫注解。它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。为程序的元素(类、方法、成员变量)加上更直观更明了的说明,这些说明信息是与程序的业务逻辑无关,并且供指定的工具或框架使用。Annontation像一种修饰符一样,应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。注解不会也不能影响代码的实际逻辑,仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。
为什么选择注解?
- 生成文档:例如@Documented
- 注解替代配置文件,更容易跟踪代码的依赖关系:
- 在编译时可进行格式检查:例如override
- 扩展性、灵活强:可进行自定义注解等
- 。。。等
如何使用注解?
根据需要自行了解。
学习程度:掌握
注解的原理
- 读取xml配置文件
- 实例化bean
- 处理注解方式(遍历所有bean对象处理)
- 注入对象
注解本质是一个继承了Annotation 的特殊接口,其具体实现类是Java 运行时生成的动态代理类。而我们通过反射获取注解时,返回的是Java 运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解(接口)的方法,会最终调用AnnotationInvocationHandler 的invoke 方法。该方法会从memberValues 这个Map 中索引出对应的值。而memberValues 的来源是Java 常量池。
三种注解注入方式
按属性注入
//获取bean对象
Object bean = sigletons.get(beanName);
//获取属性集:
PropertyDescriptor[] ps = Introspector.getBeanInfo(bean.getClass())
.getPropertyDescriptors();
//遍历属性集
//for (PropertyDescriptor properdesc : ps) {...
//获取属性的setter方法
Method setter = properdesc .getWriteMethod();
//判定注解是否存在
setter.isAnnotationPresent(WxyResource.class);
//取得注解
WxyResource resource = setter.getAnnotation(WxyResource.class);
//做了些不懂的操作。。。获得了一个对象
value = sigletons.get(field.getName());
//最后
field.set(bean, value);
按方法注入
//获取bean对象
Object bean = sigletons.get(beanName);
//获取方法集
Method[] methods = Test_1.class.getDeclaredMethods();
//遍历,判断注解是否存在并取得注解
method.isAnnotationPresent(WxyResource.class);
WxyResource resource = method.getAnnotation(WxyResource.class);
按字段注入
//获取bean对象
Object bean = sigletons.get(beanName);
//获取字段集
Field[] fields= Test_1.class.getDeclaredFields();
//遍历,判断注解是否存在并取得注解
field.isAnnotationPresent(WxyResource.class);
WxyResource resource = field.getAnnotation(WxyResource.class);
四大元注解
- @Retention – 什么时候使用该注解
- @Target – 注解用于什么地方
- @Documented – 注解是否将包含在JavaDoc中
- @Inherited – 是否允许子类继承该注解
@Retention
– 定义该注解的生命周期
● RetentionPolicy.SOURCE : 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义,所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
● RetentionPolicy.CLASS : 在类加载的时候丢弃。在字节码文件的处理中有用。默认CLASS
● RetentionPolicy.RUNTIME : 始终不会丢弃,运行期也保留该注解,因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。
@Target
– 表示该注解用于什么地方。默认值为任何元素,表示该注解用于什么地方。可用的ElementType 参数包括
● ElementType.CONSTRUCTOR: 用于描述构造器
● ElementType.FIELD: 成员变量、对象、属性(包括enum实例)
● ElementType.LOCAL_VARIABLE: 用于描述局部变量
● ElementType.METHOD: 用于描述方法
● ElementType.PACKAGE: 用于描述包
● ElementType.PARAMETER: 用于描述参数
● ElementType.TYPE: 用于描述类、接口(包括注解类型) 或enum声明
@Documented
– 一个简单的Annotations 标记注解,表示是否将注解信息添加在java 文档中。
@Inherited
– 定义该注释和子类的关系
@Inherited 元注解是一个标记注解,@Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited 修饰的annotation 类型被用于一个class,则这个annotation 将被用于该class 的子类。
内置标准注解
@Override
用作标注方法为重写的父类方法。
@Deprecated
用于标注属性为过时的。
@SuppressWarnings
关闭特定的警告信息
参数如下:
- deprecation:使用了过时的类或者方法时的警告
- unchecked:执行了未检查的转换时的警告
- fallthrough:当Switch程序块直接通往下一种情况而没有Break时的警告
- path:在类路径、源文件路径等中有存在的路径时的警告
- serial:当在可序列化的类上缺少serialVersionUID定义时的警告
- finally:任何finally子句不能正常完成时的警告
- all:关于以上所有情况的警告