- 五年前就系统的学习过。 也使用过,但从未自己编写过自定义的注解。现在需要编写自定义的注解,所以在温习一下相关知识,并记录在此。大家勉励之。
- 1. 注解(Annotation)简介
- Annotation(注解)是 JDK5.0 及以后版本引入的一个特性。注解是 java 的一个新的类型(与接口很相似) ,它与类、接口、枚举是在同一个层次,它们都称作为 java 的一个类型(TYPE) 。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。它的作用非常的多,例如:进行编译检查、生成说明文档、代码分析等。
- JDK 提供的几个基本注解
-
a. @SuppressWarnings 该注解的作用是阻止编译器发出某些警告信息。 它可以有以下参数: deprecation:过时的类或方法警告。 unchecked:执行了未检查的转换时警告。 fallthrough:当 Switch 程序块直接通往下一种情况而没有 Break 时的警告。 path:在类路径、源文件路径等中有不存在的路径时的警告。 serial:当在可序列化的类上缺少 serialVersionUID 定义时的警告。 finally:任何 finally
子句不能完成时的警告。 all:关于以上所有情况的警告。 - b. @Deprecated 该注解的作用是标记某个过时的类或方法。
- c. @Override 该注解用在方法前面,用来标识该方法是重写父类的某个方法。
- 元注解
- a. @Retention 它是被定义在一个注解类的前面,用来说明该注解的生命周期。 它有以下参数: RetentionPolicy.SOURCE:指定注解只保留在一个源文件当中。 RetentionPolicy.CLASS:指定注解只保留在一个 class 文件中。 RetentionPolicy.RUNTIME:指定注解可以保留在程序运行期间。
- b. @Target 它是被定义在一个注解类的前面,用来说明该注解可以被声明在哪些元素前。 它有以下参数: ElementType.TYPE:说明该注解只能被声明在一个类前。 ElementType.FIELD:说明该注解只能被声明在一个类的字段前。 ElementType.METHOD:说明该注解只能被声明在一个类的方法前。 ElementType.PARAMETER:说明该注解只能被声明在一个方法参数前。
- 2. ElementType.CONSTRUCTOR:说明该注解只能声明在一个类的构造方法前。 ElementType.LOCAL_VARIABLE:说明该注解只能声明在一个局部变量前。 ElementType.ANNOTATION_TYPE:说明该注解只能声明在一个注解类型前。 ElementType.PACKAGE:说明该注解只能声明在一个包名前。
- 注解的生命周期
- 一个注解可以有三个生命周期,它默认的生命周期是保留在一个 CLASS 文件, 但它也可以由一个@Retetion 的元注解指定它的生命周期。 a. java 源文件 当在一个注解类前定义了一个@Retetion(RetentionPolicy.SOURCE)的注解,那么说 明该注解只保留在一个源文件当中,当编译器将源文件编译成 class 文件时,它不 会将源文件中定义的注解保留在 class 文件中。
- b. class 文件中 当在一个注解类前定义了一个 @Retetion(RetentionPolicy.CLASS)的注解,那么说 明该注解只保留在一个 class 文件当中,当加载 class 文件到内存时,虚拟机会将注 解去掉,从而在程序中不能访问。
- c. 程序运行期间 当在一个注解类前定义了一个@Retetion(RetentionPolicy.RUNTIME)的注解,那么 说明该注解在程序运行期间都会存在内存当中。此时,我们可以通过反射来获得 定义在某个类上的所有注解。
- 注解的定义
- 一个简单的注解:
- public @interface Annotation01 {
- //定义公共的final静态属性 ..... //定以公共的抽象方法 ......
- }
- a. 注解可以有哪些成员 注解和接口相似,它只能定义 final 静态属性和公共抽象方法。
- b. 注解的方法 1.方法前默认会加上 public abstract 2.在声明方法时可以定义方法的默认返回值。 例如: String color() default "blue"; String[] color() default {"blue", "red",......} 3.方法的返回值可以有哪些类型 8 种基本类型,String、Class、枚举、注解及这些类型的数组。
- c. 使用注解(参照下面的注解使用)
- 3. 注解的使用
- 注解的使用分为三个过程。 定义注解-->声明注解-->得到注解
- a. 定义注解(参照上面的注解定义)
-
b. 声明注解 1. 在哪些元素上声明注解 如果定义注解时没有指定@Target 元注解来限制它的使用范围,那么该注 解可以使用在 ElementType 枚举指定的任何一个元素前。否则,只能声明在 @Target 元注解指定的元素前。 一般形式: @注解名() 2. 对注解的方法的返回值进行赋值 对于注解中定义的每一个没有默认返回值的方法, 在声明注解时必须对它 的每一个方法的返回值进行赋值。 一般形式: @注解名(方法名=方法返回值,、、、) 、、、 如果方法返回的是一个数组时,那么将方法返回值写在{}符号里
@注解名(方法名={返回值 1,返回值 2,、、、},、、、 、、、 、、、、) 3. 对于只含有 value 方法的注解,在声明注解时可以只写返回值。 c. 得到注解 对于生命周期为运行期间的注解,都可以通过反射获得该元素上的注解实例。 1、声明在一个类中的注解 可以通过该类 Class 对象的 getAnnotation 或 getAnnotations 方法获得。 2、声明在一个字段中的注解 通过 Field 对象的 getAnnotation 或 getAnnotations 方法获得 3、声明在一个方法中的注解
通过 Method 对象的 getAnnotation 或 getAnnotations 方法获得 - 总结
- 注解可以看成是一个接口,注解实例就是一个实现了该接口的动态代理类。 注解大多是用做对某个类、方法、字段进行说明,标识的。以便在程序运行期间我们通 过反射获得该字段或方法的注解的实例,来决定该做些什么处理或不该进行什么处理。
一、什么是java注解
注解,顾名思义,注解,就是对某一事物进行添加注释说明,会存放一些信息,这些信息可能对以后某个时段来说是很有用处的。
Java注解又叫java标注,java提供了一套机制,使得我们可以对方法、类、参数、包、域以及变量等添加标准(即附上某些信息)。且在以后某个时段通过反射将标注的信息提取出来以供使用。
二. 注解的适用范围:
包,类, 方法,方法参数,局部变量,成员变量.
三. 注解的简单介绍
1.注解就相当于给程序打上标记.可使用编译器,工具,程序来通过反射类来了解类或各种元素上是何种标记.
2.注解的的定义及反射调用
注解就相当于一个类,其应用结构:包括三部分:
注解类(@interface)——>应用了注解类的类——>对应用了注解类的类进行反射
的生命周期有三个阶段:java源文件——>class文件——>内存中的字节码
Retention是一个枚举类型,有三个值 (Source class RunTime).
如何自定义注解
自定义步骤大致分为两步:
1, 通过@interface关键字(注意,不是interface,是@interace)声明注解名称,以及注解的成员属性或者叫做注解的参数。
2, 使用java内置的四个元注解对这个自定义标注的功能和范围进行一些限制
问题来了,什么是元注解?
2, 使用java内置的四个元注解对这个自定义标注的功能和范围进行一些限制
问题来了,什么是元注解?
什么是元注解
元注解,就是定义注解的注解,也就是说这些元注解是的作用就是专门用来约束其它注解的注解。请区别上面那三个注解,他们也是通过元注解定义而来的。
元注解有哪些呢,主要有四个@Target,@Retention,@Documented,@Inherited?
1. * 元注解有:@Target,@Retention,@Documented,@Inherited
2. *
3. * @Target 表示该注解用于什么地方,可能的 ElemenetType 参数包括:
4. * ElemenetType.CONSTRUCTOR 构造器声明
5. * ElemenetType.FIELD 域声明(包括 enum 实例)
6. * ElemenetType.LOCAL_VARIABLE 局部变量声明
7. * ElemenetType.METHOD 方法声明
8. * ElemenetType.PACKAGE 包声明
9. * ElemenetType.PARAMETER 参数声明
10. * ElemenetType.TYPE 类,接口(包括注解类型)或enum声明
11. *
12. * @Retention 表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括:
13. * RetentionPolicy.SOURCE 注解将被编译器丢弃
14. * RetentionPolicy.CLASS 注解在class文件中可用,但会被VM丢弃
15. * RetentionPolicy.RUNTIME VM将在运行期也保留注释,因此可以通过反射机制读取注解的信息。
16. *
17. * @Documented 将此注解包含在 javadoc 中
18. *
19. * @Inherited 允许子类继承父类中的注解
|
自定义及使用注解示例
自定义一个类级别的标注Description
package lighter.javaeye.com;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)//这个标注应用于类 @Retention(RetentionPolicy.RUNTIME)//标注会一直保留到运行时 @Documented//将此注解包含在javadoc中
public @interface Description {
String value();
}
|
再定义个方法级别的注解Name