Java高新技术 注解



 Java高新技术 注解

知识概要：

                 （1）了解注解

（2）注解的应用结构图

（3）@Retention(RetentionPolicy.RUNTIME)

                 （4）@Target({ElementType.METHOD,ElementType.TYPE})

（5）为注解添加简单属性

（6）为注解添加复杂属性

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

先通过@SuppressWarnings的应用让大家认识和了解一下注解：

代码示例：

package com.itheima.day02;

public class AnnotationTest {

public static void main(String[] args) {

System.runFinalizersOnExit(true);

}

}

由上面的示例可以看到当执行一切过时的方法时，MyEclipse会自动划线，提示开发人员调用的方法已经过时，建议不要调用。

通过命令行进行编译也可以看到过时的提示，如下：

通过System.runFinalizersOnExit(true);的编译警告引出@SuppressWarnings("deprecation")

如果要看哪个方法已经过期，直接在编译时期加上详细信息重新编译。

@SuppressWarnings("deprecation")

此时，在main方法上添加一个注解：@SuppressWarnings("deprecation")，此注解的作用就是告诉编译器，虽然我用的方法过时了，但是我还是坚持要用，你就不要再提示了。

Java 5.0代码示例：

package com.itheima.day02;

public class AnnotationTest {

@SuppressWarnings("deprecation")

public static void main(String[] args) {

System.runFinalizersOnExit(true);

}

}

再在命令行窗口中进行编译，就不会出现过时提示了。

@Deprecated

直接在刚才的类中增加一个方法，并加上@Deprecated标注，在另外一个类中调用这个方法。

有时候我们写的方法被别人调用了，但是如果这个方法有一些Bug需要修改，可是如果我们修改了又会影响以前

已经调用这个方法的程序。 已提示别人不要再用了

这时候我们可以把这个方法设置为过时，然后重新写一个方法，这时候就需要用到@Deprecated注解。

Java 5.0代码示例：

package com.itheima.day02;

public class AnnotationTest {

public static void main(String[] args) {

sayHello();

}

@Deprecated

public static void sayHello(){

System.out.println("Hello 黑马程序员");

}

}

由上面的示例可以看到，我们的sayHello方法可以通过@Deprecated注解标记为过时，然后调用者调用该方法的地方就会被MyEclipse划上横线作为过时的提示

@Override

public boolean equals(Reflect other)方法与HashSet结合讲解

例如：equals方法的参数为Object obj，但是经常会被写错，这时候就可以通过@Override注解避免这种情况。

总结：

注解是JDK1.5的新特性。

一个注解就是一个类，使用注解，就相当于创建了一个类的实例对象。

注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，

则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无

何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法参数以及局部变量上

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

注解的应用结构图

Java 5.0 代码示例： 

package com.itheima.day02; 

/* 

 * 注解类 

 * */ 

public @interface HeiMaAnnotation { 

} 

package com.itheima.day02; 

/* 

 * 应用注解类的类 

 * */ 

@HeiMaAnnotation 

public class AnnotationTest { 

/* 

 * 通过反射调用"应用了注解类"的类 

 * */ 

public static void main(String[] args) { 

	boolean falg = AnnotationTest.class.isAnnotationPresent(HeiMaAnnotation.class); 

if (falg){ 

	HeiMaAnnotation heimaannotation =  AnnotationTest.class.getAnnotation(HeiMaAnnotation.class); 

	System.out.println(heimaannotation); 

		} 

	System.out.println(falg); 

	}
}

执行之后，控制台并没有打印出任何信息，原因是因为@HeiMaAnnotation注解的Retention元注解默认值

是RetentionPolicy.CLASS，也就是说@HeiMaAnnotation注解在运行的时候已经被过滤掉了。解决这个问题的方式就是将@HeiMaAnnotation的RetentionPolicy元注解值设置为RetentionPolicy.RUNTIME

/* 

 * 应用注解类的类 

 * */ 

package com.itheima.day02; 

import java.lang.annotation.Retention; 

import java.lang.annotation.RetentionPolicy; 

@Retention(RetentionPolicy.RUNTIME) 

public @interface HeiMaAnnotation { 

}

再次执行AnnotationTest.java，结果如下：

注意：元注解就是在注解上添加的注解。

@Retention元注解有三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME，分

别对应：Java源文件-->class文件-->内存中的字节码。

思考：@Override、@SuppressWarnings和@Deprecated这三个注解的@Retention元注解的value属性值分别是什么？

Target的默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了。

改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就不会报错了。

为注解增加各种属性

什么是注解的属性

一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是传智播客的学生，否则，就不是。如果还想区分出是传智播客哪个班的学生，这时候可以为胸牌在增加一个属性来进行区分。

加了属性的标记效果为：@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 com.itheima.day02; 

package cn.itheima.day2;

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

import cn.itheima.day1.EnumTest;
//元注解
//元数据
//元信息
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface HeiMaAnnotation {

	String color() default "red";
	String value();
	int []arrAttr() default{ 1, 2, 3 }; 

	EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;
	MetaAnnotation metaAnnotation() default @MetaAnnotation("黑马程序员");

}

//*************************************************************

package cn.itheima.day2;

public @interface MetaAnnotation {
	String value();
}

package cn.itheima.day2;

import cn.itheima.day1.EnumTest;

@HeiMaAnnotation(metaAnnotation=@MetaAnnotation("黑马程序员"), 

		        lamp= EnumTest.TrafficLamp.GREEN,
		        color="red",
		        value="黑马论坛",
		        arrAttr={1,2,3}
				)
public class AnnotationTest {

	@SuppressWarnings("deprecation")
	public static void main(String[] args)
	{	

		System.runFinalizersOnExit(true);
		sayHello();
		boolean flag= AnnotationTest.class.isAnnotationPresent(HeiMaAnnotation.class);

		if(flag)
		{

			HeiMaAnnotation heimaannotation =(HeiMaAnnotation)AnnotationTest.class.getAnnotation(HeiMaAnnotation.class);
			System.out.println(heimaannotation);

		MetaAnnotation annotation =heimaannotation.metaAnnotation(); 

		System.out.println(heimaannotation.color()); 

		System.out.println(heimaannotation.value()); 

		System.out.println(heimaannotation.arrAttr().length); 

		System.out.println(heimaannotation.lamp()); 

		System.out.println(annotation.value());
		}

	}

	@Deprecated
	public static void sayHello(){
		System.out.println("我是黑马程序员");
	}
}