胖蔡说技术
随便扯扯

Java annotation使用介绍

介绍

Annotation的中文名字叫注解,开始与JDK 1.5,为了增强xml元数据和代码的耦合性的产物。注解本身并没有业务逻辑处理,仅仅是一个声明,具体的处理需要交由使用这些注解的工具类或方法,原则上来说,注解应该是对代码书写的一个辅助,即注解是否存在均不能影响代码的正常运行。现在java中使用注解的场景是越来越多,如orm框架,Ioc框架等,开发人员使用注解的方式可以简化对于元数据的维护和构建(xml配置数据),接下来主要介绍自定义注解的方法和如何使用自定义注解。

自定义注解

和注解相关的java文件的位置在java.lang.annotation包下自定义注解比较简单 格式和一般的java文件类似,声明如下:

@Documented
@Target(ElementType.TYPE)
@Retentiion(RetentionPolicy.RUNTIME)
@Inherited
public @interface annotation{
       int value() default -1;
}

如上所示就是一般注解定义的格式,其中在声明注解之前需要定义注解的使用场景等信息,即添加元注解,java提供的元注解有四类,介绍如下:

1)@Documented
     一个简单的问但包含注解,添加即代表注解包含在Javadoc中,我们可以通过javadoc -d doc *.java生成一个java的doc文档。

2)@Target
     声明注解的使用场景,默认为可用于任何场景,参数类型为枚举,包括的属性有如下:

  • ElementType.TYPE:在class,interface(包括@interface),enum声明前
  • ElementType.FIELD:全局变量前
  • ElementType.METHOD:方法前
  • ElementType.PARAMETER:方法参数前
  • ElementType.CONSTRUCTOR:构造方法前
  • ElementType.LOCAL_VARIABLE:方法内部参数前
  • ElementType.ANNOTATION_TYPE:@interface前
  • ElementType.PACKAGE:用于记录java文件的package信息

3)@Retention
     定义该注解的生命周期,参数类型如下:

  • RetentionPolicy.SOURCE:编译器要丢弃的注释。
  • RetentionPolicy.CLASS: 编译器将把注释记录在类文件中,但在运行时 VM 不需要保留注释。默认为该属性
  • RetentionPolicy.RUNTIME:编译器将把注释记录在类文件中,在运行时 VM 将保留注释,因此可以反射性地读取。

4)@Inherited
     该注解表明子类继承该注解,反之不继承。

使用

使用分三段介绍:首先给出注解的定义,然后给出注解的使用方式,最后给出注解的逻辑处理方法。

自定义一个注解

注解的自定义声明为@interface默认继承Annotation接口,格式如下:

/**
 * @date 17-2-8.
 * @className ClassTypeModel
 * @serial 1.0.0
 * @see Target @Target:设置注释引用的类型
 * @see ElementType  注释引用类型枚举 ElementType.TYPE:class interface(包括annotation),enum引用
 * @see Retention @Retention:注释适用范围
 * @see RetentionPolicy  注释使用类型枚举
 */

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@AnnotationTypeModel
public @interface TypeModel {
    String value() default "TypeModel";
    int id() default -7;
    boolean isActive() default false;
    int value () default -1;

}

如上,注解中的方法的返回可以通过 default 设置默认返回值。

注解的引用

注解的使用需要根据注解已经声明的使用场景中使用,否则会包类型不匹配错误,使用如下:

@TypeModel(id = 7, isActive = true,value = "MyClass")

public class MyClass {

    @ConstructorTypeModel(id = 1000,isActive = true,value = "MyClass")
    public MyClass(){
        System.out.print("this is MyClass ConstructorTypeModel\n");
        annotatioinTestMethod(true);
    }


    @FieldTypeModel(id = 10,isActive = true,value = "type")
    private String type;
    @FieldTypeModel(id = 11,isActive = true,value = "name")
    private String name;
    @FieldTypeModel(id = 10,isActive = true,value = "favorite")
    private String favorite;


    @MethodTypeModel(id = 5,isActive = true,value = "annotatioinTestMethod")
    private void annotatioinTestMethod(@ParamTypeModel(id = 6,isActive = true,value = "testparam") boolean isTest){
        @LocalVarTypeModel(isActive = true)
        boolean flag=isTest;
        System.out.print("this is annotationTestMethod.\n");

    }
    ......
 }

注解的处理

注解在使用后我们可以通过java反射的原理获取到注解的值,方便从而方便我们之后的业务逻辑处理,处理如下:

/**
     * 通过反射获取注入的内容
     */
    private static void reflectAnnotations(){
        MyClass myClass=new MyClass();
//        //only jdk over 1.8
//        MyClass myClass1=new @UseTypeModel(isActive = true) MyClass();
        Class<?> tClass=myClass.getClass();
        Annotation[] annotations= tClass.getDeclaredAnnotations();
        annotationPrint(annotations,"classAnnotations");
        Constructor<?>[] constructors=  tClass.getDeclaredConstructors();
        System.err.println("Constructor of all.\n");
        for (Constructor<?> constructor:constructors){
            Annotation[] constructorDeclaredAnnotations= constructor.getDeclaredAnnotations();
            annotationPrint(constructorDeclaredAnnotations,"constructorDeclaredAnnotations");
        }

        System.err.println("Methods of all.\n");
        Method[] methods=tClass.getDeclaredMethods();
        for (Method method:methods){
            Annotation[]  methodAnnotation=method.getDeclaredAnnotations();


            annotationPrint(methodAnnotation,"methodAnnotation");

            Annotation[][] paramAnnotations= method.getParameterAnnotations();
            for (Annotation[] annotation: paramAnnotations){
                annotationPrint(annotation,"paramAnnotations");
            }

        }
        System.err.println("Field of all.\n");
        Field[] fields=tClass.getDeclaredFields();

        for (Field field:fields){
            Annotation[] filedAnnotations=  field.getDeclaredAnnotations();
            annotationPrint(filedAnnotations,"filedAnnotations");
        }

    }




    private static void annotationPrint(Annotation[] annotations,String type){
        for (Annotation annotation: annotations){
            System.out.println(type+" toString:"+annotation.toString()+"\n");
            Class<?> clazz= annotation.annotationType();
            System.out.println("annotation class name:"+clazz.getName());
            Annotation[] declaredAnnotations= clazz.getDeclaredAnnotations();
            //注释的注释
            for (Annotation annotation1:declaredAnnotations){
                System.out.println(annotation.getClass().getSimpleName()+" annotation toString:"+annotation1.toString()+"\n");
            }
        }
    }

如上就是一个简单的注解demo介绍.

源码

源码下载地址:annotationdemojava

赞(0) 打赏
转载请附上原文出处链接:胖蔡叨叨叨 » Java annotation使用介绍
分享到: 更多 (0)

请小编喝杯咖啡~

支付宝扫一扫打赏

微信扫一扫打赏