Java 注解

注解

注解本身不会做任何事情，它需要工具支持才会有用（必须编写相关的注解处理器）。
每个注解都必须通过@interface定义。
java.lang.reflect.AnnotatedElement Javadoc
所有的注解都隐式地扩展自java.lang.annotation.Annotation接口。

元注解

@Target	表示该注解可以用干什么地方。可能的ElemeruType参数包括： CONSTRUCTOR：构造器的声明 FIELD:域卢明（包括emrni实例） LOCAL.VARIABLE：局部变量声明 METHOD：方法声明 PACKAGE：包声明 PARAMETER：参数声名 TYPE,类、接口（包括注解类型）或emim声明
@ Retention	表示需要要在什么级别保存该注解信息。可选的RetenticmPolky参数包栝： SOURCE：注解将被编译器丢弃。 CLASS：注解在class文件中可用，但会被VM丟弃。 RUNTIME： VM将在运行期也保留注解，因此可以通过反射机制读取注解的信息。
@ Documented	将此注解包含在Javadoc中。
@ Inherited	允许子类继承父类中的注解。

语法

public @interface Name {
	type elementName();
	type elementName() default value;
}

使用注解
@Name(elementName=value)

ASM

ASM是一个通用的Java字节码操作和分析框架。它可以用于修改现有类或直接以二进制形式动态生成类。ASM提供了一些常见的字节码转换和分析算法，可以从中构建自定义复杂转换和代码分析工具。ASM提供与其他Java字节码框架类似的功能，但专注于 性能。因为它的设计和实现尽可能小而且快，所以它非常适合在动态系统中使用（但当然也可以以静态方式使用，例如在编译器中）。

• JavaDOC
• ASM使用指南

一些示例

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;

public class AnnotationClassTest {
	
	public static void main(String[] args) {
		Class<Test3> testClass = Test3.class;
		//因为注解是作用于类上面的，所以可以通过isAnnotationPresent来判断是否是一个  
		//判断是否有UserNameAnnotations注解的类  
		if (testClass.isAnnotationPresent(UserNameAnnotations.class)) {
			System.out.println("this is a Annotations class"); 
			//通过getAnnotation可以获取注解对象  
			UserNameAnnotations userNameAnnotations = (UserNameAnnotations) testClass.  
					 getAnnotation(UserNameAnnotations.class);
			if (userNameAnnotations != null) {  
				 System.out.println("value:" + userNameAnnotations.value());  
			} else {  
                System.out.println("null");  
            }  
		} else {  
            System.out.println("this is not Annotations class");  
        }  
	}
}


@Documented //文档  
@Retention(RetentionPolicy.RUNTIME) //在运行时可以获取  
@Target({ ElementType.TYPE, ElementType.METHOD}) //作用到类，方法，接口上等  
@Inherited //子类会继承  
@interface UserNameAnnotations {
	public String value() default "pp";
}


//第一个注解的测试类
@UserNameAnnotations( value = "initphp")
class Test1 {
	private String userName;
	
	public String getUserName() {
		return userName;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}
}