黑马程序员java高新技术——注解

什么是注解：

注解是java 的一个新的类型（与接口很相似），它与类、接口、枚举是在同一个层次，它们都称作为java 的一个类型（TYPE）。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。它的作用非常的多，例如:进行编译检查、生成说明文档、代码分析等。

JDK提供的几个基本注解
a. @SuppressWarnings
该注解的作用是阻止编译器发出某些警告信息。

它可以有以下参数:
deprecation：过时的类或方法警告。
unchecked：执行了未检查的转换时警告。
fallthrough：当Switch 程序块直接通往下一种情况而没有Break 时的警告。
path：在类路径、源文件路径等中有不存在的路径时的警告。
serial：当在可序列化的类上缺少serialVersionUID 定义时的警告。
finally：任何finally 子句不能完成时的警告。
all：关于以上所有情况的警告。

@SuppressWarnings("unchecked", "deprecation")告诉编译器同时忽略unchecked和deprecation的警告信息。
b. @Deprecated
该注解的作用是标记某个过时的类或方法。

c. @Override
该注解用在方法前面，用来标识该方法是重写父类的某个方法。
元注解

d. @Retention
它是被定义在一个注解类的前面，用来说明该注解的生命周期。
它有以下参数：
RetentionPolicy.SOURCE：指定注解只保留在一个源文件当中。
RetentionPolicy.CLASS：指定注解只保留在一个class 文件中。
RetentionPolicy.RUNTIME：指定注解可以保留在程序运行期间。

e. @Target
它是被定义在一个注解类的前面，用来说明该注解可以被声明在哪些元素前。
它有以下参数：
ElementType.TYPE：说明该注解只能被声明在一个类前。
ElementType.FIELD：说明该注解只能被声明在一个类的字段前。
ElementType.METHOD：说明该注解只能被声明在一个类的方法前。
ElementType.PARAMETER：说明该注解只能被声明在一个方法参数前。
ElementType.CONSTRUCTOR：说明该注解只能声明在一个类的构造方法前。
ElementType.LOCAL_VARIABLE：说明该注解只能声明在一个局部变量前。
ElementType.ANNOTATION_TYPE：说明该注解只能声明在一个注解类型前。
ElementType.PACKAGE：说明该注解只能声明在一个包名前。

注解的生命周期
一个注解可以有三个生命周期，它默认的生命周期是保留在一个CLASS 文件，但它也可以由一个@Retetion 的元注解指定它的生命周期。
a. java 源文件
当在一个注解类前定义了一个@Retetion(RetentionPolicy.SOURCE)的注解，那么说明该注解只保留在一个源文件当中，当编译器将源文件编译成class 文件时，它不会将源文件中定义的注解保留在class 文件中。
b. class 文件中
当在一个注解类前定义了一个@Retetion(RetentionPolicy.CLASS)的注解，那么说明该注解只保留在一个class 文件当中，当加载class 文件到内存时，虚拟机会将注解去掉，从而在程序中不能访问。
c. 程序运行期间当在一个注解类前定义了一个@Retetion(RetentionPolicy.RUNTIME)的注解，那么说明该注解在程序运行期间都会存在内存当中。此时，我们可以通过反射来获得定义在某个类上的所有注解。

注解的定义
一个简单的注解：
public @interface Annotation01 {
//定义公共的final静态属性
.....
//定以公共的抽象方法
......
} 

a. 注解可以有哪些成员
注解和接口相似，它只能定义final 静态属性和公共抽象方法。
b. 注解的方法
1.方法前默认会加上public abstract
2.在声明方法时可以定义方法的默认返回值。
例如:
String color() default "blue";
String[] color() default {"blue", "red",......}
3.方法的返回值可以有哪些类型
8 种基本类型，String、Class、枚举、注解及这些类型的数组。
c. 使用注解（参照下面的注解使用）

package sun.itcast;
@ItcastAnnotation//此处可以加多个注释
public class AnnotationTest {
    @SuppressWarnings("deprecation")//阻止警告信息
    public static void main(String[] args) throws Exception{
    // TODO Auto-generated method stub
    System.runFinalizersOnExit(true);
    AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class);
    ItcastAnnotation annotation =(ItcastAnnotation)AnnotationTest.class.
    
getAnnotation(ItcastAnnotation.class);
    System.out.println(annotation);//控制台此句不能打印 说明if结果是false
    }
    @Deprecated//过时
    public static void Hello(){
    System.out.println("hello");
    }
}

<pre name="code" class="java">package sun.itcast;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//元注解 就是对注解再注解 元信息 信息的信息  元数据 数据的数据 
@Retention(RetentionPolicy.RUNTIME)
//指示注释类型的注释要保留多久。如果注释类型声明中不存在 Retention 注释，
//则保留策略默认为 RetentionPolicy.CLASS。
//@Target(ElementType.METHOD)//注解只能用在方法上
@Target({ElementType.METHOD,ElementType.TYPE})//表示注解可以用在方法上 类上 接口上 枚举上等
//指示注释类型所适用的程序元素的种类。
//如果注释类型声明中不存在 Target 元注释，则声明的类型可以用在任一程序元素上。
//如果存在这样的元注释，则编译器强制实施指定的使用限制。 例如，此元注释指示该声明类型是其自身，即元注释类型。
public @interface ItcastAnnotation {
}

注解的使用

注解的使用分为三个过程。定义注解-->声明注解-->得到注解a. 定义注解（参照上面的注解定义）b. 声明注解

1. 在哪些元素上声明注解
如果定义注解时没有指定@Target 元注解来限制它的使用范围，那么该注解可以使用在ElementType 枚举指定的任何一个元素前。否则，只能声明在@Target 元注解指定的元素前。

一般形式：
@注解名()

2. 对注解的方法的返回值进行赋值
对于注解中定义的每一个没有默认返回值的方法，在声明注解时必须对它的每一个方法的返回值进行赋值。
一般形式:
@注解名(方法名=方法返回值，、、、、、、)
如果方法返回的是一个数组时，那么将方法返回值写在{}符号里
@注解名(方法名={返回值1，返回值2，、、、、、、}，、、、、、、、)

3. 对于只含有value 方法的注解，在声明注解时可以只写返回值。

c. 得到注解
对于生命周期为运行期间的注解，都可以通过反射获得该元素上的注解实例。
1、声明在一个类中的注解
可以通过该类Class 对象的getAnnotation 或getAnnotations 方法获得。
2、声明在一个字段中的注解
通过Field 对象的getAnnotation 或getAnnotations 方法获得
3、声明在一个方法中的注解
通过Method 对象的getAnnotation 或getAnnotations 方法获得

总结
注解可以看成是一个接口，注解实例就是一个实现了该接口的动态代理类。
注解大多是用做对某个类、方法、字段进行说明，标识的。以便在程序运行期间我们通过反射获得该字段或方法的注解的实例，来决定该做些什么处理或不该进行什么处理