注释讲解及简单使用

什么是注释（annotation）：
1.Annotation可以用来修饰类，属性，方法，而且annotation不影响程序的运行，无论是否使用annotation代码都会正常运行。

2.在java中会有自建的annotation，只要通过固定的格式调用即可。

3.当然我们也可以自定义annotation，这种是结合枚举和反射结合起来使用的，真正体现出它的强大之处。

案例：

package com.gaoji_zhushi;

public @interface anno {                 //自定义annotation
	public String key();                   
	public String value();                 //定义接收的内容
         
}

package com.gaoji_zhushi;
@anno(key="123",value="FBM")                                      //使用自定义的annotation,并设置内容
public class Text {

}

如果在定义好的annotation中已经定义了若干属性，但是使用annotation时并没有时指定其内容，在编译时会出现错误，当然有些在定义时设置了默认值，定义格式如下：

public @interface anno { //自定义annotation
数据类型 变量名() deautl(默认值);
}

取得指定的annoatation中的内容：

package com.gaoji_zhushi;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;


@Retention(value=RetentionPolicy.RUNTIME)
public @interface anno {                 //自定义annotation
	public String key();                
	public String value() ;              //定义接收的内容
         
}

package com.gaoji_zhushi;


public class dim {
@SuppressWarnings("unchecked")   //使用@SuppressWarnnings
@Deprecated                                 //使用@Deprecated的Annotation
@Override                                    //使用@Override的annotation
@anno(key="123",value="FBM")                                      //使用自定义的annotation,并设置内容
public String toString(){                        //复写tostring方法
	
	return "hello FBM";                  
}	

}

package com.gaoji_zhushi;

import java.lang.reflect.Method;



public class Text {
	public static void main(String[] args) throws NoSuchMethodException, SecurityException {
		Class class1=dim.class;                          //实例化class类
		Method  tod=class1.getMethod("toString");               //取得tostring方法
		
		if (tod.isAnnotationPresent(anno.class)) {
			anno anno1=tod.getAnnotation(anno.class);               
			String key=anno1.key();                            //取得annotation中指定的变量
			String value=anno1.value();             
			System.out.println("key:"+key);
			System.out.println("value:"+value);                //输出
		}
	}

}

通过上面的程序就可以看出，只要适当的使用反射机制，就可以将annotation
中指定的内容设置到对应的操作中。

@Target注释
如果希望一个自定义的annotation只能在指定的位置上出现，列如在一个类上，那么只能使用Target

@Documented注释
任何一个annotation都是通过@Documented进行注释的，在生成javadoc的时候可以通过@Documented将一些文档的说明信息写入