自定义注解?怎么用？

一：理解

注解有啥用？

　　Annontation是Java5开始引入的新特征，中文名称叫注解。它提供了一种安全的类似注释的机制，用来将任何的信息或元数据（metadata）与程序元素（类、方法、成员变量等）进行关联。为程序的元素（类、方法、成员变量）加上更直观更明了的说明，这些说明信息是与程序的业务逻辑无关，并且供指定的工具或框架使用。

Annontation像一种修饰符一样，应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。常用的地方有：

1、生成文档。比如swagger就是使用注解生成文档。常用的有@param @return 等
2、跟踪代码依赖性，实现替代配置文件功能。
3、在编译时进行格式检查。如@override 放在方法前，如果你这个方法并不是覆盖了超类方法，则编译时就能检查出。

注解的原理：

注解本质是一个继承了Annotation 的特殊接口，其具体实现类是Java 运行时生成的动态代理类。而我们通过反射获取注解时，返回的是Java 运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解（接口）的方法，会最终调用AnnotationInvocationHandler 的invoke方法。该方法会从memberValues 这个Map 中索引出对应的值。而memberValues 的来源是Java 常量池。

元注解：

java.lang.annotation 提供了四种元注解，专门注解其他的注解（在自定义注解的时候，需要使用到元注解）：

1.@Retention – 定义该注解的生命周期，什么时候使用该注解

• RetentionPolicy.SOURCE : 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。

• RetentionPolicy.CLASS : 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式

• RetentionPolicy.RUNTIME : 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。

2.Target – 表示该注解用于什么地方。默认值为任何元素，表示该注解用于什么地方。可用的ElementType 参数包括

• ElementType.CONSTRUCTOR: 用于描述构造器

• ElementType.FIELD: 成员变量、对象、属性（包括enum实例）

• ElementType.LOCAL_VARIABLE: 用于描述局部变量

• ElementType.METHOD: 用于描述方法

• ElementType.PACKAGE: 用于描述包

• ElementType.PARAMETER: 用于描述参数

• ElementType.TYPE: 用于描述类、接口(包括注解类型) 或enum声明

3.@Documented – 一个简单的Annotations 标记注解，表示是否将注解信息添加在java 文档中。

4.@Inherited – 定义该注释和子类的关系，是否允许子类继承该注解

@Inherited 元注解是一个标记注解，@Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited 修饰的annotation 类型被用于一个class，则这个annotation 将被用于该class 的子类。

常见标准的Annotation：

1.Override

java.lang.Override是一个标记类型注解，它被用作标注方法。它说明了被标注的方法重载了父类的方法，起到了断言的作用。如果我们使用了这种注解在一个没有覆盖父类方法的方法时，java 编译器将以一个编译错误来警示。

2.Deprecated

Deprecated 也是一种标记类型注解。当一个类型或者类型成员使用@Deprecated 修饰的话，编译器将不鼓励使用这个被标注的程序元素。所以使用这种修饰具有一定的“延续性”：如果我们在代码中通过继承或者覆盖的方式使用了这个过时的类型或者成员，虽然继承或者覆盖后的类型或者成员并不是被声明为@Deprecated，但编译器仍然要报警。

3.SuppressWarnings

SuppressWarning 不是一个标记类型注解。它有一个类型为String[] 的成员，这个成员的值为被禁止的警告名。对于javac 编译器来讲，被-Xlint 选项有效的警告名也同样对@SuppressWarings 有效，同时编译器忽略掉无法识别的警告名。
@SuppressWarnings("unchecked")

4：Spring，Mybatis等框架中常见的注解

二：自定义注解：

自定义注解类编写的一些规则:

1. Annotation 型定义为@interface, 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口.

2. 参数成员只能用public 或默认(default) 这两个访问权修饰

3. 参数成员只能用基本类型byte、short、char、int、long、float、double、boolean八种基本数据类型和String、Enum、Class、annotations等数据类型，以及这一些类型的数组.

