java 注解知识整理

一、前言

注解（也称为元数据）为我们在代码中添加信息提供了一种方法，它在一定程度上将元数据与源代码文件结合在一起。它是从java 5 开始引入的。通过使用注解，我们可以将元数据保存在Java源代码之中，并利用annotation API为注解构造处理工具。

二、语法

●从语法的角度来看，注解的使用方式几乎与修饰符的使用一模一样。它的元素看起来就像接口的方法，唯一的区别是你可以为其指定默认值。

●注解包过三种标准注解和四种元注解，以及自定义注解。

★★★标准注解★★★

@Override：方法的覆盖

@Deprecated：弃用，表示当前api停止使用

@SuppressWarnings：关闭不当的编译器警告信息。

★★★元注解★★★

@Target：表示该注解作用于什么地方

ElementType.FIELD    // 字段、枚举的常量
　　ElementType.METHOD                  // 方法
　　ElementType.PARAMETER)          // 方法参数
　　ElementType.CONSTRUCTOR    // 构造函数
　　ElementType.LOCAL_VARIABLE // 局部变量
　　ElementType.ANNOTATION_TYPE   // 注解
　　ElementType.PACKAGE           // 包

@Retention:保存注解信息的级别

RetentionPolicy.SOURCE    // 注解仅存在于源码中，在class字节码文件中不包含
       RetentionPolicy.CLASS     // 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得
       RetentionPolicy.RUNTIME   // 注解会在class字节码文件中存在，在运行时可以通过反射获取到

@Documented：将此注解包含在Javadoc中

@Inherited：允许子类继承父类中的注解

●编译器对元素的默认值过分挑剔。也就是说，元素要么具有默认值，要么必须在使用注解时提供元素的值。其次，对于非基本类型的元素，无论在源码中声明，还是在注解接口中定义默认值，都不能以null作为其值。为了避开这个约束，可以定义一些特殊的值，如空字符串或是负数，比如（-1）等。这也是在定义注解时，一个习惯用法。

三、自定义注解demo

 @Documented

 @Inherited

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

 @Retention(RetentionPolicy.RUNTIME)

 public @interface Init

 {

     public String value() default "";

 }

 public class User

 {

     private String name;

     private String age;

     public String getName()

     {

         return name;

     }

     @Init(value = "lee")

     public void setName(String name)

     {

         this.name = name;

     }

     public String getAge()

     {

         return age;

     }

     @Init(value = "66")

     public void setAge(String age)

     {

         this.age = age;

     }

 }

 public class UserFactory

 {

     public static User create()

     {

         User user = new User();

         // 获取User类中所有的方法（getDeclaredMethods也行）

         Method[] methods = User.class.getMethods();

         try

         {

             for (Method method : methods)

             {

                 // 如果此方法有注解，就把注解里面的数据赋值到user对象

                 if (method.isAnnotationPresent(Init.class))

                 {

                     Init init = method.getAnnotation(Init.class);

                     method.invoke(user, init.value());

                 }

             }

         }

         catch (Exception e)

         {

             e.printStackTrace();

             return null;

         }

         return user;

     }

 }

 public class Test

 {

     public static void main(String[] args) throws IllegalAccessException,

             IllegalArgumentException, InvocationTargetException

     {

         User user = UserFactory.create();

         System.out.println(user.getName());

         System.out.println(user.getAge());

     }

 }

大家可以自己执行代码，看看结果。

参考文章：

《Thinking in Java》

https://www.cnblogs.com/liangweiping/p/3837332.html

----------------------------------------------------------------------

巴特西

java 注解知识整理

最新文章

热门文章

巴特西

java 注解 知识整理

最新文章

热门文章

java 注解知识整理