详解Jackson的动态属性设置@JsonAnyGetter和@JsonAnySetter

码到三十五 ：

个人主页

心中有诗画，指尖舞代码，目光览世界，步履越千山，人间尽值得 !

---

---

目录

• 1️⃣ @JsonAnyGetter 注解

• 1.1 @JsonAnyGetter 注解的要求
• 1.2 @JsonAnyGetter 注解的使用

• 2️⃣@JsonAnySetter 注解

• 2.1 @JsonAnySetter 注解的要求
• 2.2 @JsonAnySetter 注解的使用

1️⃣ @JsonAnyGetter 注解

在 Jackson 中，@JsonAnyGetter 注解用于指示 Jackson 在序列化过程中取得对象动态属性的方法。它的作用是将动态属性以键值对的形式包含在序列化结果中。

1.1 @JsonAnyGetter 注解的要求

使用 @JsonAnyGetter 注解的方法必须满足以下要求：

1. 方法必须是公共的
2. 方法不能有参数
3. 方法的返回类型必须是 Map<String, Object> 或其子类

1.2 @JsonAnyGetter 注解的使用

下面是一个示例代码，演示了如何使用 @JsonAnyGetter 注解：

import com.fasterxml.jackson.annotation.JsonAnyGetter;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.HashMap;
import java.util.Map;

class User {
    private String name;
    private int age;
    private Map<String, Object> dynamicProps;

    public User(String name, int age) {
        this.name = name;
        this.age = age;
        this.dynamicProps = new HashMap<>();
    }

    public String getName() {
        return name;
    }

    public int getAge() {
        return age;
    }

    @JsonAnyGetter
    public Map<String, Object> getDynamicProps() {
        return dynamicProps;
    }
}

public class Example {
    public static void main(String[] args) throws Exception {
        User user = new User("John", 30);
        user.getDynamicProps().put("email", "[e-mail]");
        user.getDynamicProps().put("phone", "[phone]");

        ObjectMapper objectMapper = new ObjectMapper();
        String json = objectMapper.writeValueAsString(user);
        System.out.println(json);
    }
}

• User 类包含了 name 和 age 两个属性，以及一个名为 dynamicProps 的 Map 对象。我们向 dynamicProps 中添加了动态属性 “email” 和 “phone”。
• 通过在 User 类的 getDynamicProps() 方法上使用 @JsonAnyGetter 注解，我们告诉 Jackson 在序列化过程中将动态属性包含在 JSON 中。
• main() 方法中，我们创建了一个 User 对象并添加了动态属性。然后，我们使用 ObjectMapper 将 User 对象序列化为 JSON 字符串，并打印输出。
• 当 Jackson 执行序列化时，它会调用带有 @JsonAnyGetter 注解的方法，并将返回的键值对添加到生成的 JSON 中。

这样可以很方便地将动态属性包含在序列化结果中，而无需预先定义每个属性的字段。

2️⃣@JsonAnySetter 注解

@JsonAnySetter用于指示 Jackson 在反序列化过程中将动态属性设置到对象上。它的作用是接收动态属性的键值对，并将其设置到对象的属性中。

2.1 @JsonAnySetter 注解的要求

使用 @JsonAnySetter 注解的方法必须满足以下要求：

• 1） 方法必须是公共的
• 2） 方法的参数包括一个 String 类型的键和一个 Object 类型的值
• 3） 方法不能有返回值

2.2 @JsonAnySetter 注解的使用

下面是一个示例代码，演示了如何使用 @JsonAnySetter 注解：

import com.fasterxml.jackson.annotation.JsonAnySetter;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.HashMap;
import java.util.Map;

class User {
    private String name;
    private int age;
    private Map<String, Object> dynamicProps;

    public User() {
        this.dynamicProps = new HashMap<>();
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    @JsonAnySetter
    public void setDynamicProp(String key, Object value) {
        dynamicProps.put(key, value);
    }
}

public class Example {
    public static void main(String[] args) throws Exception {
        String json = "{\"name\":\"John\",\"age\":30,\"email\":\"[e-mail]\",\"phone\":\"[phone]\"}";

        ObjectMapper objectMapper = new ObjectMapper();
        User user = objectMapper.readValue(json, User.class);

        System.out.println("Name: " + user.getName());
        System.out.println("Age: " + user.getAge());
        System.out.println("Dynamic Properties: " + user.getDynamicProps());
    }
}

• User 类包含了 name 和 age 两个属性，以及一个名为 dynamicProps 的 Map 对象。我们使用 @JsonAnySetter 注解在 setDynamicProp() 方法上，表示这个方法用于接收动态属性。
• 在示例的 main() 方法中，我们创建了一个 JSON 字符串，其中包含了动态属性 “email” 和 “phone”，以及固定属性 “name” 和 “age”。
• 然后，我们使用 ObjectMapper 的 readValue() 方法将 JSON 字符串反序列化为 User 对象。在反序列化过程中，Jackson 会调用带有 @JsonAnySetter 注解的方法，将动态属性设置到对象的 dynamicProps 属性中。
• 最后，我们打印输出 User 对象的固定属性和动态属性。
• 通过在 User 类的 setDynamicProp() 方法上使用 @JsonAnySetter 注解，我们可以很方便地将动态属性设置到对象中。这样即使 User 类没有事先定义动态属性的字段，也能正确地接收和处理动态属性。