Annotation

@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Tonny {
    public int id();
    public String description() default "nothing"; 
}

public class Test {
    @Tonny(id = 1)
    public int foo;
    
    @Tonny(id = 2, description = "Hello")
    public void bar() {
        
    }
    
    public static void main(String[] args) throws Exception {
        Method[] methods = Test.class.getMethods();
        for(Method method : methods) {
            boolean hasAnnotation = method.isAnnotationPresent(Tonny.class);
            if (hasAnnotation) {
                Tonny annotation = method.getAnnotation(Tonny.class);
                System.out.println("TestAnnotation(mathod="+method.getName()+
                        ", id="+annotation.id()+", description="+annotation.description()+")");
            }
        }
        
        Test test = new Test();
        Field field = test.getClass().getField("foo");
        Tonny tonny = field.getAnnotation(Tonny.class);
        field.set(test, tonny.id());
        System.out.println(test.foo);
    }
} 

• 使用 @interface 声明一个注解, 方法名即为注解的参数名, 返回值即为参数的类型, 可以使用 default 设置参数的默认值
• @Retention 用来声明注解的保留策略, 有 CLASS, SOURCE, RUNTIME 三种. 分别表示注解保存在类文件, JVM运行时刻和源代码中. 只有当声明为RUNTIME的时候, 才能够在运行时刻通过反射API来获取到注解的信息.
• @Target用来声明注解可以被添加在哪些类型的元素上，包括:
• ElemenetType.CONSTRUCTOR 构造器声明 
• ElemenetType.FIELD 域声明（包括 enum 实例）
• ElemenetType.LOCAL_VARIABLE 局部变量声明
• ElemenetType.METHOD 方法声明
• ElemenetType.PACKAGE 包声明 
• ElemenetType.PARAMETER 参数声明 
• ElemenetType.TYPE 类，接口（包括注解类型）或enum声明

参考:

Java深度历险（六）——Java注解

JAVA 注解示例 详解

图片取自: 

深入理解Java：注解（Annotation）--注解处理器