Annotation(注解)

什么是Annotation(注解)?

  Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档,跟踪代码中的依赖性,甚至执行基本编译时检查。从某些方面看,annotation就像修饰符一样被使用,并应用于包、类 型、构造方法、方法、成员变量、参数、本地变量的声明中。这些信息被存储在Annotation的“name=value”结构对中。

作用

 

a. 标记,用于告诉编译器一些信息

b. 编译时动态处理,如动态生成代码

c. 运行时动态处理,如得到注解信息

 


  Java注解可以用在构建期。当构建我们的工程时,构建进程会编译源码、生成xml文件,打包编译后的代码和文件到jar包。构建过程一般由构建工具自动完成,常用的构建工具有ant、maven。构建工具在构建时会自动扫描我们的代码,当遇到构建期注解时,会根据注解的内容生成源码或者其它文件。

 

注解的格式

 

a)一个java注解由一个@符后面跟一个字符串构成,例如:@name

 

b)java注解中一般包含一些元素,这些元素类似于属性或者参数,可以用来设置值,例如@Enity(name="jiang",age="20")

 

使用细节

 

  注解可以用于描述一个类、接口、方法、方法参数、字段、局部变量等。

 

 1.如果注解没有参数则不用写参数体

 

 2.如果只有一个参数比如named value,则参数名可以省略

 

 3.也可以同时使用多个注解来标示

 

 4.可以重复使用注解,不过只有在java SE 8 才支持

 

Java 常用注解

 

内置注解

 

  • @Override 表示当前方法覆盖了父类的方法,主要用在一个子类的方法中。
  • @Deprecated 表示方法已经过时,java不赞成使用这些被描述的对象方法上有横线,使用时会有警告
  • @SuppviseWarnings 表示关闭一些警告信息(通知java编译器忽略特定的编译警告,例如进行了一个不安转的类型转换)。

 

元注解:用来描述注解的注解

 

  • @Documented:告诉JavaDoc工具,当前注解本身也要显示在Java Doc中。

 

  • @Retention:用来定义当前注解的作用范围,有以下范围:

 

    • RetentionPolicy.SOURCE : 注解只存在于源码中,不会存在于.class文件中,在编译时会被忽略掉
    • RetentionPolicy.CLASS:注解只存在于.class文件中,在编译期有效,但是在运行期会被忽略掉,这也是默认范围
    • RetentionPolicy.RUNTIME:在运行期有效,JVM在运行期通过反射获得注解信息。

 

  • @Target:用于指定注解作用于java的哪些元素,未标注则表示可修饰所有。
  • @Inherited:表示当前注解会被注解类的子类继承。

 

自定义注解

 

  使用@interface自定义注解时,自动继承了java.lang.annotation.Annotation接口,由编译程序自动完成其他细节。在定义注解时,不能继承其他的注解或接口。@interface用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)。可以通过default来声明参数的默认值。

 

       定义注解格式:
          public @interface 注解名 {定义体}

 

  注解参数的可支持数据类型:

 

    1.所有基本数据类型(int,float,boolean,byte,double,char,long,short)
    2.String类型
    3.Class类型
    4.enum类型
    5.Annotation类型
    6.以上所有类型的数组

 

       注解元素必须有确定的值,要么在定义注解的默认值中指定,要么在使用注解时指定,非基本类型的注解元素的值不可为null。因此, 使用空字符串或0作为默认值是一种常用的做法。这个约束使得处理器很难表现一个元素的存在或缺失的状态,因为每个注解的声明中,所有元素都存在,并且都具有相应的值,为了绕开这个约束,我们只能定义一些特殊的值,例如空字符串或者负数,一次表示某个元素不存在,在定义注解时,这已经成为一个习惯用法。

 

posted @ 2019-04-17 16:49  夏前波大帅B  阅读(337)  评论(0编辑  收藏  举报