0035 Java学习笔记-注解
2016-12-01 12:13
288 查看
什么是注解
注解可以看作类的第6大要素(成员变量、构造器、方法、代码块、内部类)注解有点像修饰符,可以修饰一些程序要素:类、接口、变量、方法、局部变量等等
注解要和对应的配套工具(APT:Annotation Processing Tool)一起使用,APT会对含有注解进行一些处理
比如API文档里面,有些方法下边的“@Deprecated”,就是一个注解,它表示这个方法已经过时,使用的时候会收到警告
注解完全不影响程序的功能
元注解
元注解有6个,位于java.lang.annotation包下@Retention
只能修饰注解
用于指定被修饰的注解,可以保留到什么时间
@Retention只有一个元素:value,是RetentionPolicy类型,这是个枚举类,只有如下三个值
RetentionPolicy.SOURCE:注解只保留在源代码中,编译阶段即被丢弃
RetentionPolicy.CLASS:保留在class文件中,程序运行时,JVM不能获取到该注解
RetentionPolicy.RUNTIME:保留在class文件中,程序运行时,可以通过反射获得该注解
@Target
只能修饰注解
用于指定被修饰的注解,可以用于修饰哪些程序元素
@Target只有一个元素:value,是ElementType[]类型,ElementType也是个枚举类,只有如下十个值
ElementType.TYPE:表示被修饰的注解可以修饰类、接口、注解、枚举
ElementType.FIELD:只能修饰成员变量
ElementType.METHOD:只能修饰方法
ElementType.PARAMETER:可以修饰参数
ElementType.CONSTRUCTOR:只能修饰构造器
ElementType.LOCAL_VARIBLE:只能修饰局部变量
ElementType.ANNOTATION_TYPE:只能修饰注解
ElementType.PACKAGE:只能修饰包
ElementType.TYPE_USE:since 1.8,表示注解能写在
使用类型变量的语句中
ElementType.TYPE_PARAMETER:since 1.8,表示注解能写在类型变量的
声明语句中
@Documented
修饰注解,该注解将被javadoc提取进入文档
该元注解没有元素
@Inherited
修饰注解,表示该注解具有继承性
比如:一个父类使用了一个注解X修饰,而X注解在定义时用了@Inherited修饰,那么子类自动被X修饰
@Repeatable
用于修饰一个注解,表示该注解可以用于重复注解
包含一个变量value,是Annotation的Class类型
@Native
基本注解
基本注解有5个,位于java.lang包下@Override
只能修饰方法;保留在源代码阶段
告诉编译器,被该修饰符修饰的方法是在重写父类的方法,如果父类中没有相同签名的方法,那么会发生错误
@Deprecated
修饰构造器、成员变量、局部变量、方法、包、参数、类、注释、枚举;保留到运行阶段;javadoc提取
表示该元素已过时,其他地方使用这些元素时,编译器会给出警告
@SuppressWarnings
修饰类、接口、注解、枚举、成员变量、方法、参数、构造方法、局部变量;保留在源代码阶段;
只有一个变量value,类型为String[]
被修饰的程序元素及子元素取消value指定的编译器警告
@SafeVarargs
修饰构造器、方法;保留在运行阶段;javadoc提取
专门修饰会引发“堆污染”警告的方法或者构造器
since 1.7
@FunctionalInterface
只能修饰接口;保留到运行阶段;javadoc提取
告诉编译器严格检查,该接口为函数式接口
since 1.8
自定义注解
自定义注解跟定义接口类似,只是用“@interface”关键字替换“interface”可以用一些元注解修饰即可,对于保留时间,如果不写@Target,那么默认是修饰任何程序要素
可以包含变量
比如@Deprecated的源代码是这样的
package java.lang; import java.lang.annotation.*; import static java.lang.annotation.ElementType.*; @Documented //元注解:表示该注解会被javadoc提取到文档中 @Retention(RetentionPolicy.RUNTIME) //元注解:保留到运行阶段 @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE}) //元注解:可以修饰的程序元素 public @interface Deprecated { }
再比如@SuppressWarnings的源代码
package java.lang; import java.lang.annotation.*; import static java.lang.annotation.ElementType.*; @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE}) @Retention(RetentionPolicy.SOURCE) public @interface SuppressWarnings { String[] value(); //可以包含变量,String[]是该变量的类型 }
包含变量的时候,使用时就不能只写注解名称,还得写变量的值,比如:
@SuppressWarnings(value="unchecked") //如果只有一个变量,那么可以省略变量名: @SuppressWarnings("unchecked")
不写变量名和值,那么该注解在定义的时候,就得定义默认值,用default关键字,比如
@Target({TYPE, FIELD}) //只有一个变量,省略变量名 @Retention(RetentionPolicy.CLASS) //只有一个变量,省略变量名 public @interface Test{ String name() default "Java"; //用default指定默认值 int age() default 18; //用default指定默认值 }
实际上,自定义注解默认都是继承了java.lang.annotation.Annotation接口的,见示例:
package testpack; public class Test1 { public static void main(String[] args){ Class clazz=Test.class; Class[] is=clazz.getInterfaces(); for (Class i:is) { System.out.println(i); //输出:interface java.lang.annotation.Annotation } } } @interface Test{ }
注解的分类
标记注解:不包含成员变量元数据注解:包含成员变量
获取程序元素的注解信息
光有注解没用,还得有对应的工具来处理,要处理,得先获取注解信息获取到注解信息的前提是,注解能保留到"获取"这个操作的时候
在文章0033 Java学习笔记-反射-初步1中提到,通过反射可以获取一个类的注解信息,有六个方法,其实这些方法都来自于一个接口:java.lang.reflect.AnnotatedElement,Class是它的实现类之一
java.lang.reflect.AnnotatedElement是个接口,表示程序中可以接受注解的程序元素,主要有如下几个实现类
Package
Class
Filed
Constructor
Method
Parameter
以上这些类都包含0033 Java学习笔记-反射-初步1中关于获取注解的那6个方法,
除以上6个方法外,还有一个方法用于判断程序元素上是否存在指定类型的注解:boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
见示例:
package testpack; import java.lang.annotation.Annotation; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; @Test(name="Java",age=18) public class Test1 { public static void main(String[] args){ Class clazz=Test1.class; Annotation a=clazz.getAnnotation(Test.class); //获取对应类的Test类型的注解 System.out.println(a); if (a instanceof Test){ System.out.println(((Test)a).name()); //强制类型转型后获取name的值 System.out.println(((Test)a).age()); //强制类型转型后获取age的值 } } } @Retention(RetentionPolicy.RUNTIME) //保留到运行时,这条很重要 @interface Test{ public String name(); //定义两个变量 public int age(); }
重复注解
重复注解是Java8新增的功能重复注解是值:用多个相同类型的注解修饰同一个程序元素
使用重复注解要分3步走:
定义一个注解,并用@Repeatable修饰
再定义一个该注解的容器注解
使用重复注解
示例:
package testpack; import java.lang.annotation.Annotation; import java.lang.annotation.Repeatable; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; @Test(name="C++",age=30) @Test(name="Java",age=18) //使用了两个相同类型的注解 public class Test1 { public static void main(String[] args){ Class clazz=Test1.class; Annotation[] as=clazz.getAnnotations(); for (Annotation a:as){ System.out.println(a); //输出:@testpack.Tests(value=[@testpack.Test(name=C++, age=30), @testpack.Test(name=Java, age=18)]) //其实还是只有一个注解,就是Tests这个容器注解 } } } @Repeatable(Tests.class) //用@Repeatable修饰 @Retention(RetentionPolicy.RUNTIME) @interface Test{ //定义Test注解 public String name(); public int age(); } @Retention(RetentionPolicy.RUNTIME) //容器注解的保留时间不能早于其对应的注解 @interface Tests{ //定义Test的容器注解Tests Test[] value(); //容器注解的变量 }
类型注解
类型注解也是Java8新增功能Java8以前的注解只能用在一些特定的程序元素上,
ElementType.TYPE_PARAMETER:表示注解能写在类型变量的
声明语句中
ElementType.TYPE_USE:表示注解能写在
使用类型变量的语句中
对该部分内容没什么理解,更详细的内容见:Java 8的类型注解:工具和机会
APT工具
APT(Annotation Processing Tool):一种注解处理工具,用于对源代码文件进行检测,找出特定的注解信息,然后进行特别的处理比如可以在编译源代码的同时,生成一些附属的描述文件,
在用javac.exe编译源代码时,可以用“-processor”选项指定注解处理器
注解处理器一般实现javax.annotation.processing.Processor接口或者继承AbstractProcessor抽象类
一个注解处理器,可以处理一个或多个注解
其他
注解在提高开发效率方面,作用很大参考:Java 8的类型注解:工具和机会
相关文章推荐
- Java 学习笔记05:Spring 基于注解(Annotation)的IOC
- Java 注解学习笔记
- Spring 注解方式进行事务管理的用法介绍详解【Java学习笔记】
- java学习笔记之自定义注解
- 黑马程序员 java学习笔记——注解
- java注解学习笔记
- Java 学习笔记06:Spring 基于注解(Annotation)的AOP
- Java 注解学习笔记
- Java学习笔记十(注解)
- java学习笔记之ORM注解
- 《编写高质量代码改善Java程序的151个建议》学习笔记 第6章 枚举和注解
- 黑马程序员_JAVA注解学习笔记
- 【转】Java 注解学习笔记
- Java学习笔记 线程,注解(注释)...
- Java 注解学习笔记
- Java 注解学习笔记
- 黑马程序员_java基础加强学习笔记之注解
- 黑马程序员——学习笔记18.Java注解
- java事务学习笔记(七)--像Spring一样使用Transactional注解(Annotation)
- Java编程思想学习笔记——枚举、注解