Introduction of Annotation

Annotation介绍

概念

注解Annotation是java 1.5的新特性，是一种能够添加到 Java 源代码的语法元数据。类、方法、变量、参数、包都可以被注解，可用来将信息元数据与程序元素进行关联。

作用

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作为默认值是一种常用的做法。这个约束使得处理器很难表现一个元素的存在或缺失的状态，因为每个注解的声明中，所有元素都存在，并且都具有相应的值，为了绕开这个约束，我们只能定义一些特殊的值，例如空字符串或者负数，一次表示某个元素不存在，在定义注解时，这已经成为一个习惯用法。

上手实验

a.java
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;/*** * 水果名称注解**/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface front{ //自定义注解 @frontString value() default "";
}b.java

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;
/*** * 水果颜色注解**/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documentedpublic @interface behind{//自定义注解@behindpublic enum Color{bule,red,green}Color Behind() default Color.red;
}

c.java 部分

    @front("Apple")private String appleName;@behind(Behind=Color.green)private  String appleColor;public void setAppleColor(String appleColor) {this.appleColor = appleColor;}

在之前没有具体了解清楚annotation的功能，以为在注解之后相应的变量会被赋值，所以在进行调试的时候看到变量的值一直都是null,为此感到很困惑，以为是自己的哪些方法不对。后来通过仔细查阅发现annotation仅仅是类似于标签以及接口，对代码的运行没有起到什么效果。

总结

如果注解难于理解，你就把它类同于标签，标签为了解释事物，注解为了解释代码。
注解的基本语法，创建如同接口，但是多了个 @ 符号。
注解的元注解。
注解的属性。
注解主要给编译器及工具类型的软件用的。
注解的提取需要借助于 Java 的反射技术，反射比较慢，所以注解使用时也需要谨慎计较时间成本。

the examples in Hello1.java

hello1 ：一个基于JavaServer Faces技术的应用程序，它使用两个XHTML页面和一个托管bean

首先需要了解构造型：一种指定一下内容的注释：

默认范围
零个或多个拦截器绑定
（可选）@Named注释，保证默认EL命名
（可选）@Alternative注释，指定具有此构造型的所有bean都是备选方案

CDI提供了一个名为的内置构造型Model，它用于定义模型 - 视图 - 控制器应用程序架构的模型层的bean。这个构造型指定bean是@Named和@RequestScoped：

@Named
@RequestScoped
@Stereotype
@Target({TYPE, METHOD, FIELD})
@Retention(RUNTIME)
public @interface Model {}

import javax.enterprise.context.RequestScoped;
/*** 虽然RequestScoped必须与规范要求的内置请求上下文相关联，但允许第三方扩展将其与自己的上下文相关联。* 指定bean是请求范围的* 1.请求范围处于活动状态  * 2.请求上下文被销毁*/
import javax.inject.Named;
/*** 基于字符串的限定符* Example usage:public class Car {@Inject @Named("driver") Seat driverSeat;@Inject @Named("passenger") Seat passengerSeat;...}*如果使用bean类的默认名称，则可以指定@Model 为注释，而不必同时指定@Named和@RequestScoped.*该@Model注释被称为刻板印象，对于封装等注解注释的术语。*/
//
@Named
@RequestScoped
public class Hello {}

部分借鉴于：https://blog.csdn.net/u013703461/article/details/66259013

https://blog.csdn.net/briblue/article/details/73824058

非常感谢~

转载于:https://www.cnblogs.com/sece/p/10565637.html