【黑马程序员】java基础加强-------注解（annotation）

---------------------- <a href="http://edu.csdn.net"target="blank">ASP.Net+Android+IOS开发</a>、<a href="http://edu.csdn.net"target="blank">.Net培训</a>、期待与您交流！ ----------------------

一、注解的定义

定义: 注解(Annotation)是一种标记性的接口，注解是Java的一个新的类型（与接口很相似），它与类（Class）、接口（interface）、枚举（enum）是在同一个层次，注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记。我们可以定义注解、声明注解、获得注解，并且根据获得的注解做相应的处理，许多框架都大量应用了注解。

二、简单的注解

1、@supperessWarnings("deprecation")   //告诉编译器该方法我已经知道已经过时了

2、@Deprecated                    //此注解注明该方法过时，提示程序员该方法过时

3、@Overide                          //表示该方法是覆盖父类的方法

这种标记可以应用在：包上、类上、字段上、方法上、方法参数上、局部变量上面

三、注解类的应用结构图

自己定义一个注解;

//自定义一个注解类。
public @interface itcastAnnotation {
	String color() default "yellow";
	String value();
}

//这一个是一个应用”注解类“的类
import java.lang.annotation.Annotation;
@itcastAnnotation
public class AnnotationTest {
	public static void main(String[] args) 
	{
	
	}
}

四、为注解增加各种属性

1、什么是注解的属性？

理解：一个注解相当于一个胸牌，如果你胸前有胸牌，就是传智播客的学生，否则就不是。

如果还想区分是传智播客哪个班的学生，这时可以在胸牌上增加一个属性加以区分。
例：@MyAnnotation(color="red")

2、定义基本类型的属性：

//自定义一个注解类。
public @interface itcastAnnotation {
	//增加属性，可以有可以没有默认值
	String color() default "yellow";
	String value();
}

在应用中，可以为注解类中的属性设置属性值

//这一个是一个注解类，可以在小括号内设置属性值
@itcastAnnotation(annotation=@MetaAnnotation("物联云"),color="red",value="hcs",arrayAttr={60,80,90})

3、用反射的方式获取注解的实例对象后，在通过该对象调用属性对应的方法

例：

@itcastAnnotation(annotation=@MetaAnnotation("物联云"),color="red",value="hcs",arrayAttr={60,80,90})

public class AnnotationTest {

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		System.runFinalizersOnExit(true);
		if(AnnotationTest.class.isAnnotationPresent(itcastAnnotation.class))
		{	
			//通过反射获取注解对象
			itcastAnnotation annotation=(itcastAnnotation)AnnotationTest.class.getAnnotation(itcastAnnotation.class);
			//也可以认为上面的@MyAnnotation是MyAnnotation类的实例对象
			System.out.println("打印注解："+annotation);

4、可以为注解类中的属性指定默认值

例：string  color()  difaule"yellow";

5、value属性，如果注解中有一个value的属性，且只想设置value属性（其他属性都采用默认值）

例：string  vaule（）；

应用中：可以省略value=      比如：@itcastAnnotation（"lili"）

6、数组类型的属性

注意：如果数组类型的属性中只有一个元素，这时属性值部分可以省略大括号

public @interface itcastAnnotation {
	int [] array1() default{2,4,5}
	int[] array2() default{2}
}

//这一个是一个应用”注解类“的类
import java.lang.annotation.Annotation;
@itcastAnnotation（array1={3,4,5},array=8）//设置属性值
public class AnnotationTest {
	public static void main(String[] args) 
	{}
}

7、枚举类型的实现：

注解类中属性：EnumTest.TrafficLamp  lamp();
在应用中：@MyAnnotation(lampEnumTest.TrafficLamp.GREEN)

五、注解的存在的3个阶段

@Retention(Retrntionpolicy.RUNTIME)   表示将注解保留到内存中的字节码阶段

@Retention(Retrntionpolicy.CLASS)   表示将注解保留到编译阶段
@Retention(Retrntionpolicy.SOUTCE)    表示将注解保留到java源文件阶段

Target元注解,默认值为任何元素：

.   @Target(ElementType.[type])
[type]={METHOD, FIELD, TYPE(类、接口、枚举声明), CONSTRUCTOR, LOCAL_VARIABLE,PARAMETER}

代码练习：

package cn.itcast.day2;

import java.lang.annotation.Annotation;
//这一个是一个注解类，可以在小括号内设置属性值
@itcastAnnotation(annotation=@MetaAnnotation("物联云"),color="red",value="hcs",arrayAttr={60,80,90})

public class AnnotationTest {

	/**
	 * @param args
	 */
	//表示类中的过时方法我已经知道
	@SuppressWarnings("Deprecation")
	
	
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		System.runFinalizersOnExit(true);
		if(AnnotationTest.class.isAnnotationPresent(itcastAnnotation.class))
		{	
			//通过反射获取注解对象
			itcastAnnotation annotation=(itcastAnnotation)AnnotationTest.class.getAnnotation(itcastAnnotation.class);
			
			System.out.println("打印注解："+annotation);
			System.out.println("以下是annotation注解的属性值：");
			System.out.println(annotation.color());
			
			System.out.println(annotation.value());
			System.out.println(annotation.arrayAttr().length);
			System.out.println(annotation.lamp().nextLamp().name());
			
			//注解属性=注解，的属性值调用
			System.out.println(annotation.annotation().value());
		}
		
	}
	@Deprecated//此注解表示，以下方法已经过时
	public static void sayHolle(){
		System.out.println("你好，黑马");
	}
}
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.EnumTest;

//@Target(ElementType.METHOD)//表示将注解类保留到方法上

@Target({ElementType.METHOD,ElementType.TYPE})//表示带注解类可以应用在调用者类中的方法上
												

@Retention(RetentionPolicy.RUNTIME)//注解上还有注解：称为：元注解；表示将注解类保留到：内存中的字节码阶段

//自定义一个注解类。
public @interface itcastAnnotation {
	String color() default "yellow";
	String value();
	int[] arrayAttr() default {1,2,3};//注解的属性是数组类型
	
	EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;//注解的属性是枚举类型
	
	//注解的属性对应一个注解
	MetaAnnotation annotation() default @MetaAnnotation("黑马云");//注解的属性是一个注解
}

  

---------------------- <a href="http://edu.csdn.net"target="blank">ASP.Net+Android+IOS开发</a>、<a href="http://edu.csdn.net"target="blank">.Net培训</a>、期待与您交流！ ----------------------