不吹牛逼，撸个注解有什么难的

柔情只为你懂 2021-05-12 11:49 364阅读 0赞

注解是 Java 中非常重要的一部分，但经常被忽视也是真的。之所以这么说是因为我们更倾向成为一名注解的使用者而不是创建者。`@Override` 注解用过吧？`@Service` 注解用过吧？但你知道怎么自定义一个注解吗？

恐怕你会摇摇头，摆摆手，不好意思地承认自己的确没有自定义过。

![format_png][]

### 01、注解是什么 ###

注解（Annotation）是在 Java 1.5 时引入的概念，同 class 和 interface 一样，也属于一种类型。注解提供了一系列数据用来装饰程序代码（类、方法、字段等），但是注解并不是所装饰代码的一部分，它对代码的运行效果没有直接影响（这句话怎么理解呢？），由编译器决定该执行哪些操作。

来看一段代码，我随便写的，除了打印到控制台的那句宣传语，其他都不重要，嘻嘻。

public class AutowiredTest { 
        @Autowired
        private String name;
    
        public static void main(String[] args) { 
            System.out.println("沉默王二，一枚有趣的程序员");
        }
    }

注意到 `@Autowired` 这个注解了吧？它本来是为 Spring 容器注入 Bean 的，现在被我无情地扔在了成员变量 name 的身上，但这段代码所在的项目中并没有启用 Spring，意味着 `@Autowired` 注解此时只是一个摆设。

我之所以举这个无聊的例子就是为了证明一个观点：注解对代码的运行效果没有直接影响，明白我的用意了吧？

### 02、注解的生命周期 ###

注解的生命周期有 3 种策略，定义在 RetentionPolicy 枚举中。

1）SOURCE：在源文件中有效，被编译器丢弃。

2）CLASS：在编译器生成的字节码文件中有效，但在运行时会被处理类文件的 JVM 丢弃。

3）RUNTIME：在运行时有效。这也是注解生命周期中最常用的一种策略，它允许程序通过反射的方式访问注解，并根据注解的定义执行相应的代码。

### 03、注解装饰的目标 ###

注解的目标定义了注解将适用于哪一种级别的 Java 代码上，有些注解只适用于方法，有些只适用于成员变量，有些只适用于类，有些则都适用。

截止到 Java 9，注解的类型一共有 11 种，定义在 ElementType 枚举中。

1）TYPE：用于类、接口、注解、枚举

2）FIELD：用于字段（类的成员变量），或者枚举常量

3）METHOD：用于方法

4）PARAMETER：用于普通方法或者构造方法的参数

5）CONSTRUCTOR：用于构造方法

6）LOCAL\_VARIABLE：用于变量

7）ANNOTATION\_TYPE：用于注解

8）PACKAGE：用于包

9）TYPE\_PARAMETER：用于泛型参数

10）TYPE\_USE：用于声明语句、泛型或者强制转换语句中的类型

11）MODULE：用于模块

### 04、开始撸注解 ###

说再多，都不如撸个注解来得让人心动。撸个什么样的注解呢？一个字段注解吧，它用来标记对象在序列化成 JSON 的时候要不要包含这个字段。

@Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.FIELD)
    public @interface JsonField { 
        public String value() default "";
    }

1）JsonField 注解的生命周期是 RUNTIME，也就是运行时有效。

2）JsonField 注解装饰的目标是 FIELD，也就是针对字段的。

3）创建注解需要用到 `@interface` 关键字。

4）JsonField 注解有一个参数，名字为 value，类型为 String，默认值为一个空字符串。

为什么参数名要为 value 呢？有什么特殊的含义吗？

当然是有的，value 允许注解的使用者提供一个无需指定名字的参数。举个例子，我们可以在一个字段上使用 `@JsonField(value = "沉默王二")`，也可以把 `value =` 省略，变成 `@JsonField("沉默王二")`。

那 `default ""` 有什么特殊含义吗？

当然也是有的，它允许我们在一个字段上直接使用 `@JsonField`，而无需指定参数的名和值。

### 05、使用注解 ###

是骡子是马拉出来遛遛，对吧？现在 `@JsonField` 注解已经撸好了，接下来就到了怎么使用它的环节。

假设有一个作者类，他有 3 个字段，分别是 age、name 和 bookName，后 2 个是必须序列化的字段。

public class Writer { 
        private int age;
    
        @JsonField("writerName")
        private String name;
    
        @JsonField
        private String bookName;
    
        public Writer(int age, String name, String bookName) { 
            this.age = age;
            this.name = name;
            this.bookName = bookName;
        }
    
        // getter / setter
    
        @Override
        public String toString() { 
            return "Writer{" +
                    "age=" + age +
                    ", name='" + name + '\'' +
                    ", bookName='" + bookName + '\'' +
                    '}';
        }
    }

1）name 上的 `@JsonField` 注解提供了显式的字符串值。

2）bookName 上的 `@JsonField` 注解使用了缺省项。

接下来，我们来编写序列化类 JsonSerializer，内容如下：

public class JsonSerializer { 
        public static String serialize(Object object) throws IllegalAccessException { 
            Class<?> objectClass = object.getClass();
            Map<String, String> jsonElements = new HashMap<>();
            for (Field field : objectClass.getDeclaredFields()) { 
                field.setAccessible(true);
                if (field.isAnnotationPresent(JsonField.class)) { 
                    jsonElements.put(getSerializedKey(field), (String) field.get(object));
                }
            }
            return toJsonString(jsonElements);
        }
    
