自定义注解:

package interfaceAnotation;


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;


/**
 * 自定义注解
 * 
 * @author liangyuyi
 *
 */
@Target({ ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Extension {
	String value();
}

注解说明:

@Target说明了Annotation所修饰的对象范围:Annotation可被用于 packages、types(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

  作用:用于描述注解的使用范围(即:被描述的注解可以用在什么地方)

取值(ElementType)有:

    1.CONSTRUCTOR:用于描述构造器
    2.FIELD:用于描述域
    3.LOCAL_VARIABLE:用于描述局部变量
    4.METHOD:用于描述方法
    5.PACKAGE:用于描述包
    6.PARAMETER:用于描述参数
    7.TYPE:用于描述类、接口(包括注解类型) 或enum声明

比如说:如果使用的是ElementType.TYPE的话,下面的@Extension(..)只能写在类上面


@Retention(RetentionPolicy.RUNTIME)注解表明Extension注解将会由虚拟机保留,以便它可以在运行时通过反射读取.

Retention(保留)注解说明,这种类型的注解会被保留到那个阶段. 有三个值:
1.RetentionPolicy.SOURCE —— 这种类型的Annotations只在源代码级别保留,编译时就会被忽略
2.RetentionPolicy.CLASS —— 这种类型的Annotations编译时被保留,在class文件中存在,但JVM将会忽略
3.RetentionPolicy.RUNTIME —— 这种类型的Annotations将被JVM保留,所以他们能在运行时被JVM或其他使用反射机制的代码所读取和使用.


Documented 注解表明这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中. 


@Inherited 标记,然后用定义的注解来标注另一个父类, 父类又有一个子类(subclass),则父类的所有属性将被继承到它的子类中



自定义注解的使用:

package interfaceAnotation;

/**
 * 使用自定义注解的实例
 * 
 * @author liangyuyi
 *
 */

public class ExtensionExample {
	@Extension(ConstsCode.code1)
	public void printcode1() {
		System.out.println("this is code1");
	}

	@Extension(ConstsCode.code2)
	public void printcode2() {
		System.out.println("this is code2");
	}

	@Extension(ConstsCode.code3)
	public void printcode3() {
		System.out.println("this is code3");
	}
}




常量类

package interfaceAnotation;

/**
 * 常量类,保存业务逻辑号
 * 
 * @author liangyuyi
 *
 */
public class ConstsCode {

	public static final String code1 = "001";
	public static final String code2 = "002";
	public static final String code3 = "003";
}




测试类:

package interfaceAnotation;

import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

/**
 * 反射和注解的测试类
 * 
 * @author liangyuyi
 *
 */
public class MainTest {
	public static void main(String[] args) {
		// 通过反射机制获取ExtensionExample
		Class<?> clazz = new ExtensionExample().getClass();

		// 获取类方法
		Method[] methods = clazz.getMethods();

		for (Method method : methods) {
			Extension methodAnota = method.getAnnotation(Extension.class);// 获取方法中的Extension注解
			if (methodAnota != null) {
				String anotaValue = methodAnota.value();// 获取注解的内容
				System.out.println("the " + method.getName() + " anotation is " + anotaValue);
				try {
					method.invoke(clazz.newInstance());// 执行类方法
				} catch (IllegalAccessException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				} catch (IllegalArgumentException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				} catch (InvocationTargetException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				} catch (InstantiationException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				}
			}
		}
	}
}