什么是注解?
Java
注解(Annotation
)又称 Java
标注,是 JDK5.0
引入的一种注释机制。
定义:注解(Annotation
),也叫元数据。一种代码级别的说明。它是JDK1.5
及以后版本引入的一个特性,与类
、接口
、枚举
是在同一个层次。它可以声明在包
、类
、字段
、方法
、局部变量
、方法
参数等的前面,用来对这些元素进行说明,注释。
注解分为哪几种?
注解又分为内置注解
和自定义注解
两种。内置注解就是JDK
自带的注解,又名元数据
。
内置注解
@Override
- 检查该方法是否是重载方法。如果发现其父类,或者是引用的接口中并没有该方法时,会报编译错误。
@Deprecated
- 标记过时方法。如果使用该方法,会报编译警告。
@SuppressWarnings
- 指示编译器去忽略注解中声明的警告。
作用在其他注解的注解(或者说 元注解)是:
@Retention
- 标识这个注解怎么保存,是只在代码中,还是编入class
文件中,或者是在运行时可以通过反射访问。
@Documented
- 标记这些注解是否包含在用户文档中。
@Target
- 标记这个注解应该是哪种 Java
成员。
@Inherited
- 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)
从 Java 7
开始,额外添加了 3 个注解:
@SafeVarargs
- Java 7 开始支持,忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface
- Java 8 开始支持,标识一个匿名函数或函数式接口。
@Repeatable
- Java 8 开始支持,标识某注解可以在同一个声明上使用多次。
自定义注解
Spring框架
中大量使用的注解大多数都是为自定义注解。
如何自定义一个注解?
自定义一个注解,需要创建一个annotation
类型的类(Class
),如下所示。
public @interface MyAnnotation {
// 自定义注解,类名前面是 “@+interface”
}
注解还不完整,没有表明能用在哪里,是否支持反射等等,我们继续给他添加一些JDK内置的注解,完善自定义注解。
// @Target 其实就是表示使用范围只能在方法上
@Target(ElementType.METHOD)
/* @Retention 表示需要在什么级别保存该注释信息,
用于描述注解的生命周期(即:被描述的注解在什么范围内有效*/
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
}
@Target 注解
@Target
说明了Annotation
所修饰的对象范围:Annotation
可被用于 packages
、types
(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch
参数)。在Annotation
类型的声明中使用了target
可更加明晰其修饰的目标。
CONSTRUCTOR
:用于描述构造器FIELD
:用于描述域LOCAL_VARIABLE
:用于描述局部变量METHOD
:用于描述方法PACKAGE
:用于描述包PARAMETER
:用于描述参数TYPE
:用于描述类、接口(包括注解类型) 或enum
声明
我们自定义的注解就基本完成了,但是还不够完善,我们在开发SpringBoot项目当中使用到大量的注解,点开源码可以发现是可以传值的,比如@Service("userService")
注解。
// 自定义注解类
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
String value() default "";
int order() default 0;
// int max();
// String[] arrays();
}
// 我在注解类中写了一个测试类(懒得重建个类演示)
class MainTest{
@MyAnnotation("myAnnotation")
public void testAnnotaion0() {
}
// @MyAnnotation(arrays = { "1" }, max = 100)
public void testAnnotaion1() {
}
// @MyAnnotation(value="2", arrays = { "3","4" }, max = 200)
public void testAnnotaion2() {
}
}
这样