Java自定义注解及注解的使用

Annotation，是Java5的新特性……

1、自定义注解

如何自定义一个注解，看下面的代码，其实代码没几句，都是注释，写的很详细，看完就会自定义注解了

package com.sl.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
 * @Retention；
 * 指定被修饰的Annotation可以保留多长时间；
 * 只有一个参数，参数类型RetentionPolicy value();
 * 可以@Retention(RetentionPolicy.XXX)或者@Retention(value=RetentionPolicy.XXX)
 * 两种用法；参数的值有三个：
 * RetentionPolicy.SOURCE Annotation只保留在源码中
 * RetentionPolicy.CLASS  Annotation保留在源码和class文件中
 * RetentionPolicy.RUNTIME Annotation记录在class中，当java程序运行时也会保留在JVM中
 */
@Retention(RetentionPolicy.RUNTIME)
/**
 * @Target
 * 指定被修饰的Annotation能用于修饰哪些程序单元
 * 只有一个参数，参数类型ElementType[] value();
 * 只需要修饰一个target时可以@Target({ElementType.METHOD})或@Target(ElementType.METHOD)
 * 当修饰的target有多个时，则@Target({ElementType.METHOD,ElementType.FIELD})，target不能重复
 * 参数值如下：
 * ElementType TYPE; 类、接口、枚举
 * ElementType FIELD; 成员变量
 * ElementType METHOD; 方法
 * ElementType PARAMETER; 参数
 * ElementType CONSTRUCTOR; 构造函数
 * ElementType LOCAL_VARIABLE; 局部变量
 * ElementType ANNOTATION_TYPE; 只能修饰Annotation
 * ElementType PACKAGE; 修饰包
 */
@Target({ElementType.METHOD,ElementType.FIELD})
/**
 * 修饰后，Annotation将具有继承性，也就是对被Annotation修饰的类的子类也有效
 * 但是！annotations on implemented interfaces have no effect.
 * 也就是这个修饰对于接口interface无效
 */
@Inherited
/**
 * 修饰后Annotation能被javadoc提取为文档
 */
@Documented
/**
 * 定义一个Annotation
 * 用@interface修饰，和定义interface很像
 */
public @interface Song {
	/**
	 * 1、
	 * 定义成员变量：
	 * 以无参的方法形式声明，其方法名和返回值定义了该成员变量的名字和类型，如：
	 * String name();成员变量名为name，类型为String如果要设默认值的话可以加default valu
	 * String name() default "songlin";
	 */
	
	/**
	 * 2、
	 * 没有定义成员变量的Annotation类型成为标记，如@Override
	 */
	
	/**
	 * 3、
	 * 如果只有一个成员变量时，变量名取名value,如：
	 * String value();
	 */
	
	/**
	 * 4、多个成员变量时：
	 */
	
	String name();
	int age();
	String desc() default "desc";
	/**-------------------Annotation定义完成！！！-----------------*/
}

超级简单！

2、使用注解，注解的使用和public、void、static 、final的用法差不多，只不过习惯上喜欢单独放一行

package com.sl.annotation;

public class Person {
	@Song(age = 12, name = "songlin")
	public int age;
	@Song(age = 11, name = "sl" ,desc="this is a name")
	public String name;
	
	public Person(){};
	public Person(int age, String name) {
		super();
		this.age = age;
		this.name = name;
	}


	public int getAge() {
		return age;
	}
	@Song(age = 0, name = "dfgs")
	public void setAge(int age) throws Exception {
		throw new Exception();
	}
	@Song(age = 1, name = "ddddd")
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
}

定义了注解，在定义属性和方法时使用了注解，但是注解的使用还要去解析

package com.sl.annotation;

import java.lang.reflect.Field;
import java.lang.reflect.Method;

public class ParseSongAnno {
	public static void parseSongAnno(Person p){
		Class<? extends Person> clz=p.getClass();
		Field[] fields = clz.getFields();
		for (Field field : fields) {
			if (field.isAnnotationPresent(Song.class)) {
				System.out.println("Field name="+field.getName());
				Song annotation = field.getAnnotation(Song.class);
				System.out.println("Anno:\tage:"+annotation.age()+"\tname:"+annotation.name()+"\tdesc:"+annotation.desc());
			}
		}
		
		Method[] methods = clz.getMethods();
		for (Method method : methods) {
			if (method.isAnnotationPresent(Song.class)) {
				System.out.println("Method name="+method.getName());
				Song annotation = method.getAnnotation(Song.class);
				System.out.println("Anno:\tage:"+annotation.age()+"\tname:"+annotation.name()+"\tdesc:"+annotation.desc());
			}
		}
	}
}

然后在main方法中测试

package com.sl.annotation;

public class AnnotationTest1 extends AnnotationTest{
	public static void main(String[] args){
		ParseSongAnno.parseSongAnno(new Person());
	}
}

结果如下

Field name=age
Anno:	age:12	name:songlin	desc:desc
Field name=name
Anno:	age:11	name:sl	desc:this is a name
Method name=setAge
Anno:	age:0	name:dfgs	desc:desc
Method name=getName
Anno:	age:1	name:ddddd	desc:desc

纯粹就是自己学习的一个胡乱总结啊，勿喷，贴的都是代码，但是耽美注释很详细啊