注解

概述

     J2SE 5.0开始的技术Annotation。可以标注在类、字段、方法上。

注解与注释区别

    注释：给程序员阅读，对编译、运行没有影响

    注解：告诉编译器如何运行程序

作用

    1.告诉编译器如何运行程序

    2.简化（取代）配置文件

附加：@SuppressWarnings注解的关键字

关键字	用途
all	to suppress all warnings
boxing	to suppress warnings relative to boxing/unboxing operations
cast	to suppress warnings relative to cast operations
dep-ann	to suppress warnings relative to deprecated annotation
deprecation	to suppress warnings relative to deprecation
fallthrough	to suppress warnings relative to missing breaks in switch statements
finally	to suppress warnings relative to finally block that don’t return
hiding	to suppress warnings relative to locals that hide variable
incomplete-switch	to suppress warnings relative to missing entries in a switch statement (enum case)
nls	to suppress warnings relative to non-nls string literals
null	to suppress warnings relative to null analysis
rawtypes	to suppress warnings relative to un-specific types when using generics on class params
restriction	to suppress warnings relative to usage of discouraged or forbidden references
serial	to suppress warnings relative to missing serialVersionUID field for a serializable class
static-access	to suppress warnings relative to incorrect static access
synthetic-access	to suppress warnings relative to unoptimized access from inner classes
unchecked	to suppress warnings relative to unchecked operations
unqualified-field-access	to suppress warnings relative to field access unqualified
unused	to suppress warnings relative to unused code

常见注解

1. package com.cn.annotation;
3. import java.util.ArrayList;
4. import java.util.List;
6. /**
7. * Author：Liu Zhiyong（QQ：1012421396）
8. * Version：Version_1
9. * Date：2017年7月25日10:42:04
10. * Desc：注解
11. J2SE 5.0开始的技术Annotation。可以标注在类、字段、方法、参数、构造方法，以及局部变量上
13. 作用：
14. 1.告诉编译器如何运行程序
15. 2.简化（取代）配置文件
17. 附加：@SuppressWarnings注解的关键字
18. 关键字 用途
19. all to suppress all warnings
20. boxing to suppress warnings relative to boxing/unboxing operations
21. cast to suppress warnings relative to cast operations
22. dep-ann to suppress warnings relative to deprecated annotation
23. deprecation to suppress warnings relative to deprecation
24. fallthrough to suppress warnings relative to missing breaks in switch statements
25. finally to suppress warnings relative to finally block that don’t return
26. hiding to suppress warnings relative to locals that hide variable
27. incomplete-switch to suppress warnings relative to missing entries in a switch statement (enum case)
28. nls to suppress warnings relative to non-nls string literals
29. null to suppress warnings relative to null analysis
30. rawtypes to suppress warnings relative to un-specific types when using generics on class params
31. restriction to suppress warnings relative to usage of discouraged or forbidden references
32. serial to suppress warnings relative to missing serialVersionUID field for a serializable class
33. static-access to suppress warnings relative to incorrect static access
34. synthetic-access to suppress warnings relative to unoptimized access from inner classes
35. unchecked to suppress warnings relative to unchecked operations
36. unqualified-field-access to suppress warnings relative to field access unqualified
37. unused to suppress warnings relative to unused code
39. */
40. public class Demo1 {
42. /**
43. * 重写父类的方法
44. */
45. @Override
46. public String toString() {
47. // TODO Auto-generated method stub
48. return super.toString();
49. }
51. /**
52. * 抑制编译器警告
53. */
54. @SuppressWarnings("unused")
55. void save(){
56. List list = null;
57. }
59. /**
60. * 2.抑制多类警告：2种方式
61. */
62. // @SuppressWarnings(value ={"unused","rawtypes"})//rawtypes 抑制没有指定泛型类型的警告
63. @SuppressWarnings({"unused","rawtypes"})//rawtypes 抑制没有指定泛型类型的警告
64. void save1(){
65. List list = null;
66. }
68. /**
69. * 3.抑制所有警告
70. */
71. @SuppressWarnings({"all"})//all 抑制所有警告
72. void save2(){
73. new ArrayList();
74. ArrayList list = null;
75. }
77. /**
78. * 标记过时的方法
79. */
80. @Deprecated
81. void save3(){
83. }
85. }

自定义注解

    定义方法：

          新的  Annotation  类型使用 @interface   关键字   

    作用：

               通过自定义注解，可以给类、字段、方法上添加描述信息！

    自定义注解写法：

