转:http://tomcat-oracle.iteye.com/blog/1964381
1.概述
注解可以定义到方法上,类上,一个注解相当与一个类,就相当于实例了一个对象,加上了注解,就相当于加了一个标志。
常用的注解:
@Override:表示重新父类的方法,
这个也可以判断是否覆盖的父类方法,在方法前面加上此语句,如果提示的错误,那么你不是覆盖的父类的方法,要是提示的没有错误,那么就是覆盖的父类的方法。
@SuppressWarnings("deprecation"):取消编译器的警告(例如你使用的方法过时了)
@Deprecated:在方法的最上边也上此语句,表示此方法过时,了,或者使用在类上面
- import java.util.ArrayList;
- import java.util.List;
- public class annotationDemo {
- /*
- * 对于集合,如果没有指定存储的类型,那么就会有安全警告,
- * 如果不想提示安全警告的话,那么就所在类或者方法上添加@SuppressWarnings(参数)
- */
- @SuppressWarnings("unchecked")
- public static void main(String[] args) {
- List list=new ArrayList();
- }
- }
2.自定义注解
1.格式
权限 @interface 注解名称 { }
步骤:
定义注解类--->定义应用注解类的类--->对应用注解类的类进行反射的类(这个类可以另外定义,也可以是在应用注解类中进行测试)
- import java.lang.annotation.Retention;
- importjava.lang.annotation.RetentionPolicy;
- //定义此注解保留在字节码中
- @Retention(RetentionPolicy.RUNTIME)
- public @interface MyAnnotation {
- }
- @MyAnnotation
- // 应用定义的注解类
- public class ApplyMyAnnotation {
- public static void main(String[] args) {
- if (ApplyMyAnnotation.class.isAnnotationPresent(MyAnnotation.class)) {// 判断此类上是否存在指定的注解类
- MyAnnotation annotation= (MyAnnotation) ApplyMyAnnotation.class
- .getAnnotation(MyAnnotation.class);
- System.out.println(annotation);
- }
- }
- }
2.声明周期
格式:例如:@Retention(RetentionPolicy.CLASS)
在自定一的注解类上定义周期,@Retention(参数类型) 参数类型是RetentionPolicy
RetentionPolicy.CLASS:类文件上,运行时虚拟机不保留注解
RetentionPolicy.RUNTIME:类文件上,运行时虚拟就保留注解
RetentionPolicy.SOURCE:源文件上,丢弃注解
SuppressWarnings和Override是RetentionPolicy.SOURCE,
Deprecated是在RetentionPolicy.RUNTIME,要向运行时调用定义的一样,那么必须是RetentionPolicy.RUNTIME,
默认的都是RetentionPolicy.CLASS:
3.指定目标
格式:例如:方法上@Target(ElementType.METHOD)
定义的注解可以注解什么成员。如果不声明此注解,那么就是可以放到任何程序的元素上。
可以是包,接口,参数,方法,局部变量,字段…等。
- //定义此注解保留在字节码中
- @Retention(RetentionPolicy.RUNTIME)
- @Target({ElementType.METHOD,ElementType.TYPE})//可以定义在方法上和类上接口,表示类型
- public @interface MyAnnotation {
- }
- @MyAnnotation
- // 应用定义的注解类
- public class ApplyMyAnnotation {
- @MyAnnotation//定义在方法上
- public static void main(String[] args) {
- if (ApplyMyAnnotation.class.isAnnotationPresent(MyAnnotation.class)) {// 判断此类上是否存在指定的注解类
- MyAnnotation annotation = (MyAnnotation) ApplyMyAnnotation.class
- .getAnnotation(MyAnnotation.class);
- System.out.println(annotation);
- }
- }
- }
3.为注解添加属性
1.类型
注解的属性置可以是:8个基本数据类型,String,枚举,注解,Class,数组类型,
2.注意点
当注 解中只有一个属性或者是只有一个属性需要赋值的话,那么在调用的时候,就可以直接写入,不需要指定属性名,
当注解的属性是数组类型并且赋值的时候只赋值一个值,那么就可以省略{}.
3.示例
3.1.属性类型(是String)
- import java.lang.annotation.ElementType;
- import java.lang.annotation.Retention;
- import java.lang.annotation.RetentionPolicy;
- import java.lang.annotation.*;
- //定义此注解保留在字节码中
- @Retention(RetentionPolicy.RUNTIME)
- public @interface MyAnnotation {
- String value() ;
- String Color()default "red";//设置默认值是"red"
- }
- @MyAnnotation("java")
- public class ApplyMyAnnotation {
- public static void main(String[] args) {
- /**
- * 这是获得类上的注解,也可以获得方法上的注解,下面就以获得类上的注解为例
- */
- if (ApplyMyAnnotation.class.isAnnotationPresent(MyAnnotation.class)) {// 判断此类上是否存在指定的注解类
- MyAnnotation annotation = (MyAnnotation) ApplyMyAnnotation.class
- .getAnnotation(MyAnnotation.class);
- System.out.println("value="+annotation.value());
- System.out.println("Color="+annotation.Color());
- }
- }
- }
结果:
value=java
Color=red
从调用的程序中,也可以看出,只有一个属性可以需要赋值的话,可以省略属性名。否则@注解类(属性名=值)
3.2.综合类型
- /*枚举类*/
- public enum Week{
- SUN,MON;
- }
- /**
- * 注解类
- */
- public @interface annotationText {
- String value();
- }
- import java.lang.annotation.ElementType;
- import java.lang.annotation.Retention;
- import java.lang.annotation.RetentionPolicy;
- import java.lang.annotation.*;
- //定义此注解保留在字节码中
- @Retention(RetentionPolicy.RUNTIME)
- public @interface MyAnnotation {
- String value() ;
- String Color()default "red";//设置默认值是"red"
- Week week() default Week.MON;//枚举类型
- int [] array() default {1,2,3};//数组类型
- annotationText annotation() default @annotationText("MY");//注解类型
- Class classDemo() default Integer.class;//Class类型
- }
- @MyAnnotation(value="java",Color="green",week=Week.SUN,array=5,annotation=@annotationText("YOU"),classDemo=String.class)//数组array={4,5,6}
- public class ApplyMyAnnotation {
- public static void main(String[] args) {
- /**
- * 这是获得类上的注解,也可以获得方法上的注解,下面就以获得类上的注解为例
- */
- if (ApplyMyAnnotation.class.isAnnotationPresent(MyAnnotation.class)) {// 判断此类上是否存在指定的注解类
- MyAnnotation annotation= (MyAnnotation) ApplyMyAnnotation.class
- .getAnnotation(MyAnnotation.class);
- System.out.println("value="+annotation.value());
- System.out.println("Color="+annotation.Color());
- System.out.println("week="+annotation.week());
- System.out.println("array长度="+annotation.array()。length);
- System.out.println("注解类型值="+annotation.annotation()。value());
- System.out.println("Class类型值="+annotation.classDemo());
- }
- }
- }
结果:
value=java
Color=green
week=SUN
array长度=1
注解类型值=YOU
Class类型值=classjava.lang.String
4.Method上的注解
- import java.lang.annotation.Retention;
- import java.lang.annotation.RetentionPolicy;
- /**
- * 注解类
- */
- @Retention(RetentionPolicy.RUNTIME)
- public @interface annotationText {
- String value();
- }
- public class ApplyMyAnnotation {
- public static void main(String[] args) throws Exception {
- Method methodshow = ApplyMyAnnotation.class.getMethod("show");
- annotationText anno = methodshow.getAnnotation(annotationText.class);
- System.out.println(anno.value());
- }
- @annotationText("java")
- public void show() {
- System.out.println("hello");
- }
- }
结果:
java