Java深入 - 深入 Java自己定义注解

时间：2022-09-12 14:25:11

我们在使用Spring框架的时候，会常常使用类似：@Autowired 这种注解。

我们也能够自定义一些注解。Java的注解主要在包：java.lang.annotation中实现。

1. 元注解

什么是元注解？你能够这样理解。元注解是自己定义注解的注解。

元注解主要包括4个。

他们主要在java.lang.annotation中能够找到。

我们自己要创建注解的时候必需要用到这些元注解。

所以必须彻底理解这四个元注解的含义。

1. @Documented

2. @Inherited

3. @Retention

4. @Target

比如：

package com.test.www;

import java.lang.annotation.Documented;

import java.lang.annotation.ElementType;

import java.lang.annotation.Inherited;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

/**

 * 定义一个username的自己定义注解

 * @author zhuli

 * @date 2014-7-5

 */

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target({ ElementType.TYPE, ElementType.METHOD})

@Inherited

public @interface UserNameAnnotations {

    public String value() default "";

}

1. @Documented

@Documented用于描写叙述其他类型的annotation应该被作为被标注的程序成员的公共API，因此能够被比如javadoc此类的工具文档化。

Documented是一个标记注解，没有成员。

2. @Inherited

@Inherited 元注解是一个标记注解。@Inherited阐述了某个被标注的类型是被继承的。

假设一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。

3. @Target

@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法參数和本地变量（如循环变量、catch參数）。

ElementType.CONSTRUCTOR  作用于构造器

ElementType.FIELD  作用于域/属性

ElementType.LOCAL_VARIABLE  用于描写叙述局部变量

ElementType.METHOD  作用于方法

ElementType.PACKAGE   用于描写叙述包

ElementType.PARAMETER   用于描写叙述參数

ElementType.TYPE   用于描写叙述类、接口(包含注解类型) 或enum声明，最经常使用

单个修饰对象的范围：

@Target(ElementType.TYPE)

多个：

@Target({ ElementType.TYPE, ElementType.METHOD})

4. Retention

定义了该Annotation被保留的时间长短：某些Annotation仅出如今源码中，而被编译器丢弃。而还有一些却被编译在class文件里；编译在class文件里的Annotation可能会被虚拟机忽略。而还有一些在class被装载时将被读取（请注意并不影响class的运行，由于Annotation与class在使用上是被分离的）。使用这个meta-Annotation能够对 Annotation的“生命周期”限制。

RetentionPolicy.RUNTIME 注解会在class字节码文件里存在，在执行时能够通过反射获取到

RetentionPolicy.CLASS 默认的保留策略。注解会在class字节码文件里存在，但执行时无法获得

RetentionPolicy.SOURCE 注解仅存在于源代码中，在class字节码文件里不包括

2. 创建一个自己定义注解 - 作用于类

1. 创建一个注解类

package com.test.www;

import java.lang.annotation.Documented;

import java.lang.annotation.ElementType;

import java.lang.annotation.Inherited;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

/**

 * 定义一个username的自己定义注解

 * @author zhuli

 * @date 2014-7-5

 */

@Documented //文档

@Retention(RetentionPolicy.RUNTIME) //在执行时能够获取

@Target({ ElementType.TYPE, ElementType.METHOD}) //作用到类，方法，接口上等

@Inherited //子类会继承

public @interface UserNameAnnotations {

    public String value() default ""; //使用的时候 @UserNameAnnotations(value="xxx")

}

2. 创建一个Test类

package com.test.www;

/**

 * 一个注解的測试类

 * @author zhuli

 * @date 2014-7-5

 */

//注入注解作用于类上面

//能够通过反射 获取类的信息之后 获取得到这个注解的值

@UserNameAnnotations(value = "initphp")

public class Test {

    private String userName;

    public String getUserName() {

        return userName;

    }

    public void setUserName(String userName) {

        this.userName = userName;

    }

}

3. 測试类

package com.test.www;

public class mainTest {

    public static void main(String[] args) {

        Class<Test> testClass = Test.class;

        //由于注解是作用于类上面的，所以能够通过isAnnotationPresent来推断是否是一个

        //有UserNameAnnotations注解的类

        if (testClass.isAnnotationPresent(UserNameAnnotations.class)) {

            System.out.println("this is a Annotations class");

            //通过getAnnotation能够获取注解对象

            UserNameAnnotations userNameAnnotations = (UserNameAnnotations) testClass.

getAnnotation(UserNameAnnotations.class);

            if (userNameAnnotations != null) {

                System.out.println("value:" + userNameAnnotations.value());

            } else {

                System.out.println("null");

            }

        } else {

            System.out.println("this is not Annotations class");

        }

    }

}

