java的annotation_Java的Annotation（注解）

注解为我们在代码中添加信息提供了一种形式化的方法，使我们可以在稍后某个时刻非常方便地使用这些数据。它是对来自像C#之类的其他语言对Java造成的语言特性压力所做出的一种回应。

一、Java内置基本注解

在Java中内置几种了基本的注解，下面列出几种常用的注解：

1、@Deprecated：用该注解注释的程序元素，表明不鼓励程序员使用这样的元素，通常是它很危险或存在更好的选择。

2、@Override：表明当前的方法定义将覆盖超类中的方法。

3、@SuppressWarnings：表明关闭不当的编译器警告信息。

4、@Documented：表明某一类型的注释将通过javadoc和类似的默认工具进行文档化。

5、@Inherited：允许子类继承父类中的注解。

6、@Retention：表明需要在什么级别保存该注解信息。

7、@Target：表明该注解可以用于什么地方。

8、@Generated：该注解用于标记已生成的源代码，它可以用于区分单个文件中用户编写的代码和生成的代码。

9、@PostConstruct：该注解用于在依赖关系注入完成之后需要执行的方法上，以执行任何初始化。

10、@PreDestroy：该注解作为回调通知用于各方法，以表示该实例正处于被容器移除的过程中。

11、@Resource：该注解用于标记应用程序所需要的资源。

二、定义注解

注解的定义看起来很像接口的定义，具体代码如下：

Java代码  收藏代码

1. import java.lang.annotation.*;

2. @Target(ElementType.METHOD)

3. @Retention(RetentionPolicy.RUTIME)

4. public @interface Test {}

import java.lang.annotation.*;

@Target(ElementType.METHOD)

@Retention(RetentionPolicy.RUTIME)

public @interface Test {}

除了@符号之外，@Test的定义很像一个空的接口，定义一个注解的时候，要用到一些元注解(Java内置的注解)，如上面例子中的定义，@Target表明新定义的注解将用于方法定义上，@Retention表明新定义的注解将在运行时起作用。

Java SE5内置四种元注解

@Target:表示该注解可以用于什么地方.可能的ElementType参数包括:

1)CONSTRUCTOR:构造器的声明

2)FIELD:域声明(包括enum实例)

3)LOCAL_VARIABLE:局部变量声明

4)METHOD:方法声明

5)PACKAGE:包声明

6)PARAMETER:参数声明

7)TYPE:类、接口(包括注解类型)或enum声明

@Retention:表示需要在什么级别保存该注解信息.可选的RetentionPolicy参数包括:

1)SOURCE:注解将被编译器丢弃

2)CLASS:注解在class文件中可用,但会被VM丢弃

3)RUNTIME:VM将在运行期也保留注解,因此可以通过反射机制读取注解的信息

@Documented:将此注解包含在Javadoc中

@Inherited:允许子类继承父类中的注解

大多数时候,程序员主要是定义自己的注解，并编写自己的处理器来处理它们.

在注解中，一般都会包含一些元素以表示某些值，而没有元素的注解称为标记注解，如上面的@Test注解，下面定义一个新的注解，将包含一些元素，如：

Java代码  收藏代码

package com;

import java.lang.annotation.*;

@Target(ElementType.METHOD)

//用来定义你的注解将应用在什么地方,本处应用为方法

@Retention(RetentionPolicy.RUNTIME)

//用来定义该注解在哪一个级别可用,在源代码中(source)类文件中(class)或者运行时(runtime)

public @interface UseCase

{

public int id();

publicString description() default"no description";

}

该注解中定义了两个元素id和description，其中description元素通过default指定了默认值。

packagecom;

public class PasswordUtils {

@UseCase(id=47,description="Passwords must contain at least one numeric")

public booleanvalidatePassword(){

return true;

}

@UseCase(id=48)

publicString encryptPassword(String password){

return password;

}

@UseCase(id=49,description="Jong_Cai")

public voidshowName(){

System.out.println("Jong_Cai");

}

}

如果没有用来读取注解的工具,那注解也不会比注释更有用.使用注解的过程中.很重要的一个部分就是创建与使用注解处理器.Java SE5扩展了反射机制的API,以帮助程序员构造这类工具.同时,它还提供了一个外部工具apt帮助程序员解析带有注解的Java源代码.下面是一个非常简单的注解处理器,我们将用它来读取PasswordUtils类,并使用反射机制查找@UseCase标记.我们为其提供了一组id值得,然后它会列出在PasswordUtils中找到的用例,以及缺失的用例.

------------------------ UseCaseTracker.java ---------------------------

package com;

import java.lang.reflect.Method;

import java.util.ArrayList;

import java.util.Collections;

import java.util.List;

public class UseCaseTracker {

public static void trackUseCases(List list, Class>cl) {

for (Method m : cl.getDeclaredMethods()) {

UseCase us = m.getAnnotation(UseCase.class);

if (us != null) {

System.out.println("Found UseCase:" + us.id() + " "

+ us.description());

list.remove(new Integer(us.id()));

}

}

for (int i : list) {

System.out.println("Warning:Missinguse case-" + i);

}

}

public static void main(String[] args) {

List list = new ArrayList();

Collections.addAll(list, 47, 48, 49, 50, 51);

trackUseCases(list, PasswordUtils.class);

}

}

执行结果：

Found Use Case:47 Passwords must contain at least one numeric

Found Use Case:48 no description

Found Use Case:49 Jong_Cai

Warning:Missing use case-50

Warning:Missing use case-51

这个程序用到了两个反射的方法:getDeclaredMethods()和getAnnotation(),它们都属于AnnotatedElement接口(class,Method与Field等类都实现了该接口).getAnnotation()方法返回指定类型的注解对象,在这里就是UseCase,如果被注解的方法上没有该类型的注解,则返回null值.然后我们通过调用id()和description()方法从返回的UseCase对象中提取元素的值.其中encryptPassword()方法在注解的时候没有指定description的值,因此处理器在处理它对应的注解时,通过description()方法取得的是默认值no description.

三、注解处理器

如果没有用来读取注解的工具，那注解也不会比注释更有用，使用注解的过程中，很重要的一部分就是创建与使用注解处理器，而注解处理器的编写需要更加实际应用来灵活应用。

四、注意地方 　　1、注解元素可以用的类型只有：所有基本类型(int,float,boolean)、String、Class、enum、Annotation、以上类型的数组。 　　2、在定义元素的默认值时有限制，首先，元素不能有不确定的值，也就是说，元素必须要么具有默认值，要么在使用注解时提供元素的值；其次，对于非基本类型的元素，不能以null作为其值。 　　3、注解不支持继承。