会使用自定义注解 ≈ 好的程序员？教你结合 AOP 切面打印请求日志

一、前言

今天就带着大伙梳理一遍注解也就是 @interface 正确的打开方式，除此之外，结合 AOP 切面统一打印出入参日志，对于每个访问注解绑定的接口方法的请求都一目了然，不仅方便接口的调试，还能给你一个优雅、整齐且大方的控制台日志记录。

二、效果演示

2.1 访问接口

2.2 控制台日志输出

三、如何设计一个注解

3.1 概念

知其然，要知其所以然，所以我们先来康康官方对注解的描述是什么：

An annotation is a form of metadata, that can be added to Java source code. Classes, methods, variables, parameters and packages may be annotated. Annotations have no direct effect on the operation of the code they annotate.

翻译过来的大意是：

注释是一种元数据的形式，可以添加到Java源代码中。类，方法，变量，参数和包可以注释。注释对他们注释的代码的操作没有直接影响。

综上来说，注解其实相当于 Java 的一种特殊的数据类型，也可以把它当做一个可以自定义的标记去理解，和类、接口、枚举类似，可以使用在很多不同的地方并且对原有的操作代码没有任何影响，仅做中间收集和处理。

3.2 小试牛刀

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Excel {

    public String name();

    int sort() default Integer.MAX_VALUE;

    ... ...
}

说明（从上往下）：

• 使用该注解在程序运行时被 JVM 保留，并且被编译器记录到 class 文件中，所以能够通过 Java 反射机制读取到注解中的属性等
• 该注解仅能使用在字段上，不能用在类、方法、变量上
• 该注解有两个属性，一个是 name 另一个是 sort 属性，属性？你可能就会问了后边不是带一对圆括号嘛，不应该是方法吗？看似接口中定义的抽象方法，实则看没看到 default 关键字，官方管定义在注解内的是 注解类型元素 ，不过我习惯管它们叫属性，因为在使用注解时，总是以键值对的形式传参
• 访问修饰符必须为 public，不写默认为 public
• 圆括号不是定义方法参数的地方，也不能在括号中定义任何参数，这仅仅是一个特殊的写法罢了
• default 表示未设置该属性时的默认值，值需和类型保持一致
• 如果没有 default 默认值，表示该类型元素必须在后续赋值