注释和注解

注释和注解

1.什么是注解

java.annotation包

Annotation是从JDK1.5开始引入的新技术，注解即可以对程序员解释又可以对程序解释

2.注解与注释的区别

注释：对程序员解释代码信息

注解：对程序和程序员解释代码信息

3.注解的作用

1. 不是程序本身，可以对程序作出解释（与注释(comment)类似）

2. 可以被其他程序（编译器）读取

4.注解的格式

注解是以“@注释名”在代码中存在的，还可以添加一些参数

例如：@SuppressWarnings(value="unchecked")

5.注解的应用

可以附加在package、class、method、field等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制实现对这些数据的访问

6.内置注解

@Overrlde：定义在java.lang.Override中，此注解只适用于修饰方法，表示一个方法声明打算重写超类中的另一个方法声明

@Deprecated：定义在java.lang.Deprecated中.此注解可以用于修饰方法，属性，类。表示不鼓励使用这样的元素.通常是因为它很危险或者存在更好的选择

@SuppressWarnings：镇压警告，定义在java.lang.SuppressWarnings中用来抑制编译时的警告信息，与前两个注释有所不同.你需要添加参数才能正确使用。这些参数都是已经定义好了的.我们选择性的使用就好了

@SuppressWarnings("all")抑制所有类型的警告信息

@SuppressWarnings("unchecked")抑制单类型的警告信息

@SuppressWarnings(value={"unchecked","deprecation"})抑制多类型的警告信息

7.元注解

元注解的作用：负责注解其他注解，Java定义了4个标准的meta-annotation类型，他们被用来提供对其他annotation类型作说明

这些类型和它们所支持的类在java.lang.annotation包中可以找到

（@Target，@Retention，@Documented，@Inherited )

@Target：用于描述注解的使用范围(即:被描述的注解可以用在什么地方）

@Retention：表示需要要在什么级别保存该注择信息，用于描述注解的生命周期

(SOURCE < CLASS < RUNTIME)

@Document：说明该注解将被包含在javadoc中

@lnherited：说明子类可以继承父类中的该注解

8.自定义注解

使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口

分析：

@interface用来声明一个注解，格式：public @interface注解名{定义内容}

其中的每一个方法实际上是声明了一个配置参数.

方法的名称就是参数的名称.

返回值类型就是参数的类型（返回值只能是基本类型、Class、String、enum）

可以通过default来声明参数的默认值

如果只有一个参数成员，一般参数名为value()

注解元素必須要有值，我们定义注解元素时，经常使用空字符串、0作为默认值

@Target({TYPE,FIELD,CONSTRUCTOR,METHOD,PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotaction {
​
    String value();
}

 public class Test01 {

        /**

         * 知识点：自定义注解

         */ ​

        @MyAnnotaction("aaa")

        String str; ​

        @MyAnnotaction("aaa")

        public Test01() {

         } ​

        @MyAnnotaction(value = "aaa")

         public void method01() {

         } ​

        @MyAnnotaction("aaa")

        public void method02(@MyAnnotaction("aaa") int i) {

        }

}