一篇文章,全面掌握Java自定义注解(Annontation)

如果此刻不方便阅读,可收藏或关注微信公众号《程序新视界》回复“注解”获得PDF版本。

注解简介

注解(Annontation),Java5引入的新特性,位于java.lang.annotation包中。提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。是一种说明、配置、描述性的信息,与具体业务无关,也不会影响正常的业务逻辑。但我们可以用反射机制来进行校验、赋值等操作。

常见的注解:@Override,@author,@param,@Deprecated,@SuppressWarnings。

注解的常见用途:

  • 生成文档的注解,如@author,@param。
  • 跟踪代码依赖性,实现替代配置文件功能,如spring mvc的注解。
  • 编译时进行格式检查,如@override。
  • 编译时进行代码生成补全,如lombok插件的@Data。

注解基础知识

注解的定义

  • 注解的定义通过@interface表示,所有的注解会自动继承java.lang.Annotation接口,且不能再继承别的类或是接口。
  • 注解的成员参数只能用public或默认(default) 访问权修饰来进行修饰。
  • 成员参数只能使用八种基本类型(byte、short、char、int、long、float、double、boolean)和String、Enum、Class、annotations等数据类型,及其数组。
  • 获取类方法和字段的注解信息,只能通过Java的反射技术来获取 Annotation 对象。
  • 注解可以没有定义成员,只做标识。

元注解

元注解是专门用来注解其他注解的注解,听起来有些绕口,实际上就是专门为自定义注解提供的注解。java.lang.annotation提供了四种元注解:

  • @Documented – 注解是否将包含在JavaDoc中
  • @Retention – 什么时候使用该注解
  • @Target – 注解用于什么地方
  • @Inherited – 是否允许子类继承该注解
  • @Repeatable - 是否可重复注解,jdk1.8引入

注解的生命周期

通过@Retention定义注解的生命周期,格式如下:

@Retention(RetentionPolicy.SOURCE)

其中RetentionPolicy的不同策略对应的生命周期如下:

  • RetentionPolicy.SOURCE : 仅存在于源代码中,编译阶段会被丢弃,不会包含于class字节码文件中。@Override, @SuppressWarnings都属于这类注解。
  • RetentionPolicy.CLASS : 默认策略,在class字节码文件中存在,在类加载的时被丢弃,运行时无法获取到。
  • RetentionPolicy.RUNTIME : 始终不会丢弃,可以使用反射获得该注解的信息。自定义的注解最常用的使用方式。

注解的作用目标

通过@Target定义注解作用的目标,比如作用于类、属性、或方法等,默认可用于任何地方。格式如下:

@Target(ElementType.TYPE)

对应ElementType参数值适用范围如下:

  • ElementType.TYPE: 类、接口、注解、enum
  • ElementType.CONSTRUCTOR: 构造函数
  • ElementType.FIELD: 成员变量、对象、属性、枚举的常量
  • ElementType.LOCAL_VARIABLE: 局部变量
  • ElementType.METHOD: 方法
  • ElementType.PACKAGE: 包
  • ElementType.PARAMETER: 参数
  • ElementType.ANNOTATION_TYPE): 注解
  • ElementType.TYPE_PARAMETER:类型参数,表示这个注解可以用在 Type的声明式前,jdk1.8引入。
  • ElementType.TYPE_USE:类型的注解,表示这个注解可以用在所有使用Type的地方(如:泛型,类型转换等),jdk1.8引入。

Documented

@Documented,表示是否将此注解的相关信息添加到javadoc文档中。

Inherited

@Inherited,定义该注解和子类的关系,使用此注解声明出来的自定义注解,在使用在类上面时,子类会自动继承此注解,否则,子类不会继承此注解。注意,使用Inherited声明出来的注解,只有在类上使用时才会有效,对方法,属性等其他无效。

实例

下面通过一个实例来演示注解的使用:通过注解进行赋值和通过注解进行校验。

自定义注解

这里定义两个注解,一个用来赋值,一个用来校验。

/**
 * 性别赋值
 * @author zzs
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD,ElementType.METHOD})
@Inherited
public @interface InitSex {

	/**
	 * sex enum
	 * @author zzs
	 */
	enum SEX_TYPE {MAN, WOMAN}

	SEX_TYPE sex() default SEX_TYPE.MAN;
}
/**
 * 年龄校验
 * @author zzs
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD,ElementType.METHOD})
@Inherited
public @interface ValidateAge {

	/**
	 * 最小值
	 */
	int min() default 18;

	/**
	 * 最大值
	 */
	int max() default 99;

	/**
	 * 默认值
	 */
	int value() default 20;
}

定义数据模型

这里用User类来表示具体待处理的数据对象。

/**
 * user
 *
 * @author zzs
 */
public class User {

	private String username;

	@ValidateAge(min = 20, max = 35, value = 22)
	private int age;

	@InitSex(sex = InitSex.SEX_TYPE.MAN)
	private String sex;

    // 省略getter/setter方法
}

测试调用

具体测试调用的过程,参考代码中的注解,其中initUser方法来演示通过反射给属性赋值,checkUser方法通过反射拿到当前属性的值进行对比校验。

import java.lang.reflect.Field;

/**
 * @author zzs
 */
public class TestInitParam {

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

		User user = new User();
		initUser(user);

		// 年龄为0,校验为通过情况
		boolean checkResult = checkUser(user);
		printResult(checkResult);

		// 重新设置年龄,校验通过情况
		user.setAge(22);
		checkResult = checkUser(user);
		printResult(checkResult);
	}

	static void initUser(User user) throws IllegalAccessException {

		// 获取User类中所有的属性(getFields无法获得private属性)
		Field[] fields = User.class.getDeclaredFields();

		// 遍历所有属性
		for (Field field : fields) {
			// 如果属性上有此注解,则进行赋值操作
			if (field.isAnnotationPresent(InitSex.class)) {
				InitSex init = field.getAnnotation(InitSex.class);
				field.setAccessible(true);
				// 设置属性的性别值
				field.set(user, init.sex().toString());
				System.out.println("完成属性值的修改,修改值为:" + init.sex().toString());
			}
		}
	}

	static boolean checkUser(User user) throws IllegalAccessException {

		// 获取User类中所有的属性(getFields无法获得private属性)
		Field[] fields = User.class.getDeclaredFields();

		boolean result = true;
		// 遍历所有属性
		for (Field field : fields) {
			// 如果属性上有此注解,则进行赋值操作
			if (field.isAnnotationPresent(ValidateAge.class)) {
				ValidateAge validateAge = field.getAnnotation(ValidateAge.class);
				field.setAccessible(true);
				int age = (int) field.get(user);
				if (age < validateAge.min() || age > validateAge.max()) {
					result = false;
					System.out.println("年龄值不符合条件");
				}
			}
		}

		return result;
	}

	static void printResult(boolean checkResult) {
		if (checkResult) {
			System.out.println("校验通过");
		} else {
			System.out.println("校验未通过");
		}
	}
}

打印日志:

完成属性值的修改,修改值为:MAN
年龄值不符合条件
校验未通过
校验通过

其他实战相关

在具体项目实战中更多的使用拦截器或切面来进行处理,结合具体的场景进行相应的发挥,这里不再赘述。

更多资料可关注微信公众号,回复对应关键字,本篇回复“注解”获得PDF版本。


程序新视界

关注程序员的职场生涯

一篇文章,全面掌握Java自定义注解(Annontation)_第1张图片

你可能感兴趣的:(Java基础)