1. package com.cn.annotation;
3. import java.util.Date;
5. /**
6. * 自定义注解
7. * 功能：描述作者
8. * @author liuzhiyong
9. *
10. */
11. public @interface Author {
12. /**
13. * 注解属性
14. * 1.修饰符只能为public（默认为public abstract）
15. * 2.不能有主体
16. */
17. public abstract String name();
18. /**
19. * 带默认值的注解属性；使用的时候就可以不用写此属性
20. * @return
21. */
22. public abstract int age() default 24;
24. /**
25. * 注解属性类型为数组
26. * @return
27. */
28. String[] like();
30. /**
31. *  默认名称的注解属性（Value）
32. ①如果注解属性名称只是value一个的时候，可以省略名称，直接给值；②但是有其它没有给默认值的属性的时候得写
33. * @return
34. */
35. String value();
36. }

    自定义注解的使用：

1. package com.cn.annotation;
3. import java.lang.annotation.Annotation;
4. import java.lang.reflect.Method;
6. import org.junit.Test;
8. /**
9. * 自定义注解的语法
10. * @author liuzhiyong
11. *
12. */
13. public class Demo2 {
15. @Test
16. @Author(value ="默认属性名称的值", name = "木丁西", like = { "篮球", "乒乓" })
17. public void save() throws NoSuchMethodException, SecurityException{
20. }
21. }

元注解

     元注解指注解注解的注解 。 JDK 中定义了如下元 Annotation ：

          @Target:指定注解用于修饰类的哪个成员  @Target 包含了一个名为 value的枚举数组 属性 ，类型为 ElementType (JDK5开始) 的成员变量。

            value枚举数组类型的属性的值可取：

                    {

ElementType.TYPE, 修饰类、接口（包括注释类型）或枚举声明

                ElementType.METHOD,    修饰方法

                ElementType.FIELD,     修饰字段 （包括枚举常量）

                ElementType.PARAMETER,    修饰参数

                ElementType.CONSTRUCTOR,     修饰构造方法

                ElementType.LOCAL_VARIABLE    修饰局部 }

          @Retention :  只能用于修饰一个  Annotation  定义 ,  用于指定该  Annotation  可以保留的域 , @ Rentention   包含一个  RetentionPolicy   类型的成员变量 ,  通过这个变量指定域。

                    RetentionPolicy.SOURCE : 编译器直接丢弃这种策略的注解，只在源码级别有效

                    RetentionPolicy.CLASS:  编译器将把注解记录在   class   文件中.   当运行   Java   程序时, JVM   不会保留注解.   这是默认值

                    RetentionPolicy.RUNTIME:编译器将把注释记录在   class   文件中.   当运行   Java   程序时, JVM   会保留注解.   程序才可以通过反射获取该注解

         @Documented:  用于指定被该元  Annotation  修饰的  Annotation  类将被  javadoc 工具提取成文档。

          @Inherited:  被它修饰的  Annotation  将具有继承性 . 如果某个类使用了被  @Inherited  修饰的  Annotation,  则其子类将自动具有该注解

注解的反射

1. package com.cn.annotation;
3. import java.lang.annotation.Annotation;
4. import java.lang.reflect.Method;
6. import org.junit.Test;
8. /**
9. * 自定义注解的语法
10. * @author liuzhiyong
11. *
12. */
13. public class Demo2 {
15. @Author(value ="默认属性名称的值", name = "木丁西", like = { "篮球", "乒乓" })
16. private int id;
18. @Author(value ="默认属性名称的值", name = "木丁西", like = { "篮球", "乒乓" })
19. public Demo2() {
20. // TODO Auto-generated constructor stub
21. }
23. @Author(value ="默认属性名称的值", name = "木丁西", like = { "篮球", "乒乓" })
24. public void save() throws NoSuchMethodException, SecurityException{
26. }
28. @Test
29. public void testSave() throws Exception {
30. /**
31. * 获取注解信息：value, name, like, age
32. */
34. //1.先获取代表方法的Method类型
35. Method method = this.getClass().getDeclaredMethod("save");
37. //2.再获取方法上的注解
38. Author author = method.getAnnotation(Author.class);
39. //获取输出注解的信息
40. System.out.println(author.value() + "#" + author.name() + "#" + author.like().toString() + "#" + author.age());
42. }
44. }