黑马程序员--java加强-注解

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

一、注解

Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档，跟踪代码中的依赖性，甚至执行基本编译时检查。注解是以”@注解名“在代码中存在的，根据注解参数的个数，我们可以将注解分为：标记注解、单值注解、完整注解三类。它们都不会直接影响到程序的语义，只是作为注解（标识）存在，我们可以通过反射机制编程实现对这些元数据（用来描述数据的数据）的访问。另外，你可以在编译时选择代码里的注解是否只存在于源代码级，或者它也能在class文件中出现。注解可以加在包、类、字段、方法的参数以及局部变量上。

java的基本注解有三个@Deprecated(废除)、@Override(复写)、@SuppressWarnings(压缩警告)。

（1）Deprecated类

用@Deprecated注释的程序元素，不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时，编译器会发出警告。

（2）Override类

@Override表示一个方法声明打算重写超类中的另一个方法声明。

（3）@SuppressWarnings类

@SuppressWarnings指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。如果要在特定的方法中取消显示某个警告，则应该注释该方法而不是注释它的类。

Class类中的isAnnotation()和isAnnotationPresent方法可以检测这个Class对象上是否有注解并且可以获取这个注解。

二、元注解

元注解就是注解的注解。

java元注解有四个：@Retention、@Target、@Inherited、和@Documented。

1.@Retention——注解的保留位置

 注解仅存在于源码中，在class字节码文件中不包含
 @Retention(RetentionPolicy.SOURCE)

 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得
 @Retention(RetentionPolicy.CLASS)

 注解会在class字节码文件中存在，在运行时可以通过反射获取到
 @Retention(RetentionPolicy.RUNTIME)

2.@Target——注解的作用目标

接口、类、枚举、注解
@Target(ElementType.TYPE)

字段、枚举的常量
@Target(ElementType.FIELD)

方法
@Target(ElementType.METHOD)

方法参数
@Target(ElementType.PARAMETER)

构造函数
@Target(ElementType.CONSTRUCTOR)

局部变量
@Target(ElementType.LOCAL_VARIABLE)

注解
@Target(ElementType.ANNOTATION_TYPE)

包
@Target(ElementType.PACKAGE)

注意：只有元注释类型直接用于注释时，Target 元注释才有效。

3.@Document——说明该注解将被包含在javadoc中

4.@Inherited——说明子类可以继承父类中的该注解

注解的属性：

注解的属性可以包括String类型，Class类型，8个基本类型，8个基本类型加String类型的数组类型，枚举类型，注释类型。

如果注解中有一个名称为value的属性，且只需设置value属性（即其他属性都采用默认或者在另一个注解中设置），可以直接写成，如@MyAnnotation("xyz")。"xyz"假设是value的值。

如果数组只有一个元素，这时候属性值部分可以省略大括号。

综合实例

package cn.itcast.day02;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//元注解
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface ItcastAnnotation {
	//基本类型的注解
	String color() default "green";
	//value属性的注解
	String value();
	//数组类型的注解
	int[] arrayAttr() default {1,3,5};
	//注解类型的属性
	MetaAnnotation annotationAttr() default @MetaAnnotation("1vb");

}

public @interface MetaAnnotation {
	String value();
}

@ItcastAnnotation(annotationAttr=@MetaAnnotation("ert"),color="red",value="xyd",arrayAttr={4,3,2})
//如果数组只有一个元素时可以写成arrayAttr=4
public class AnnotationTest {

	@SuppressWarnings("deprecation")
	@ItcastAnnotation("xyd")
	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.color());
			System.out.println(annotation.value());
			System.out.println(annotation.arrayAttr().length);
			System.out.println(annotation.annotationAttr().value());
		}		
	}
	
	@Deprecated
	public static void sayHello(){
		System.out.print("hello");
	}
}

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