
Java中三种标准注解和四种元注解
Java中三种标准注解和四种元注解
先来说说什么是注解:
注解(也被称为元数据)为我们在代码中添加信息提供了⼀种形式化的⽅法,使我们可以在稍后某个时刻⾮常⽅便地使⽤这些数据。
注解的语法⽐较简单,除了@符号的使⽤之外,它基本与Java固有的语法⼀致。Java内置了三种注解,定义在java.lang中的注解:
@Override,表⽰当前的⽅法定义将覆盖超类中的⽅法。如果你不⼩⼼拼写错误,或者⽅法签名对不上被覆盖的⽅法,编译器就会发出错误
提⽰。
@Deprecated,如果程序员使⽤了注解为它的元素,那么编译器会发出警告信息。
@SuppressWarnings,关闭不当的编译器警告信息。在java SE5之前的版本中,也可以使⽤该注解,不过会被忽略不起作⽤。
我们来看⼀下注解@Test的定义:
定义注解时,会需要⼀些元注解(meta-annotation),如@Target和@Retention。
@Target ⽤来定义你的注解将应⽤于什么地⽅(例如是⼀个⽅法或者⼀个域)。
@Retention ⽤来定义该注解在哪⼀个级别可⽤,在源代码中(SOURCE)、类⽂件中(CLASS)或者运⾏时(RUNTIME)。
Java除了内置了三种标准注解,还有四种元注解。
@Target 表⽰该注解⽤于什么地⽅,可能的值在枚举类 ElemenetType 中,包括:
ElemenetType.CONSTRUCTOR-----------------------------构造器声明
ElemenetType.FIELD ----------------------------------域声明(包括 enum 实例)
ElemenetType.LOCAL_VARIABLE------------------------- 局部变量声明
ElemenetType.METHOD ---------------------------------⽅法声明
ElemenetType.PACKAGE --------------------------------包声明
ElemenetType.PARAMETER ------------------------------参数声明
ElemenetType.TYPE----------------------------------- 类,接⼝(包括注解类型)或enum声明
@Retention 表⽰在什么级别保存该注解信息。可选的参数值在枚举类型 RetentionPolicy 中,包括:
RetentionPolicy.SOURCE-------------注解将被编译器丢弃
RetentionPolicy.CLASS -------------注解在class⽂件中可⽤,但会被VM丢弃
RetentionPolicy.RUNTIME ---------VM将在运⾏期也保留注释,因此可以通过反射机制读取注解的信息。
@Documented 将此注解包含在 javadoc 中 ,它代表着此注解会被javadoc⼯具提取成⽂档。在doc⽂档中的内容会因为此注解的信息内
容不同⽽不同。相当与@see,@param 等。
@Inherited 允许⼦类继承⽗类中的注解。
————————————————
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------------------------------------------------------------------
------------------------------