黑马程序员---Java基础加强---JDK1.5新特性：注解

-------  android培训 、 java培训 、期待与您交流！ ----------

JDK1.5新特性：注解

一、了解和入门注解的应用

注解相当于是一个特殊的类

1.注解的种类
@SupressWarnings：压缩警告，，默认在源文件阶段

@Deprecated：表示方法为过时或者作废，但是仍可以用，只是再用的时候尽量不要用此方法。此注解默认在运行阶段。

@Override：表示此方法是复写的父类的方法。此注解默认在源文件阶段。

2.注解相当于一种标记

在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其

他的程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记就去干相应的事。

3.标记可以加在包，类，字段（成员变量），方法，方法的参数以及局部变量上。

4.总结：注解即是向编译器、开发工具或者其他的程序传达一种信息。

二、注解的定义与反射调用

注解是JDK1.5的新特性。

1.需求：

写一个注解类，并将此注解类应用于一个类上，并在别的类通过反射来获取此类上的注解类名称。

分析：要想得到某一个类的注解，

第一：首先通过反射看此类上面是否有此注解，此类字节码.isAnnotationPresent(此类字节码)

第二：通过反射来获取此注解对象，此类自己码.getAnnotation(此类字节码)

第三：由于你只是获取了注解对象，但是并不知道是什么类型的注解，所以前面要有类型转换。

程序如下：

@ItcastAnnocation
public class AnnotationTest 
{
	public static void main(String[] args)throws Exception 
	{
		// TODO Auto-generated method stub
		//判断这样的一个类中是否存在注解ItcastAnnocation
		if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class))
			ItcastAnnotation annotation=(ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
		System.out.println(annotation);
	}
}

import java.lang.annotation.RetentionPolicy;
@Target(ElementType.TYPE)//表示此注解只可以用于类
@Retention(RetentionPolicy.RUNTIME)//表示此注解保留在运行阶段
public @interface ItcastAnnotation 
{
}

2.元注解

定义：注解的注解即为元注解。

上面的程序中的@Target(ElementType.TYPE)和@Retention(RetentionPolicy.RUNTIME)，

这是两种元注解元注解@Retention(取值)，表示注解可以保留在什么阶段，

取值是一个枚举类型取值可以有

RetentionPolicy.RUNTIME、

RetentionPolicy.CLASS、

RetentionPolicy.SOURCE  

分别对应于：

运行阶段，

类文件阶段，

还有源程序阶段。

即表示，注解的存在有三个阶段：源文件阶段->类文件阶段->运行阶段，

默认的阶段是在源文件阶段。即一编译完成，其注解就不在文件中显示了，即类文件中没有相关的信息。

而类文件阶段表示，编译完成之后，注解还在，在类文件中有相关信息；

而运行阶段，即表示注解存在于类的二进制的字节码中。

元注解：@Target（取值），表示注解可以使用的范围，他的取值也是一个枚举类型取值可以为：

ElementType.PACKAGE,

ElementType.TYPE,

ElementType.METHOD,

ElementType.FIELD,

ElementType.CONSTRUCTOR,

ElementType.LOCAL VARIABLE,

ElementType.PARAMETER

对应于：注解可以用于包、类或者接口、方法、成员变量、构造函数、局部变量、参数上；

若是即用于的是类又可以用于方法中，则写成@Target({ElementType.TYPE，ElementType.METHOD})即里面的值

是数组的形式，当只有一个值时可以不用写{}，若是两个以上，则必须写{}。

3.为注解增加各种属性

（1）属性的返回值可以是：8种基本数据类型（byte,short,char,int,long,boolean,float,double）,String,数组

Class，注解型，枚举型。

（2）给注解的属性值进行设值有两种方式：

第一，在创建注解对象的时候设置值，即@ItcastAnnotation(属性名="abc")

第二，在注解类中定义属性时直接给出默认值，即String value()default "abc";

注意，虽然在定义注解类的属性时，已经给出了此属性的值，但可以通过创建对象来重新设置值,也可以不用再设置值。
（3）注解类中特殊的属性

当属性名是value且只有这一个属性时，则在对象上设置值时，可以不用写此属性名和等号，直接写值如：注解类中

的属性定义为String value()default "abc";而对象上可以写成@ItcastAnnotation("abc")

4、注解类的属性的使用和设置值

对于注解类的属性在进行设置值时，以属性的形式设置值，即：属性名=值  的形式，而对取出此属性的值时（即使

用此属性时），依然用调用的形式，即:注解类对象.value();

例子：

import java.util.*;
@ItcastAnnocation(value="bcd",getAge=9,enumAnnotationArray=EnumTest.TUS)
//由于属性getAge还没赋值，所以对于value赋值时必须写上value=
//由于属性enumAnnotationArray的取值是一个，所以可以不用写{}，两个以上就必须写上{}
class AnnotationApply                  
{
}
//此类功能为操作运用了注解的类。									 
class AnnotationTest1 
{
	public static void main(String[] args) throws Exception
	{
		//运用翻书看类中是否运用了注解并且取出此注解中属性的值
		if (AnnotationApply.class.isAnnotationPresent(ItcastAnnocation.class))
		{
			//如果有此注解，则获取此注解
			ItcastAnnocation annotation=(ItcastAnnocation)AnnotationApply.class.getAnnotation(ItcastAnnocation.class);
			//System.out.println(annotation);
			//对此注解对象进行操作，要获取它的各个属性值
			System.out.println(annotation.value());
			System.out.println(annotation.getAge());
			//将数组转化为字符串打印出来
			System.out.println(Arrays.toString(annotation.arr()));
			System.out.println(annotation.classAnnotation().getName());
			//System.out.println(annotation.enumAnnotation().toString());
			//将数组转化为集合打印出来
			//System.out.println(Arrays.asList(annotation.enumAnnotationArray()));
			System.out.println(annotation.aannotation().value());
		}
	}
}
//定义一个枚举类
enum EnumTest
{
	SUN,MON,TUS,WEN,THUD,FRI,SAT;
	public String toString(){
		return "SUN";
		
	}
} 
//定义一个注解
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)//使此注解保持到运行阶段
public @interface ItcastAnnocation
{
	//给此属性设置属性
	//1、属性的返回值是String
	String value()default "abc";
	//返回值类型为int型
	int getAge();
	//返回值类型为数组型
	int[] arr() default {1,2,3};
	//返回值类型为Class类型
	Class classAnnotation() default String.class;
	//返回值类型为枚举型
	EnumTest enumAnnotation() default EnumTest.SUN;
	//或者是返回值类型为枚举型的数组
	EnumTest[] enumAnnotationArray() default {EnumTest.SUN,EnumTest.MON};
	//返回值类型为注解型
	AnnoAnnotation aannotation() default @AnnoAnnotation("abc");
}

//定义一个注解
public @interface AnnoAnnotation
{
	String value();
}