注解

1.注解的介绍

Annotation(注解)就是Java提供了一种元程序中的元素关联任何信息和任何元数据 (metadata)的途径和方法。

Annotation是一个接口，程序可以通过反射来获取指定程序元素的Annotation对象，然后通过Annotation对象来

获取注解里面的元数据。注解API非常强大，被广泛应用于各种Java框架。

元数据：描述数据的数据

2.注解的分类

根据注解参数的个数分类

1)、标记注解:一个没有成员定义的Annotation类型被称为标记注解。

2)、单值注解:只有一个值

3)、完整注解:拥有多个值

根据注解使用方法和用途分类

1)、JDK内置系统注解

2)、元注解

3)、自定义注解

3.内置注解

3.1@Override:重写注解

限定重写父类方法，若想要重写父类的一个方法时，需要使用该注解告知编译器我们正在重写一个方法。如此一来，当父类的方法被删除或修改了，编译器会提示错误信息；或者该方法不是重写也会提示错误。

public interface Car { 

void run(); 

}

class QQ implements Car{ 

@Override 

public void run() {} 

}

class Bmw implements Car{ 

@Override 

void run() {} 

}

3.2@Deprecated：标记方法已被弃用，但还是可以用的

标记已过时，当我们想要让编译器知道一个方法已经被弃用(deprecate)时，应该使用这个注解。Java推荐在javadoc中提供信息，告知用户为什么这个方法被弃用了，以及替代方法是什么。

/**

\* Deprecated -->该方法过时(有更好的解决方案) 

*/ 

public class TestDeprecated { 

@Deprecated 

public int test(){ 

System.out.println("TestDeprecated.test()"); 

return 0; 

}

public void test(int a){ 

System.out.println("TestDeprecated.test(int)" 

); 

} 

}

3.3@SuppressWarnings：抑制编译器警告

抑制编译器警告，该注解仅仅告知编译器，忽略它们产生了特殊警告。如：在java泛型中使用原始类型。其保持性策略(retention policy)是SOURCE，在编译器中将被丢弃。（all 抑制所有警告）

/**

\* SuppressWarnings 压制警告 

\* @author Administrator 

*/public class TestSuppressWarnings { 

public static void main(String[] args) { 

@SuppressWarnings("unused") 

List<String> list =new 

ArrayList<String>(); 

}

@SuppressWarnings("rawtypes") //没有定义范型 

public static List test(){ 

return new ArrayList(); 

} 

} 

4.元注解：负责注解其他注解

4.1@Target：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）。

表示支持注解的程序元素的种类，一些可能的值有TYPE, METHOD, CONSTRUCTOR, FIELD等等。如果Target元注解不存在，那么该注解就可以使用在任何程序元素之上。

取值(ElementType)有：

CONSTRUCTOR:用于描述构造器

FIELD:用于描述域

LOCAL_VARIABLE:用于描述局部变量

METHOD:用于描述方法

PACKAGE:用于描述包

PARAMETER:用于描述参数

TYPE:用于描述类、接口(包括注解类型) 或enum声明

例：

//此注解只能用在方法上

@Target(ElementType.METHOD)  

@interface TestMethod {}

如果想要定义注解在多个位置，用花括号括起来

例如

@Target({ElementType.METHOD，ElementType.FIELD})

4.2@Retention:表示需要在什么级别保存该注释信息，用于描述注解的生命周期

表示注解类型保留时间的长短。取值(RetentionPoicy)有：

SOURCE:在源文件中有效（即源文件保留）

CLASS:在class文件中有效（即class保留）

RUNTIME:在运行时有效（即运行时保留）

此注解可以用于注解类、接口(包括注解类型) 或enum声 明

4.3@Documented

表示使用该注解的元素应被javadoc或类似工具文档化，它应用于类型声明，类型声明的注解会影响客户端对注解元素的使用。如果一个类型声明添加了Documented注解，那么它的注解会成为被注解元素的公共API的一部分，@Documented是一个标记注解。

//可以被例如javadoc此类的工具文档化 

@Documented 

@interface TestDoc{ 

}

4.4@Inherited

表示一个注解类型会被自动继承，如果用户在类声明的时候查询注解类型，同时类声明中也没有这个类型的注解，那么注解类型会自动查询该类的父类，这个过程将会不停地重复，直到该类型的注解被找到为止，或是到达类结构的顶层（Object）。

//被子类继承的注解 

@Inherited 

@interface TestInherit{}

5.自定义注解

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

注意：
1.默认隐示实现了java.lang.Annotation接口
2.自定义的注解类不能继承其他父类或者实现其他接口
3.注解属性,在属性名的后面添加一对() value()
4.注解类的属性的 修饰符只能为public|default
5.注解类的属性的数据类型只能为基本数据类型,String,annotation,枚举,以上类型的数据
6.如果枚举类的数据只有一个,建议你设置属性名字为value,如果只有一个属性并且属性名字为value,赋值可以省略属性名,否则属性名=属性值
7.使用注解类时候如果存在多个参数 ,需要放在一对{}中赋值
8.使用default为属性添加默认值

例：定义一个员工类,类中为属性上提供一个注解,这个注解作为是为当前属性定义默认值

员工类：Employee

public class Employee {
    @Name
    public String name;

    public Employee() {
    }
    public Employee(String name) {
        this.name = name;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

自定义注解：Name -->表示name默认值应为"小明"

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Name {
    String value() default "小明";
}

测试类：EmployeeTest

public class EmployeeTest {
    public static void main(String[] args) throws Exception {
        Employee employee=new Employee();
        test(employee);
        System.out.println(employee.getName());
    }
    public static void test(Employee employee) throws Exception{
        Class classz=employee.getClass();
        Field field = classz.getField("name");
        if(field.isAnnotationPresent(Name.class))//如果属性有被注解，返回ture
        {
            Name annotation = field.getDeclaredAnnotation(Name.class);//获得该属性
            String name=annotation.value();//获得属性里的值
            if(field.get(employee)==null){
               field.setAccessible(true);
               field.set(employee,name);
            }
        }

    }
}

在以后的框架中 可能会稍微用到注解 只要会用就行