注解学习

注解

1、格式

public @interface 注解名称{
属性列表;
}

2、注解就像标签，是程序判断执行的依据。

比如，程序读到@Test就知道这个方法是待测试方法，而@Before的方法要在测试方法之前执行注解需要三要素：定义、使用、读取并执行注解分为自定义注解、JDK内置注解和第三方注解（框架）。自定义注解一般要我们自己定义、使用、并写程序读取，而JDK内置注解和第三方注解我们只要使用，定义和读取都交给它们大多数情况下，三角关系中我们只负责使用注解，无需定义和执行，框架会将注解类和读取注解的程序隐藏起来，除非阅读源码，否则根本看不到。

以平时用的testng中的@Test为例：
@java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy.RUNTIME)
@java.lang.annotation.Target({java.lang.annotation.ElementType.METHOD, java.lang.annotation.ElementType.TYPE, java.lang.annotation.ElementType.CONSTRUCTOR})
public @interface Test {
java.lang.String[] groups() default {};

boolean enabled() default true;

/**
 * @deprecated
 */
@java.lang.Deprecated
java.lang.String[] parameters() default {};

java.lang.String[] dependsOnGroups() default {};

java.lang.String[] dependsOnMethods() default {};

long timeOut() default 0L;

long invocationTimeOut() default 0L;

int invocationCount() default 1;

int threadPoolSize() default 0;

int successPercentage() default 100;

java.lang.String dataProvider() default "";

java.lang.Class dataProviderClass() default java.lang.Object.class;

boolean alwaysRun() default false;

java.lang.String description() default "";

java.lang.Class[] expectedExceptions() default {};

java.lang.String expectedExceptionsMessageRegExp() default ".*";

java.lang.String suiteName() default "";

java.lang.String testName() default "";

/**
 * @deprecated
 */
boolean sequential() default false;

boolean singleThreaded() default false;

java.lang.Class retryAnalyzer() default java.lang.Class.class;

boolean skipFailedInvocations() default false;

boolean ignoreMissingDependencies() default false;

int priority() default 0;

}

3、

@Retention注解
@Retention指定注解应该保留多长时间，默认是RetentionPolicy.CLASS。
SOURCE 不包含在类文件中
CLASS 包含在类文件中，不载入虚拟机
RUNTIME 包含在类文件中，由虚拟机载入，可以用反射API获取
@Test注解会载入到虚拟机，可以通过代码获取
@Retention(RetentionPolicy.RUNTIME)
public @interface Test { ... }
平时使用的是RUNTIME

4、@Target注解

@Target注解用于限制注解能在哪些项上应用，没有加@Target的注解可以应用于任何项上。
TYPE 在【类、接口、注解】上使用
FIELD 在【字段、枚举常量】上使用
METHOD 在【方法】上使用
PARAMETER 在【参数】上使用
CONSTRUCTOR 在【构造器】上使用
LOCAL_VARIABLE 在【局部变量】上使用
ANNOTATION_TYPE 在【注解】上使用
PACKAGE 在【包】上使用
TYPE_PARAMETER 在【类型参数】上使用 Java 1.8 引入
TYPE_USE 在【任何声明类型的地方】上使用 Java 1.8 引入
平时用TYPE、CONSTRUCTOR、METHOD

5、@Documented注解

主要用于归档工具识别。被注解的元素能被Javadoc或类似的工具文档化。

6、@Inherited注解

添加了@Inherited注解的注解，所注解的类的子类也将拥有这个注解

6、@Repeatable注解

Java 1.8 引入的注解，标识注解是可重复使用的。

7、支持的元素类型

8种基本数据类型（byte，short，char，int，long，float，double，boolean）
String
Class
enum
注解类型
数组（所有上边类型的数组）

8、Java内置的注解

@Override注解
告诉编译器这个是个覆盖父类的方法。如果父类删除了该方法，则子类会报错。

@Deprecated注解
表示被注解的元素已被弃用。

@SuppressWarnings注解
告诉编译器忽略警告。

@FunctionalInterface注解
Java 1.8 引入的注解。该注释会强制编译器javac检查一个接口是否符合函数接口的标准。

9、@controller 控制器（注入服务）

用于标注控制层，相当于struts中的action层

@service 服务（注入dao）
用于标注服务层，主要用来进行业务的逻辑处理

@repository（实现dao访问）
用于标注数据访问层，也可以说用于标注数据访问组件，即DAO组件.

@component （把普通pojo实例化到spring容器中，相当于配置文件中的 ）
泛指各种组件，就是说当我们的类不属于各种归类的时候（不属于@Controller、@Services等的时候），我们就可以使用@Component来标注这个类。