4. 要获取类方法和字段的注解信息，必须通过Java的反射技术来获取 Annotation 对象，因为你除此之外没有别的获取注解对象的方法

5. 注解也可以没有定义成员，不过这样注解就没啥用了

PS:自定义注解需要使用到元注解

自定义注解实例1

FruitName.java

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;

/**
 * @ClassName:FruitName.java
 * @Author qcxiao
 * @Date:2020年7月29日下午7:46:36
 * @Version:6.0
 * @Description:
 */
//在字段上使用
@Target(ElementType.FIELD)
//运行时
@Retention(RetentionPolicy.RUNTIME)
//生成文档
@Documented
public @interface FruitName {
        //可传参value，默认为“”
    String value() default "";
}

FruitColor.java

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;

/**
 * @ClassName:FruitColor.java
 * @Author qcxiao
 * @Date:2020年7月29日下午7:49:18
 * @Version:6.0
 * @Description:
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FruitColor {
    
     /**
     * 颜色枚举
     */
    public enum Color{ BLUE,RED,GREEN};

    /**
     * 颜色属性
     */
    Color fruitColor() default Color.GREEN;

}

Apple.java

/**
 * @ClassName:Apple.java
 * @Author qcxiao
 * @Date:2020年7月29日下午7:54:33
 * @Version:6.0
 * @Description:
 */
public class Apple {
        //利用注解将其注解为名字注解为Apple
         @FruitName("Apple")
        private String appleName;
         //颜色注解为红色
        @FruitColor(fruitColor=Color.RED)
        private String appleColor;
//省略get与set      

}

FruitInfoUtil.java

import java.lang.reflect.Field;

public class FruitInfoUtil {
    
    public static void getFruitInfo(Class<?> clazz){

        String strFruitName=" 水果名称：";
        String strFruitColor=" 水果颜色：";
        //获取所有当前的方法
        Field[] fields = clazz.getDeclaredFields();

        for(Field field :fields){
            if(field.isAnnotationPresent(FruitName.class)){
                //获取属性上的注解
                FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class);
                strFruitName=strFruitName+fruitName.value();
                System.out.println(strFruitName);
            }
            else if(field.isAnnotationPresent(FruitColor.class)){
                FruitColor fruitColor= (FruitColor) field.getAnnotation(FruitColor.class);
                strFruitColor=strFruitColor+fruitColor.fruitColor().toString();
                System.out.println(strFruitColor);
            }
        }
    }
    
    

}

FruitRun.java

/**
 * 输出结果
 */
public class FruitRun {
    public static void main(String[] args) {
        FruitInfoUtil.getFruitInfo(Apple.class);
    }
}

运行结果是：

水果名称：Apple
水果颜色：RED

三：简单窥探Mybatis等映射原理

Table注解

@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
    String value();
}

属性注解

@Retention(RetentionPolicy.RUNTIME)
public @interface Propety {
    String name();
    int leng() default 0;

}

注解使用

@Table("db_table_student")
public class Student {
    @Propety(name="student_id",leng=10)
    private String studentId;
    @Propety(name="student_name")
    private String studentName;
}

生成SQL

public class FruitRun {
    public static void main(String[] args) throws ClassNotFoundException {
        //FruitInfoUtil.getFruitInfo(Apple.class);
        Class<?> forName = Class.forName("com.infosky.cfps.modules.base.ucservice.Student");
        Field[] declaredFields = forName.getDeclaredFields();
        
        StringBuffer sf = new StringBuffer();
        sf.append("select ");
        int i=0;
        for (Field field : declaredFields) {
            Propety propety = field.getDeclaredAnnotation(Propety.class);
            sf.append(propety.name());
            if(i<declaredFields.length-1) {
                sf.append(" ,  ");
            }
            i++;
        }
        
        Table declaredAnnotation = forName.getAnnotation(Table.class);
        sf.append(" form "+ declaredAnnotation.value());
        System.out.println(sf.toString());
        
        
    }

}

完成