2-注解

一、基本介绍

注解的理解

1. 注解(Annotation)也被称为元数据(Metadata)，用于修饰解释 包、类、方法、属性、构造器、局部变量等数据信息。
2. 和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息。
3. 在 JavaSE 中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在 JavaEE 中注解占据了更重要的角 色，例如用来配置应用程序的任何切面，代替 java EE 旧版中所遗留的繁冗代码和 XML 配置等。

基本的 Annotation 介绍
使用 Annotation 时要在其前面增加 @ 符号, 并把该 Annotation 当成一个修饰符使用。用于修饰它支持的程序元
素
三个基本的 Annotation:

1. @Override: 限定某个方法，是重写父类方法, 该注解只能用于方法
2. @Deprecated: 用于表示某个程序元素(类, 方法等)已过时
3. @SuppressWarnings: 抑制编译器警告

二、逐个分析

1.override

重写

2.Deprecated

1. @Deprecated 修饰某个元素, 表示该元素已经过时 //

2. 即不在推荐使用，但是仍然可以使用

3. 查看 @Deprecated 注解类的源码 韩顺平循序渐进学 Java 零基础 第 495页

4. 可以修饰方法，类，字段, 包, 参数 等等

5. @Deprecated 可以做版本升级过渡使用

   @Documented
   @Retention(RetentionPolicy.RUNTIME)
   @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
   public @interface Deprecated {
   }
   */
   @Deprecated
   class A {
   @Deprecated
   public int n1 = 10;
   @Deprecated
   public void hi(){
   }
   }

3. SuppressWarnings 抑制编译警告。

​

//1. 当我们不希望看到这些警告的时候，可以使用 SuppressWarnings 注解来抑制警告信息
//2. 在{“”} 中，可以写入你希望抑制(不显示)警告信息

@SuppressWarnings("{all,boxing,}")

3. 可以指定的警告类型有:

• all，抑制所有警告

• boxing，抑制与封装/拆装作业相关的警告

• cast，抑制与强制转型作业相关的警告

• dep-ann，抑制与淘汰注释相关的警告

• deprecation，抑制与淘汰的相关警告

• fallthrough，抑制与 switch 陈述式中遗漏 break 相关的警告

• finally，抑制与未传回 finally 区块相关的警告

• hiding，抑制与隐藏变数的区域变数相关的警告

• incomplete-switch，抑制与 switch 陈述式(enum case)中遗漏项目相关的警告

• javadoc，抑制与 javadoc 相关的警告

• nls，抑制与非 nls 字串文字相关的警告

• null，抑制与空值分析相关的警告

• rawtypes，抑制与使用 raw 类型相关的警告

• resource，抑制与使用 Closeable 类型的资源相关的警告

• restriction，抑制与使用不建议或禁止参照相关的警告

• serial，抑制与可序列化的类别遗漏 serialVersionUID 栏位相关的警告

• static-access，抑制与静态存取不正确相关的警告

• static-method，抑制与可能宣告为 static 的方法相关的警告

• super，抑制与置换方法相关但不含 super 呼叫的警告

• synthetic-access，抑制与内部类别的存取未最佳化相关的警告

• sync-override，抑制因为置换同步方法而遗漏同步化的警告

• unchecked，抑制与未检查的作业相关的警告

• unqualified-field-access，抑制与栏位存取不合格相关的警告

• unused，抑制与未用的程式码及停用的程式码相关的警告

4. 作用范围和放置的位置有关。 —->通常放在 具体的语句/方法/类 ==上==

/比如 @SuppressWarnings 放置在 main 方法，那么抑制警告的范围就是 main

// 通常我们可以放置具体的语句,

三、元注解

元注解：修饰注解的注解

Target --> 在哪地方使用
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
Retention --> 注解的作用范围
    source 源码
    class 类
       runtime 运行时
@Retention(RetentionPolicy.SOURCE)
Documented 指定该注解是否会在 javadoc 体现
@Inherited 子类会继承父类注解。

1.Retention

• source
  编译器使用后，直接丢弃这种策略的注释。
• class
  编译器将注释记录放在 class 文件中，当运行 java 程序时，jvm 不会保留注解。
• runtime
  编译器保留在 class 文件中，jvm 会保留，可以通过反射获取该注释。

2.Target

3.Documented

4.inherited

A 具有 inherited 注解，B是 A 的子类，那么它将自动拥有这个注解