简介
由于无论在Java后台或者Android开发中我们经常遇到注解这个功能机制，例如常用的框架Java后台开发中，Spring、MyBatis等，Android的Dagger2，butterknife等，都是注解框架。今天我们就了解java是如何进行设置注解的？我们可以定义一个注解，方便我们使用等等。
注解元
在进行了解注解时我们先来了解一下，一般注解主要包含以下几个重要的注解元，java注解的机制离不开这几个注解元。
| 注解元 | 介绍<功能> |
|---|---|
| 1.@Target | 注解用于什么地方，下面会介绍 |
| 2.@Retention | 什么时候使用该注解 |
| 3.@Documented | 注解是否将包含在JavaDoc中 |
| 4.@Inherited | 是否允许子类继承该注解，表示父类如果添加此注解，子类也可以使用 |
| 5.@Repeatable | java8添加的，可重复的，表该注解可以多次使用 |
注解的定义
注解的定义很简单，就是通过@interface来进行修饰注解，就是平时我们定义接口的时候前面添加一个@符号。当然了，注解的定义需要添加一些常用的注解元，才能有效的构造我们所需的注解。如下定义注解：
public @interface TestAnnotation {
}
注解元解释
@Target
通过@Target进行添加到注解中，说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了@target可更加明晰其修饰的目标，用于什么地方，修饰什么东西，如下常用的几种方式。
-
CONSTRUCTOR: 用于描述构造器 -
FIELD:用于描述域 -
LOCAL_VARIABLE:用于描述局部变量 -
METHOD:用于描述方法 -
PACKAGE:用于描述包 -
PARAMETER:用于描述参数 -
TYPE:用于描述类、接口(包括注解类型) 或enum声明
如下代码
@Target({ElementType.FIELD,ElementType.METHOD}) //多个的时候使用{}括起来，然后用逗号分隔开
public @interface TargetTest {
}
@Retention
该注解是表示我们在运行或者编译时的一个保留状态，指示要保留带注释类型的注释的时间长度。
-
SOURCE:在源文件中有效（即源文件保留），在编译时将其抛弃掉。 -
CLASS:在class文件中有效（即class保留），不会添加载到JVM中 -
RUNTIME:在运行时有效（即运行时保留），这个和我们常用的加载是一致的，运行时会加载到JVM中，一般通过反射可获取到，一般这个是我们常用的。
@Retention(RetentionPolicy.RUNTIME)//在使用该注解其，只能选择其中一种属性，不能定义多个
public @interface RetentionTest {
}
@Documented
@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API。
如下代码
@Documented //添加文档注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AnnotationTest {
}
@Inherited：
@Inherited元注解是一个标记注解， @Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。
@Documented
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Inherited //添加继承注解
public @interface AnnotationTest {
}
@Repeatable
这个是在java8添加的注解特性，@Repeatable的值表示可重复注释类型的包含注释类型。
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Repeatables {
RepeatablesTest[] value();
}
@Repeatable(Repeatables.class)
public @interface RepeatablesTest {
String value() default "哈哈哈";
}
例子
我们简单的介绍了注解的常用的5个注解元，解下来我们通过例子来实现注解。
代码如下，根据上面的提示我们进行测试。
在看例子之前我们先来了解一下常用的几个方法。
-
Class.getAnnotations()获取所有的注解，包括自己声明的以及继承的 -
Class.getAnnotation(Class< A > annotationClass)获取指定的注解，该注解可以是自己声明的，也可以是继承的 -
Class.getDeclaredAnnotations()获取自己声明的注解 -
Class.getDeclaredField(String name);//获取该类的声明字段 -
Class.getDeclaredMethods();//返回的是一个Method[]数组
@Documented
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface AnnotationTest {
String name() default "小明"; //表示默认为小明。
}
@AnnotationTest() //在该类添加注解
public class TestAnnotationMain {
public static void main(String[] args) {
boolean hasAnnotation = TestAnnotationMain.class.isAnnotationPresent(AnnotationTest.class);
if (hasAnnotation) {
AnnotationTest annotation = TestAnnotationMain.class.getAnnotation(AnnotationTest.class);
System.out.println(annotation.name());
}
}
}
打印输出结果：
输出1.png
如果我们想更改name的值可以这么弄
@AnnotationTest(name = "小刚")
public class TestAnnotationMain {
public static void main(String[] args) {
boolean hasAnnotation = TestAnnotationMain.class.isAnnotationPresent(AnnotationTest.class);
if (hasAnnotation) {
AnnotationTest annotation = TestAnnotationMain.class.getAnnotation(AnnotationTest.class);
System.out.println(annotation.name());
}
}
}
输出2.png
如果我们想给一个类的属性进行赋值可以这么做
1.创建一个注解如下
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface AnnotationTest1 {
String value(); //value来定义
}
2.引用该主解
public class Test {
@AnnotationTest1(value = "小云") //引用注解进行赋值
public String name;
}
3.测试
public class TestAnnotation1Main {
public static void main(String[] args) {
try {
Field name = Test.class.getDeclaredField("name");//该该类的字段
name.setAccessible(true);
AnnotationTest1 annotationTest1 = name.getAnnotation(AnnotationTest1.class);//获取该字段的注解
if (annotationTest1 != null) {
System.out.println(annotationTest1.value()); //输出值
}
} catch (NoSuchFieldException e) {
e.printStackTrace();
}
}
}
获取方法上的注解类 如AnnotationTest2
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface AnnotationTest2 {
//todo无任何方法或者属性
}
public class Test {
@AnnotationTest1(value = "小云")
public String name;
@AnnotationTest2 //目的获取该AnnotationTest2
public void fun() {
System.out.println("方法执行");
}
}
获取
public class TestAnnotation1Main {
public static void main(String[] args) {
try {
Field name = Test.class.getDeclaredField("name"); //获取该类的声明字段
name.setAccessible(true);
AnnotationTest1 annotationTest1 = name.getAnnotation(AnnotationTest1.class);//获取该字段的注解
if (annotationTest1 != null) {
System.out.println(annotationTest1.value()); //输出值
}
Method fun = Test.class.getDeclaredMethod("fun");
if (fun != null) {
Annotation[] annotations = fun.getAnnotations();
for (int i = 0; i < annotations.length; i++) {
System.out.println(annotations[i].annotationType().getSimpleName());
}
}
} catch (NoSuchFieldException | NoSuchMethodException e) {
e.printStackTrace();
}
}
}
举例
@Documented
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
}
////////////////////////////////////////////////////////////////////////////
public class MyTest { //进行获取注解方法的全部数据
@MyAnnotation
public void mytestLoad() {
System.out.println("测试加载");
}
@MyAnnotation
public void mytestRequest() {
System.out.println("测试请求");
}
@MyAnnotation
public void mytestProgress() {
System.out.println("测试进度");
}
@MyAnnotation
public void mytestError() {
System.out.println(1 );
}
///////该方法不执行
public void mytestNoAnno(){
System.out.println("没有注解的方法");
}
}
////////////////////////////////////////////////////////////////////////////
public class TestMain {
public static void main(String[] args) {
MyTest myTest = new MyTest();
Method[] methods = myTest.getClass().getDeclaredMethods();
for (int i = 0; i < methods.length; i++) {
Method method = methods[i];
if (method.isAnnotationPresent(MyAnnotation.class)) {
try {
method.setAccessible(true);
method.invoke(myTest, null);//调用该类的注解方法
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
}
}
System.out.println("==================输出完成！====================");
}
}
输出3.png
下载
总结
我们在开发中长见的注解如下：
| 常用注解 | 解释 |
|---|---|
| @Override | 方法重写 |
| @SuppressWarnings | 提示警告 |
| @SafeVarargs | 参数安全 |
| @Deprecated | 作用是对不应该再使用的方法添加注解 |
| @FunctionalInterface | 函数式编程，用于Lambda 表达式 |
注解给我们带来了许多方便，但是我们也得知道其优缺点。
优点
注解方便我们进行单元测试，有利于进行开发。
代码整洁，通过注解的方式变可知修饰的变量，或者方法。
节省配置，减少配置文件大小。缺点
通过反射进行设置，可能会产生性能上的问题。
若要对配置进行修改需要重新编译，扩展性差。
参考
https://blog.csdn.net/briblue/article/details/73824058
https://blog.csdn.net/ryo1060732496/article/details/80891093
