一、什么是java注解
注解，顾名思义，注解,就是对某一事物进行添加注释说明，会存放一些信息，这些信息可能对以后某个时段来说是很有用处的。
java注解又叫java标注，java提供了一套机制，使得我们可以对方法、类、参数、包、域以及变量等添加标准(即附上某些信息)。且在以后某个时段通过反射将标注的信息提取出来以供使用。
二、自定义java标注
1 为什么要自定义注解
java从1.5版本以后默认内置三个标注：
@override:只能用在方法之上的，用来告诉别人这一个方法是改写父类的。
@deprecated:建议别人不要使用旧的api的时候用的,编译的时候会用产生警告信息,可以设定在程序里的所有的元素上.
@suppresswarnings:这一个类型可以来暂时把一些警告信息消息关闭.
但是，仅仅这三个标注是不能满足我们开发时一些需求的。所以java允许我们自定义注解来使用。
2 如何自定义注解
自定义步骤大致分为两步：
1)， 通过@interface关键字(注意，不是interface，是@interace)声明注解名称，以及注解的成员属性或者叫做注解的参数。
2)， 使用java内置的四个元注解对这个自定义标注的功能和范围进行一些限制
问题来了，什么是元注解？
3 什么是元注解
元注解，就是定义注解的注解，也就是说这些元注解是的作用就是专门用来约束其它注解的注解。请区别上面那三个注解，他们也是通过元注解定义而来的。
元注解有哪些呢，主要有四个@target,@retention,@documented,@inherited
元注解有：@target,@retention,@documented,@inherited
@target 表示该注解用于什么地方，可能的 elemenettype 参数包括：
elemenettype.constructor 构造器声明
elemenettype.field 域声明（包括 enum 实例）
elemenettype.local_variable 局部变量声明
elemenettype.method 方法声明
elemenettype.package 包声明
elemenettype.parameter 参数声明
elemenettype.type 类，接口（包括注解类型）或enum声明
@retention 表示在什么级别保存该注解信息。可选的 retentionpolicy 参数包括：
retentionpolicy.source 注解将被编译器丢弃
retentionpolicy.class 注解在class文件中可用，但会被vm丢弃
retentionpolicy.runtime vm将在运行期也保留注释，因此可以通过反射机制读取注解的信息。
@documented 将此注解包含在 javadoc 中
@inherited 允许子类继承父类中的注解
4 自定义及使用注解示例
自定义一个类级别的标注description
package lighter.javaeye.com;
import java.lang.annotation.documented;
import java.lang.annotation.elementtype;
import java.lang.annotation.retention;
import java.lang.annotation.retentionpolicy;
import java.lang.annotation.target;
@target(elementtype.type)//这个标注应用于类
@retention(retentionpolicy.runtime)//标注会一直保留到运行时
@documented//将此注解包含在javadoc中
public @interface description {
string value();
}
再定义个方法级别的注解name
package lighter.javaeye.com;
import java.lang.annotation.documented;
import java.lang.annotation.elementtype;
import java.lang.annotation.retention;
import java.lang.annotation.retentionpolicy;
import java.lang.annotation.target;
//注意这里的@target与@description里的不同,参数成员也不同
@target(elementtype.method)
@retention(retentionpolicy.runtime)
@documented
public @interface name {
string originate();
string community();
}
然后使用以上两个注解
package lighter.javaeye.com;
@description(value="javaeye,做最棒的软件开发交流社区")
public class javaeyer {
@name(originate="创始人:robbin",community="javaeye")
public string getname()
{
return null;
}
@name(originate="创始人:江南白衣",community="springside")
public string getname2()
{
return "借用两位的id一用,写这一个例子,请见谅!";
}
}
说明：其中标注“@description(value=“javaeye,做最棒的软件开发交流社区”)”，可以写成“@description(“javaeye,做最棒的软件开发交流社区”) ”，结果也是一样的。因为description标注定义的时候其参数(或者说属性)为value。而value比较特殊，它在被指定参数的时候可以不用显示的写出来。当然如果定义的时候参数名不是value而是其它的比如des，那么使用注解的时候，必须显示写出参数名，然后再赋值：@description(des=”xxx”)
提取出注解的信息
package lighter.javaeye.com;
import java.lang.reflect.method;
import java.util.hashset;
import java.util.set;
public class testannotation {
/**
* author lighter
* 说明:具体关天annotation的api的用法请参见javadoc文档
*/
public static void main(string[] args) throws exception {
string class_name = "lighter.javaeye.com.javaeyer";
class test = class.forname(class_name);
method[] method = test.getmethods();
boolean flag = test.isannotationpresent(description.class);
if(flag)
{
description des = (description)test.getannotation(description.class);
system.out.println("描述:" des.value());
system.out.println("-----------------");
}
//把javaeyer这一类有利用到@name的全部方法保存到set中去
set set = new hashset();
for(int i=0;i
注意事项：
所有的annotation会自动继承java.lang.annotation这一个接口,所以不能再去继承别的类或是接口.
最重要的一点,annotation类型里面的参数该怎么设定:
第一,只能用public或默认(default)这两个访问权修饰.例如,string value();这里把方法设为defaul默认类型.
第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和string,enum,class,annotations等数据类型,以及这一些类型的数组.例如,string value();这里的参数成员就为string.