Java 注解

Java 定义了一套注解，共有 7 个(从 Java 7 开始，额外添加了 3 个注解)，3 个在 java.lang 中，剩下 4 个在 java.lang.annotation 中。

1 JDK 注解

名称	Java 版本	作用
@Override	Java 5	检查该方法是否是重载方法。如果发现其父类，或者是引用的接口中并没有该方法时，会报编译错误。
@Deprecated	Java 5	标记过时方法。如果使用该方法，会报编译警告。
@SuppressWarnings	Java 5	指示编译器去忽略注解中声明的警告。

2 其他注解(元注解)

名称	Java 版本	作用
@Retention	Java 5	标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运行时可以通过反射访问。
@Documented	Java 5	标记这些注解是否包含在用户文档中。
@Target	Java 5	标记这个注解应该是哪种 Java 成员。
@Inherited	Java 5	标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

名称	Java 版本	作用
@SafeVarargs	Java 7	忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface	Java 8	标识一个匿名函数或函数式接口。
@Repeatable	Java 8	标识某注解可以在同一个声明上使用多次。

3 注解参数

@Target()参数	作用
ElementType.ElementType.TYPE	类、接口(包括注释类型)或枚举声明
ElementType.FIELD	字段声明(包括枚举常量)
ElementType.METHOD	方法声明
ElementType.PARAMETER	参数声明
ElementType.CONSTRUCTOR	构造方法声明
ElementType.LOCAL_VARIABLE	局部变量声明
ElementType.ANNOTATION_TYPE	注释类型声明
ElementType.PACKAGE	包声明

@Retention()参数	作用
RetentionPolicy.SOURCE	Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该Annotation信息了
RetentionPolicy.CLASS	编译器将Annotation存储于类对应的.class文件中。默认行为
RetentionPolicy.RUNTIME	编译器将Annotation存储于class文件中，并且可由JVM读入

4 测试代码

4.1 BankTransferMoney

package com.xu.modle.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Target(value = { ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
public @interface BankTransferMoney {
	
	double max() default 10000;
	double min() default 10;
	
}

4.2 BankTransferService

package com.xu.modle.annotation;

import java.lang.reflect.Method;

public class BankTransferService {

	@BankTransferMoney(max = 1000,min = 10)
	public boolean transfer(double money) {
		return processAnnotationMoney(money);
	}

	private boolean processAnnotationMoney(double money) {
		try {
			Method tmoney = BankTransferService.class.getDeclaredMethod("transfer",double.class);
			if(tmoney.isAnnotationPresent(BankTransferMoney.class)){
				BankTransferMoney annotation = tmoney.getAnnotation(BankTransferMoney.class);
				if(money > annotation.max() || money<annotation.min()){
					return false;
				}else {
					return true;
				}
			}	            
		} catch ( NoSuchMethodException e) {
			return false;
		}
		return true;
	}

}

4.3 Test

package com.xu.modle.annotation;

public class Test {
	
	public static void main(String[] args) {
		BankTransferService service = new BankTransferService();
		System.out.println(service.transfer(200));
		System.out.println(service.transfer(5));
	}
	
}