黑马程序员-------（高新技术）注解

-------------java培训、android培训、java博客、java学习型技术博客、期待与您交流！ --------------

了解注解及java提供的几个基本注解

先通过@SuppressWarnings的应用让大家认识和了解一下注解：
通过System.runFinalizersOnExit(true);的编译警告引出@SuppressWarnings("deprecation")
@Deprecated
直接在刚才的类中增加一个方法，并加上@Deprecated标注，在另外一个类中调用这个方法。
@Override
public boolean equals(Reflect other)方法与HashSet结合讲解
总结：
注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。
看java.lang包，可看到JDK中提供的最基本的annotation。

 注解的应用结构图

自定义注解及其应用

定义一个最简单的注解：public @interface MyAnnotation {}
把它加在某个类上：@MyAnnotation public class AnnotationTest{}
用反射进行测试AnnotationTest的定义上是否有@MyAnnotation
根据发射测试的问题，引出@Retention元注解的讲解，其三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME;分别对应：java源文件-->class文件-->内存中的字节码。
思考：@Override、@SuppressWarnings和@Deprecated这三个注解的属性值分别是什么？
演示和讲解@Target元注解
Target的默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了，改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就可以了。
元注解以及其枚举属性值不用记，只要会看jdk提供那几个基本注解的API帮助文档的定义或其源代码，按图索骥即可查到，或者直接看java.lang.annotation包下面的类。
为注解增加基本属性

什么是注解的属性
一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是传智播客的学生，否则，就不是。如果还想区分出是传智播客哪个班的学生，这时候可以为胸牌在增加一个属性来进行区分。加了属性的标记效果为：@MyAnnotation(color="red")
定义基本类型的属性和应用属性：
在注解类中增加String color();
@MyAnnotation(color="red")
用反射方式获得注解对应的实例对象后，再通过该对象调用属性对应的方法
MyAnnotation a = (MyAnnotation)AnnotationTest.class.getAnnotation(MyAnnotation.class);
System.out.println(a.color());
可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象
为属性指定缺省值：
String color() default "yellow";
value属性：
String value() default "zxx";
如果注解中有一个名称为value的属性，且你只想设置value属性（即其他属性都采用默认值或者你只有一个value属性），那么可以省略value=部分，例如：@MyAnnotation("lhm")。

为注解增加高级属性

数组类型的属性
int [] arrayAttr() default {1,2,3};
@MyAnnotation(arrayAttr={2,3,4})
如果数组属性中只有一个元素，这时候属性值部分可以省略大括
枚举类型的属性
EnumTest.TrafficLamp lamp() ;
@MyAnnotation(lamp=EnumTest.TrafficLamp.GREEN)
注解类型的属性：
MetaAnnotation annotationAttr() default @MetaAnnotation("xxxx");
@MyAnnotation(annotationAttr=@MetaAnnotation(“yyy”) )
可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象，同样的道理，可以认为上面这个@MetaAnnotation是MetaAnnotation类的一个实例对象，调用代码如下：
 MetaAnnotation ma =  myAnnotation.annotationAttr();
 System.out.println(ma.value());
注解的详细语法可以通过看java语言规范了解，即看java的language specification。

package cn.itcast.day2;
//调用注解类,作用于类上
//注解类设置属性color="red"
//annotationAttr=@MetaAnnotation("flx")这种情况是：注解类中的成员变量还是注解类的情况
@ItcastAnnotation(annotationAttr=@MetaAnnotation("flx"),color="red",value="abc",arr={1,2,34,433,4,3})
public class AnnotationTest {
	//SuppressWarnings是个类：用于消除警告
	@SuppressWarnings(value = { "deprecation" })
	
	@ItcastAnnotation("xyz")
	//--main()一定要写在一个类上，但是不一定是这个类的成员，只是作为一个栖息地---------//
	public static void main(String[] args) {
		//deprecated:过时的了
		System.runFinalizersOnExit(true);
		
		//检测这个类上的注解
		System.out.println(AnnotationTest.class.isAnnotation());
		System.out.println(ItcastAnnotation.class.isAnnotation());
		if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
			ItcastAnnotation annotation = (ItcastAnnotation) AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
			//获取这个（annotation）注解类上的（color()）属性
			System.out.println(annotation.color());
			System.out.println(annotation.value());
			System.out.println(annotation.arr().length);
			System.out.println(annotation.lamp().nextLamp().nextLamp());
			System.out.println(annotation.annotationAttr().value());
		
		}
	}
	//令下面的方法设为“过时”
	@Deprecated
	public static void sayHello(){
		System.out.println("hi,传智播客！");
	}
}

 

package cn.itcast.day2;

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

import cn.itcast.day1.EnumText;

//注解类的注解，称为元注解----@Retention元注解的讲解
//policy:翻译：保险单、政策
//RetentionPolicy.SOURCE		-----源文件时期
//RetentionPolicy.CLASS			-----class文件时期（编译时期）
//RetentionPolicy.RUNTIME		-----运行时期
@Retention(value = RetentionPolicy.RUNTIME)		//------将被注解的类（ItcastAnnotation）保留到运行时期
//RetetionPolicy.RUNTIME;分别对应：java源文件-->class文件-->内存中的字节码。

//@Target指定自定义注解类（ItcastAnnotation）作用于哪个位置。
//ElementType.METHOD		---只作用于方法上
//ElementType.TYPE			---只作用于类上
@Target(value = {ElementType.METHOD,ElementType.TYPE})
//创建一个注解类
public @interface ItcastAnnotation {
		//接口会自动添加	public static
	//1、假设成员属性返回值是String
	String color() default "bule";
		/*情况一：
			特殊属性名称value，如果只有一个属性value，在注解类设置值的时候，
			可以默认不写value，直接赋值：@SuppressWarnings(“deprecation")*/
		/*情况二：
			如果其他成员有default：：String color() default "bule";
			也可以@ItcastAnnotation("abc")*/
	String value();
	//2、假设成员属性返回值是数组
	int [] arr() default {1,2};
	
	//3、假设成员属性返回值是枚举
	EnumText.TrafficLamp lamp() default EnumText.TrafficLamp.RED;
	
	//4、假设成员属性返回值是注解类
	//@MetaAnnotation 就是注解类MetaAnnotation的一个实例对象
	MetaAnnotation annotationAttr() default @MetaAnnotation("lhm");
	
	//5、假设成员属性返回值是Class类
}

 

package cn.itcast.day2;

public @interface MetaAnnotation {
	String value();
}

-------------java培训、android培训、java博客、java学习型技术博客、期待与您交流！ --------------