注解简介

注解的本质是一个接口，该接口默认继承Annotation接口，使用@interface进行定义。注解主要有三类：元注解、自定义注解以及框架定义的注解。

接口里面的成员方法称为注解的属性

定义了属性，要在使用的时候给属性赋值

如果定义属性时使用default关键字给属性默认初始值，则可以不进行赋值

若只有一个属性且名为value，则使用时可以直接写值

数组赋值时使用 { } 包裹，数组只有一个值时可以不用 { }

元注解

首先我们要知道什么是元注解，元注解可以看作是用在注解上的注解。基础的元注解有四个：

@Target() ：描述注解能够作用的位置。

ElementType.FIELD：说明自定义的注解可以用于类的变量

ElementType.METHOD：说明自定义的注解可以用于类的方法

ElementType.TYPE：说明自定义的注解可以用于类本身、接口或 enum类型

@Retention() ： 描述注解被保留的阶段

@Retention(RetentionPolicy.RUNTIME)：表示注解可以一直保留到运行时，因此可以通过反射获取注解信息

@Retention(RetentionPolicy.CLASS)：表示注解被编译器编译进 class文件，但运行时会忽略

@Retention(RetentionPolicy.SOURCE)：表示注解仅在源文件中有效，编译时就会被忽略

@Documented ： 描述注解是否被抽取到api文档中

@Inherited ： 描述注解是否被子类继承

可以看到，在描述注解被保留的阶段的时候，生命周期从长到短的顺序是RUNTIME > CLASS > SOURCE。因此，如果需要使用反射在运行时动态获取注解的信息，是必须使用@Retention(RetentionPolicy.RUNTIME)的，就像接下来要实现的例子一样。

利用注解来校验类中的字段

首先自定义一个注解。

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

@Target({ElementType.FIELD})

@Retention(RetentionPolicy.RUNTIME)

public @interface Length {

int min();

int max();

String errorMsg();

}

然后定义一个Person类，包含ID、name以及sex字段，并设置set方法。

public class Person {

@Length(min = 8, max = 8, errorMsg = "错误！id必须为8位！")

private String id;

private String name;

private String sex;

public void setId(String id) {

this.id = id;

}

public void setName(String name) {

this.name = name;

}

public void setSex(String sex) {

this.sex = sex;

}

}

然后我们可以利用反射的原理编写一个测试主函数，看我们自定义的注解是否能够检测字段id是否满足设置的要求。

import java.lang.reflect.Field;

public class lengthTest {

public static String validate(Object object) throws IllegalAccessException {

// 通过反射获取对象的字段

Field[] fields = object.getClass().getDeclaredFields();

// 逐个字段检验，看哪个字段上标了注解

for (Field field : fields) {

if (field.isAnnotationPresent(Length.class)) {

// 如果标了注解，则通过反射获取到该字段上注解的详细信息(包括各种参数)

Length length = field.getAnnotation(Length.class);

// 设置反射后能够得到私有变量

field.setAccessible(true);

// 获取对象字段的实际长度

int value = ((String) field.get(object)).length();

// 检验对象字段实际长度是否合法，合法什么都不做，不合法输出错误信息

if (value < length.min() || value > length.max()) {

return length.errorMsg();

}

}

}

return null;

}

public static void main(String[] args) throws IllegalAccessException {

Person person = new Person();

person.setId("1234567");

person.setName("小美");

person.setSex("女");

System.out.println(validate(person));

}

}

最后，强调一下，反射的知识真的很重要！