注解

注解：

* 概念：说明程序的。给计算机看的

* 注释：用文字描述程序的。给程序员看的

 

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

* 概念描述：

* JDK1.5之后的新特性

* 说明程序的

* 使用注解：@注解名称

 

* 作用分类：

①编写文档：通过代码里标识的注解生成文档【生成文档doc文档】

②代码分析：通过代码里标识的注解对代码进行分析【使用反射】

③编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【Override】

 

 

* JDK中预定义的一些注解

* @Override ：检测被该注解标注的方法是否是继承自父类(接口)的

* @Deprecated：该注解标注的内容，表示已过时

* @SuppressWarnings：压制警告

* 一般传递参数all  @SuppressWarnings("all")

 

* 自定义注解

* 格式：

元注解

public @interface 注解名称{

属性列表;

}

 

* 本质：注解本质上就是一个接口，该接口默认继承Annotation接口

* public interface MyAnno extends java.lang.annotation.Annotation {}

 

* 属性：接口中的抽象方法

* 要求：

1. 属性的返回值类型有下列取值

* 基本数据类型

* String

* 枚举

* 注解

* 以上类型的数组

 

2. 定义了属性，在使用时需要给属性赋值

1. 如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。

2. 如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。

3. 数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略

 

* 元注解：用于描述注解的注解

* @Target：描述注解能够作用的位置

* ElementType取值：

* TYPE：可以作用于类上

* METHOD：可以作用于方法上

* FIELD：可以作用于成员变量上

* @Retention：描述注解被保留的阶段

* @Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到

* @Documented：描述注解是否被抽取到api文档中

* @Inherited：描述注解是否被子类继承

 

 

* 在程序使用(解析)注解：获取注解中定义的属性值

1. 获取注解定义的位置的对象  （Class，Method,Field）

2. 获取指定的注解

* getAnnotation(Class)

//其实就是在内存中生成了一个该注解接口的子类实现对象

 

            public class ProImpl implements Pro{

                public String className(){

                    return "cn.itcast.annotation.Demo1";

                }

                public String methodName(){

                    return "show";

                }

            }

3. 调用注解中的抽象方法获取配置的属性值

 

 

* 案例：简单的测试框架

* 小结：

1. 以后大多数时候，我们会使用注解，而不是自定义注解

2. 注解给谁用？

1. 编译器

2. 给解析程序用

3. 注解不是程序的一部分，可以理解为注解就是一个标签

注解_概念

什么是注解？

就是对程序的解释说明，给计算机看的；

注解有什么用？

1.编写文档；

javadoc

2.编译检查；

3.代码分析(重点)；

 

 

13_注解_JDK内置注解

哪些常见注解？

@Override;

@Deprecated;

@SuppressWarnings(参数);

@SuppressWarnings("all");会压制所有警告；

 

 

14_注解_自定义注解_格式&本质

注解的格式？

元注解

public @interface 注解名{

//

}

注解的本质？

本质是接口，所有的注解都默认继承  java.lang.annotation.Annotaion;

 

注解的属性其本质上就是接口的抽象方法；

 

 

15_注解_自定义注解_属性定义

抽象方法返回值类型？

基本类型；

String;

enum（枚举）;

public final class Person extends java.lang.Enum<Person> {

  public static final Person P1;

  public static final Person P2;

  public static final Person P3;

  public static Person[] values();

  public static Person valueOf(java.lang.String);

  static {};

}

 

枚举的本质就是一个类，并且所有的枚举都默认继承了java.lang.Enum；

 

 

注解；

以上类型的数组；

什么样的情况下，定义的属性在使用的时候可以不给值？

后面加  default 值;

如果属性的名字是value，有什么特点？

只有一个属性需要赋值，并且该属性的名字是value，可以省略value；

给数组赋值时，如果数组中只有一个值，有什么特点？

可以省略大括号

 

16_注解_自定义注解_元注解

元注解什么作用？

解释说明注解；

元注解有哪些？

@Target;

表示注解作用的位置

@Retention;

注解被保留的阶段

@Documented;

可以被抽取到文档中

@Inherited;

可以被子类继承

ElementType.TYPE ,ElementType.METHOD,ElementType.FIELD分别代表的位置？

ElementType.TYPE ,

类

ElementType.METHOD,

方法

ElementType.FIELD

成员变量

ElementType.PARAMETER

参数上

描述自定义注解 @Retention取值一般是什么？

RetentionPolicy.RUNTIME