4. 输出：

this is a Annotations class

value:initphp

3. 创建一个自己定义注解 - 作用于方法

1. 自己定义注解类

package com.test.www;

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;

/**

 * 定义一个作用到方法的注解

 * @author zhuli.zhul

 * @date 2014-7-5

 */

@Documented//文档

@Retention(RetentionPolicy.RUNTIME)//在执行时能够获取

@Target({ ElementType.TYPE, ElementType.METHOD })//作用到类，方法，接口上等

public @interface MethodType {

    //枚举类型

    public enum MethodTypeEnum {

        TYPE1, TYPE2

    }

    //实际的值

    public MethodTypeEnum methodType() default MethodTypeEnum.TYPE1;

}

2. 创建一个使用注解的类

package com.test.www;

import com.test.www.MethodType.MethodTypeEnum;

/**

 * 一个注解的測试类

 * @author zhuli

 * @date 2014-7-5

 */

//注入注解作用于类上面

//能够通过反射 获取类的信息之后 获取得到这个注解的值

@UserNameAnnotations(value = "initphp")

public class Test {

    private String userName;

    //注解到

    @MethodType(methodType=MethodTypeEnum.TYPE2)

    public String getUserName() {

        return userName;

    }

    public void setUserName(String userName) {

        this.userName = userName;

    }

}

3. 创建main入口

package com.test.www;

import java.lang.reflect.Method;

import com.test.www.MethodType.MethodTypeEnum;

public class mainTest {

    public static void main(String[] args) {

        Class<Test> testClass = Test.class;

        try {

            //由于是注解到method上的。所以首先要获取这种方法

            Method method = testClass.getDeclaredMethod("getUserName");

            //推断这种方法上是否有这个注解

            if (method.isAnnotationPresent(MethodType.class)) {

                System.out.println("this is a method Annotation");

                //假设有这个注解，则获取注解类

                MethodType methodType = (MethodType) method.getAnnotation(MethodType.class);

                if (methodType != null) {

                    if (MethodTypeEnum.TYPE1.equals(methodType.methodType())) {

                        System.out.println("this is TYPE1");

                    } else {

                        System.out.println("this is TYPE2");

                    }

                }

            } else {

                System.out.println("this is not  a method Annotation");

            }

        } catch (Exception e) {

        }

    }

}

4. 输出：

this is a method Annotation

this is TYPE2

4. 创建一个自己定义注解 - 作用于域

1. 创建一个自己定义注解

package com.test.www;

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;

/**

 * 定义一个作用到域上的自己定义注解

 * @author zhuli

 * @date 2014-7-5

 */

@Documented//文档

@Retention(RetentionPolicy.RUNTIME)//在执行时能够获取

@Target({ ElementType.FIELD })//作用到类的域上面

public @interface FieldAnnotations {

    public String value() default ""; //使用的时候 @FieldAnnotations(value="xxx")

}

2. 创建一个使用注解的类

package com.test.www;

import com.test.www.MethodType.MethodTypeEnum;

/**

 * 一个注解的測试类

 * @author zhuli

 * @date 2014-7-5

 */

//注入注解作用于类上面

//能够通过反射 获取类的信息之后 获取得到这个注解的值

@UserNameAnnotations(value = "initphp")

public class Test {

    @FieldAnnotations(value="zhuli")

    private String userName;

    //注解到

    @MethodType(methodType=MethodTypeEnum.TYPE2)

    public String getUserName() {

        return userName;

    }

    public void setUserName(String userName) {

        this.userName = userName;

    }

}

3. 创建main入口类

package com.test.www;

import java.lang.reflect.Field;

public class mainTest {

    public static void main(String[] args) {

        Test test = new Test();

        Class<Test> testClass = Test.class;

        try {

            //由于是注解到Field上的。所以首先要获取这个字段

            Field field = testClass.getDeclaredField("userName");

            //推断这个Field上是否有这个注解

            if (field.isAnnotationPresent(FieldAnnotations.class)) {

                System.out.println("this is a field Annotation");

                //假设有这个注解，则获取注解类

                FieldAnnotations fieldAnnotations = (FieldAnnotations) field.getAnnotation(FieldAnnotations.class);

                if (fieldAnnotations != null) {

                    //通过反射给私有变量赋值

                    field.setAccessible(true);

                    field.set(test, fieldAnnotations.value());

                    System.out.println("value:" + test.getUserName());

                }

            } else {

                System.out.println("this is not  a field Annotation");

            }

        } catch (Exception e) {

        }

    }

}

4. 输出：

this is a field Annotation

value:zhuli

相关文章