Java零基础进阶篇之注解（一）

​​​​​​本篇文章讲解的知识点主要围绕注解，废话不多说，只分享Java相关的干货！

注解（注释，标注，Annotation）的作用

如果要对于注解的作用进行分类，我们可以根据它所起的作用，大致可分为三类：

• 编写文档：通过代码里标识的元数据生成文档。
• 代码分析：通过代码里标识的元数据对代码进行分析。
• 编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查。

基本内置注释

• @Override 注释能实现编译时检查，你可以为你的方法添加该注释，以声明该方法是用于覆盖父类中的方法。如果该方法不是覆盖父类的方法，将会在编译时报错。例如我们为某类重写 toString() 方法却写成了 tostring() ，并且我们为该方法添加了@Override 注释，那么编译是无法通过的。
• @Deprecated 的作用是对不应该在使用的方法添加注释，当编程人员使用这些方法时，将会在编译时显示提示信息，它与 javadoc 里的 @deprecated 标记有相同的功能。
• @SuppressWarnings 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参数值都是已经定义好了的，我们选择性的使用就好了，参数如下：
• deprecation 使用了过时的类或方法时的警告
• unchecked 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型
• fallthrough 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
• path 在类路径、源文件路径等中有不存在的路径时的警告
• serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告
• finally 任何 finally 子句不能正常完成时的警告
• all 关于以上所有情况的警告

 

定制注释类型

我们可以自定义注解类型，如下例：

public @interface NewAnnotation {

}

使用定制的注释类型

 

我们已经成功地创建好一个注释类型 NewAnnotation ，现在让我们来尝试使用它。

public class AnnotationTest {

     @NewAnnotation

     public static void main(String[] args) {

     }

}

添加变量

J2SE 5.0 里，我们了解到内置注释@SuppressWarnings() 是可以使用参数的，那么自定义注释能不能定义参数个数和类型呢？

答案是当然可以，但参数类型只允许为基本类型、String 、Class 、枚举类型、数组等，并且参数不能为空。我们来扩展 NewAnnotation ，为之添加一个String 类型的参数，示例代码如下：

使用该注释的代码如下，该注释的使用有两种写法。

为变量赋默认值

但还是很容易理解的，我们先定义一个枚举类型，然后将参数设置为该枚举类型，并赋予默认值。

这样用：

限定注释使用范围 （在注解定义上使用@Target，这个@Target 注解是用来限定其他注解的。）

当我们的自定义注释不断的增多也比较复杂时，就会导致有些开发人员使用错误。为此，Java 提供了一个ElementType枚举类型来控制每个注释的使用范围，比如说某些注释只能用于普通方法，而不能用于构造函数等。下面是 Java 定义的ElementType 枚举

下面我们来修改Greeting 注释，为之添加限定范围的语句，这里我们称它为目标（Target ）使用方法也很简单，如下：

正如上面代码所展示的，我们只允许 Greeting 注释标注在普通方法和构造函数上，使用在包申明、类名等时，会提示错误信息。

注释保持性策略 （注解@Retention 也是用来修饰其他注解的。）

RetentionPolicy 的使用方法与 ElementType 类似，简单代码示例如下：

@Retention(RetentionPolicy.RUNTIME)

文档化功能

Java 提供的Documented 元注释跟 Javadoc 的作用是差不多的，其实它存在的好处是开发人员可以定制 Javadoc 不支持的文档属性，并在开发中应用。它的使用跟前两个也是一样的，简单代码示例如下：

值得大家注意的是，如果你要使用@Documented 元注释，你就得为该注释设置 RetentionPolicy.RUNTIME 保持性策略。

标注继承

它的作用是控制注释是否会影响到子类，简单代码示例如下：

读取注释信息

当我们想读取某个注释信息时，我们是在运行时通过反射来实现的，所以我们需要将保持性策略设置为 RUNTIME ，也就是说只有注释标记了@Retention(RetentionPolicy.RUNTIME) 的，我们才能通过反射来获得相关信息，并实现读取AnnotationTest 类所有方法标记的注释并打印到控制台。

以上就是注解相关的知识点，持续更新中，配套视频教程，正在学习Java的同学们一定要关注哦~~

Java零基础进阶视频教程