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

原创于 2024-05-09 02:52:58 发布 · 548 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

程序员

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 流入门。

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