        private static String getSerializedKey(Field field) { 
            String annotationValue = field.getAnnotation(JsonField.class).value();
            if (annotationValue.isEmpty()) { 
                return field.getName();
            } else { 
                return annotationValue;
            }
        }
    
        private static String toJsonString(Map<String, String> jsonMap) { 
            String elementsString = jsonMap.entrySet()
                    .stream()
                    .map(entry -> "\"" + entry.getKey() + "\":\"" + entry.getValue() + "\"")
                    .collect(Collectors.joining(","));
            return "{" + elementsString + "}";
        }
    }

JsonSerializer 类的内容看起来似乎有点多，但不要怕，我一点点来解释，直到你搞明白为止。

1）`serialize()` 方法是用来序列化对象的，它接收一个 Object 类型的参数。`objectClass.getDeclaredFields()` 通过反射的方式获取对象声明的所有字段，然后进行 for 循环遍历。在 for 循环中，先通过 `field.setAccessible(true)` 将反射对象的可访问性设置为 true，供序列化使用（如果没有这个步骤的话，private 字段是无法获取的，会抛出 IllegalAccessException 异常）；再通过 `isAnnotationPresent()` 判断字段是否装饰了 `JsonField` 注解，如果是的话，调用 `getSerializedKey()` 方法，以及获取该对象上由此字段表示的值，并放入 jsonElements 中。

2）`getSerializedKey()` 方法用来获取字段上注解的值，如果注解的值是空的，则返回字段名。

3）`toJsonString()` 方法借助 Stream 流的方式返回格式化后的 JSON 字符串。如果对 Stream 流比较陌生的话，请查阅我之前写的 [Stream 流入门][Stream]。

看完我的解释，是不是豁然开朗了？

![aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8xMTc5Mzg5LWFmN2Q3YzIzM2ZjMGZjYzguZ2lm][]

接下来，我们来写一个测试类 JsonFieldTest，内容如下：

public class JsonFieldTest { 
        public static void main(String[] args) throws IllegalAccessException { 
            Writer cmower = new Writer(18,"沉默王二","Web全栈开发进阶之路");
            System.out.println(JsonSerializer.serialize(cmower));
        }
    }

程序输出结果如下：

{"bookName":"Web全栈开发进阶之路","writerName":"沉默王二"}

从结果上来看：

1）Writer 类的 age 字段没有装饰 `@JsonField` 注解，所以没有序列化。

2）Writer 类的 name 字段装饰了 `@JsonField` 注解，并且显示指定了字符串“writerName”，所以序列化后变成了 writerName。

3）Writer 类的 bookName 字段装饰了 `@JsonField` 注解，但没有显式指定值，所以序列化后仍然是 bookName。

### 06、鸣谢 ###

好了，我亲爱的读者朋友，以上就是本文的全部内容了，是不是感觉撸个注解也没什么难的？你也赶紧动动小手试试吧！**原创不易，莫要白票，请你为本文点赞个吧**，这将是我写作更多优质文章的最强动力。

### 非常感谢大家的阅读！谢谢！ ###

记得之前总结过一篇 Java 的自学路线，洋洋 3 万多字，但没有得到 CSDN 的流量加持，阅读的人数不多，但我只能说，读到的同学都赚到了。贴一张这篇文章下面的留言大家就明白了。

![format_png 1][]

我是 2008 年上的大学，因为离二本线差了几分，就被迫上了大专，因为那时候三本的学费还是挺贵的——坊间流传一句话，一本的教育经费出在三本这个羊毛上，扎心了。尽管大一学的就是 Java，但你知道，那时候国内的软件行业还很萧条，至少在我们学校是这样的。教我们专业课的老师都是零基础，自学的，你想，能把我们教成什么模样。

班里流淌的情绪都是悲观的，绝大多数的同学都担心毕业后找不到工作，我就是其中之一，所以大家都不怎么想学编程。我大二结束后去了一家培训公司，大三就没在学校上课。

现在回想起来，真的是后悔极了。假如那时候用心地学一学，毕业后去一线城市找份工作，完全是能办得到的事情，毕竟那时候 Java 工程师是很吃香的。但世界上没有卖后悔药的商店。

因此，我虽然毕业了很多年，但仍然心系着各位学弟学妹们，就希望能够通过自己的分享帮助大家少走一些弯路，毕竟我们祖国的繁荣昌盛，需要更多的大学生助力，你们学到的越多，那未来祖国的建设，就越有希望——上纲上线下。

我组建了一些非常高质量的技术交流群（比如说黑铁时代、青铜时代、白银时代、黄金时代），如果恰好需要的话，可以加我微信：**qing\_geee**，非常期待与你的相遇！

对了，如果你想第一时间阅读我的文章，请微信搜索“**沉默王二**”，回复关键字「**666**」更有我为你精心准备的学习资料和 高质量教学视频。

![format_png 2][]

[format_png]: /images/20210511/084b1c00b5e04d2eb1584e0f023d156c.png
[Stream]: https://mp.weixin.qq.com/s/7hNUjjmqKcHDtymsfG_Gtw
[aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8xMTc5Mzg5LWFmN2Q3YzIzM2ZjMGZjYzguZ2lm]: /images/20210511/9e1ee69d8cfe43fe943a265e687739c8.png
[format_png 1]: /images/20210511/3dd6ca255a4f43cfa4210d5c453050b9.png
[format_png 2]: /images/20210511/5a686443360046eeaf139d77bc44b9e1.png