注解(Annotation)

最新推荐文章于 2023-05-06 14:41:21 发布

原创最新推荐文章于 2023-05-06 14:41:21 发布 · 383 阅读

0 ·

CC 4.0 BY-SA版权

java 专栏收录该内容

12 篇文章

订阅专栏

本文详细阐述了Java注解的定义、应用及其生命周期管理，包括如何为注解添加属性和自定义注解的实现方式。同时展示了如何利用注解进行代码注释优化和属性获取。

注解(Annotation)，（jdk1.5的新特性）

什么是注解：每一个注解就是一个类

API中的常用注解：

@SuppressWarnings() 压缩警告

@Override 覆盖（结合HashSet讲解，一个自己定义的类覆盖hashCode方法时）

@Deprecated 过时

Ø注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。

Ø看java.lang包，可看到JDK中提供的最基本的annotation。

注解的应用结构图

自定义注解（在interface前面加一个@）

public @interface ItcastAnnotation {
}

@Retention 元注解，用来解释注解的注解

注解的生命周期分为3个阶段，对应的三种取值为：（默认值为CLASS文件阶段）

RetentionPolicy.SOURCE(java源文件)

RetentionPolicy.CLASS(class文件)

RetentionPolicy.RUNTIME(内存中)

分别对应注解的生命周期 java源文件——》.class文件---》内存中

例子：

@Retention(RetentionPolicy.RUNTIME) //元注解,用来解释注解的注解
public @interface ItcastAnnotation {

}

@Target 元注解说明注解可以用在那个成分上面（类，方法，等）

使用方法：@Target（ElementType.METHOD）

@Retention(RetentionPolicy.RUNTIME) //元注解,用来解释注解的注解
//@Target(ElementType.METHOD)//定义为只能在方法中可用这个注解
@Target({ElementType.METHOD,ElementType.TYPE})//定义可以用在方法和类上面，TYPE为Class的父类
public @interface ItcastAnnotation {

}

注解的应用为注解增加基本属性

可以理解为接口中定义方法，但是稍有不同，如下

@Retention(RetentionPolicy.RUNTIME) //元注解,用来解释注解的注解
//@Target(ElementType.METHOD)//定义为只能在方法中可用这个注解
@Target({ElementType.METHOD,ElementType.TYPE})//定义可以用在方法和类上面，TYPE为Class的父类
public @interface ItcastAnnotation {
	String color() default "red";//设置默认值为"red"
	String value();
	int[] arrayAttr() default {3,4,5};
	EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;
	MetaAnnotation annotation() default @MetaAnnotation("asdf");
}

注意：default后面为属性的默认值，

public @interface MetaAnnotation {
	String value();
}
//-----------------------调用演示
//注解使用的时候要求必须填写所有的属性的内容，有默认值的可以不填写
@ItcastAnnotation(annotation=@MetaAnnotation("lxl"),color="red",value="abc",arrayAttr=1)//数组如果只有一个值的时候可以省略｛｝
public class AnnotationTest {

	/**
	 * @param args
	 */
	@SuppressWarnings("deprecation")
	@ItcastAnnotation("xyz")//如果只有value属性需要设值就可以省略"value="
	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.annotation());//调用注解的属性
			System.out.println(annotation.lamp());//调用注解的属性
		}
	}

	@Deprecated
	public static void sayHello(){
		System.out.println("helloWord");
	}
}

注解的属性的返回类型：8个基本数据类型，String，Class，Enum，注解和前面提到的类型的数组