java之美妙的注解

 

注解

一、认识注解

先看百度百科对java注解的解释:

定义:注解(Annotation),也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。

作用分类:

①编写文档:通过代码里标识的元数据生成文档【生成文档doc文档】

② 代码分析:通过代码里标识的元数据对代码进行分析【使用反射】

③编译检查:通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】

提到的元数据,可以理解为描述数据的数据,看起来很绕,元注解也是描述注解的注解,后面说。

Annotation都是java.lang.annotation.Annotation接口的子接口,注解是一种特殊的接口,从代码格式上来看确实是,是在interface前加了一个@符号,格式为@interface xxx{}

二、JDK内置注解

jdk就存在注解,比如我们用eclipse子类覆盖父类方法时候用快捷间alt+/会自带在方法名称上面贴上一个@Override的标签。

  • @Override

    这个就是在子类覆盖父类的方法时候,经常遇到

  • @Deprecated

    这个元素是用来标记过时的元素,想必大家在日常开发中经常碰到。编译器在编译阶段遇到这个注解时会发出提醒警告,告诉开发者正在调用一个过时的元素比如过时的方法、过时的类、过时的成员变量。 如java.util.Data类中有很多过时的方法

  • @SupressWarings

    抑制警告,有很多人有代码洁癖,看到黄色的警告不爽,用它就可以抑制住。

  • @SafeVarargs

    java7出现的,抑制堆污染警告,有点自欺欺人的感觉。

三、元注解

元注解就是注解的注解,来看一下有哪些元注解

  • @Retention

    Retention英文是保留的意思,在这里可以约束注解的存活周期,代码运行有三个周期,分别为Source(源代码)、Class(字节码)、Runtime(运行时期) 三个时期的值保留在RetentionPolicy这个枚举类中。所以我们可以这样来玩,

    @Retention(RetetionPolicy.常量值)//RESOURCE,CLASS,RUNTIME

  • @Target

    Target是目标的意思,这里约束这个注解在那可以贴(类,方法,构造器,参数等),位置的常量在ElementType这个枚举类中

    @Target({ElementsType.常亮值})//TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, TYPE表示类,接口,枚举

  • @Documented

    Document文档的意思,也就是使用这个标签到时候会带到API文档中去

  • @Inherited

    Inherited是遗传的意思,顾名思义,这个注解会遗传到子类去

  • @Repeatable 可重复的,Java8的一个新特性

四、自定义注解

1.注解的属性

在注解中定义属性,必须是8 种基本数据类型外加 类、接口、注解及它们的数组。不能是Integer..注解中属性可以有默认值,默认值需要用 default 关键值指定。

如:

@interface TestAnnotation{     int id() default 0;     String msg() default "hello"; } @TestAnnotation(id = 3,msg = "aa") class Test1{      }  //当注解中只有一个value属性时候,贴标签的时候可以省略value。 //当注解中没有属性时,括号都可以省略(override注解) @interface Test1Annotation{     int[] value(); } @Test1Annotation({1,2}) class Test2{      }

2.用反射操作注解

注解可以在类Class,方法Method,字段Field,构造器Constructor上等,所以在各自的类中都存在获取注解的API

 boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)   如果指定类型的注释存在于此元素上,则返回 true,否则返回 false。   Annotation[] getAnnotations() 返回此元素上存在的所有注释。   <Annotation>  getAnnotation(Class annotationClass)如果存在该元素的指定类型的注释,则返回这些注释对象,否则返回 null。 获取注解对象

自定义一个注解:

@Target({TYPE, FIELD, METHOD})//注解可以放的目标 @Retention(RetentionPolicy.RUNTIME)//注解保留周期 public 
                        
关键字:
50000+
5万行代码练就真实本领
17年
创办于2008年老牌培训机构
1000+
合作企业
98%
就业率

联系我们

电话咨询

0532-85025005

扫码添加微信