java自定义annotation
自定义Annotation概念篇
来看一个最简单的annotation
package com.cts.elt.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation1 {
String value();
}
1． Annotation需要声明为@interface这样的东西
2． @Target(ElementType.TYPE)
代码这个annotation必须且一定要注释在什么语句上面
ElementType.TYPE代表此Annotation必须声明在public class Student{…}的上面，而不能写在任何的method{}（方法）或者是field（属性）的上方。
@Target : 表示该注解可以用于什么地方。可用ElementType枚举类型主要有：
TYPE : 类、接口或enum声明
FIELD: 域(属性)声明
METHOD: 方法声明
PARAMETER: 参数声明
CONSTRUCTOR: 构造方法声明
LOCAL_VARIABLE:局部变量声明
ANNOTATION_TYPE:注释类型声明
PACKAGE: 包声明
3． Retention如果设为了RUNTIME，代表此annotation的具体实现可以在运行时用类反射来实现
我们看到了，annotation一般为一个@interface ，也没啥具体的implementation(实现)
怎么实现这个annotation呢？类反射
@Retention: 表示需要在什么级别保存该注解信息。
可用RetentionPolicy枚举类型主要有：
SOURCE: 注解将被编译器丢弃。
CLASS : 注解在class文件中可能。但会被VM丢弃。
RUNTIME: VM将在运行时也保存注解(如果需要通过反射读取注解，则
使用该值)。
4. @Documented
@Documented: 将此注解包含在Javadoc中。
上面这个MyAnnotation1.class文件包含一个值，下面来一个含有两个值的annotation
package com.cts.elt.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyAnnotation2 {
String description();
boolean isAnnotation();
}
关键是来看这两个自定义annotation的用法：
package com.cts.elt.annotation;
@MyAnnotation1("this isannotation1")
public class AnnotationDemo {
@MyAnnotation2(description = "this is annotation2", isAnnotation =true)
public void sayHello() {
System.out.println("hello world!");
}
}
如果把@MyAnnotation1与@MyAnnotation2的位置换一换，会怎么样？请自己动手在eclipse里试试看，嘿嘿，就知道这个Retention的用法了
自定义annotation高级篇
首先，网上的一些关于自定义annotation教程所举的例子都不太好！
就2个例子，然后一帮子人在那边到处COPY这两个例子然后到处转发，搞得来大家云里雾里一头雾水，同时一群企业的面试官也就喜欢拿这个自定义annotation来作面试题，好像会个annotation就能给Senior software engineer了。
其实Annotation就是类反射加点枚举，比个数据结构里的冒泡排序还简单，没这么夸张，关键是例子举的不好，现在来看看下面这个例子。
通过例子来看一个简单的Annotation
Hibernate的机制是可能通过JAVA类然后逆向成数据库里的某个表，大家还记得吧？
比如说
Student.java文件
如果你这样写：
@Table(name=”T_STUDENT”)
Public class Student{…}
代表这个类对应的数据库表叫T_STUDENT
如果再有下面这样的写法：
Public class Student{
Private String id=””;
@Id(init=1)
Public voidsetName(String id){
This.id=id;
}
}
就代表id这个field是一个主键，它的初始值为1。
好了，现在开始我们自己的例子，设有一CLASS叫Student，其中有三个fields:
private String name = "";
private int age = 0;
private String studentId = "";
相应的每一个field有一对的set, get方法
然后我在每个set方法上造一个annotation叫ValueBind的注解，其作用是：
只要set方法上带有ValueBind注解，它就会根据这个字段的类型把一个默认值，自动赋给Student类中相对应的field。
先来看一下Student类：
package com.cts.elt.annotation;
import java.io.Serializable;
importcom.cts.elt.annotation.ValueBind.fieldType;
public class Student implementsSerializable {
private String name = "";
public String getName() {
return name;
}
@ValueBind(type = fieldType.STRING, value ="aa")
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
@ValueBind(type = fieldType.INT, value ="30")
public void setAge(int age) {
this.age = age;
}
public String getStudentId() {
return studentId;
}
@ValueBind(type = fieldType.STRING, value ="101")
public void setStudentId(String studentId) {
this.studentId = studentId;
}
private int age = 0;
private String studentId = "";
}
自定义一个ValueBind的Annotation
这个@ValueBoind就是我的自定义的annotation，里面有两个值，来看这个annotation是怎么做的吧：
package com.cts.elt.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ValueBind {
enum fieldType {
STRING, INT
};
fieldType type();
String value();
}
够简单的吧！
首先这个annotation只能被标注在方法上
其次它含有两个值，一个是enum类型，一个是String类型
利用JAVA类反射来实现我们的Annotation
现在来看我们真正的实现（用类反射来实现）
package com.cts.elt.annotation;
import java.lang.reflect.*;
public class PersistStudent {
public static void main(String[] args) throws Exception {
Object c = Class.forName("com.cts.elt.annotation.Student")
.newInstance();
try {
Method[] methodArray = c.getClass().getDeclaredMethods();
for (int i = 0; i < methodArray.length; i++) {
if (methodArray[i].isAnnotationPresent(ValueBind.class)) {
ValueBind annotation = methodArray[i]
.getAnnotation(ValueBind.class);
String type = String.valueOf(annotation.type());
String value = annotation.value();
if (type.equals("INT")) {
methodArray[i].invoke(c, new Integer[] { new Integer(
value) });
} else {
methodArray[i].invoke(c, new String[] { value });
}
}
}
Student annotaedStudent = (Student) c;
System.out.println("studentId====" + annotaedStudent.getStudentId()
+ " studentnName====" + annotaedStudent.getName()
+ " student Age====" + annotaedStudent.getAge());
} catch (Exception e) {
throw new Exception(e);
}
}
}
运行完毕后显示：
studentId====101 studentnName====aa studentAge====30
自己把代码敲到eclipse里后再去感受一下吧，马上让你annotation入门