如何忽略 Jackson JSON-to-Object 映射中的枚举字段？

Question

我有一个类似的 JSON 对象：

{"name":"John", "grade":"A"}

要么

{"name":"Mike", "grade":"B"}

要么

{"name":"Simon", "grade":"C"}

等等

我正在尝试将上述 JSON 映射到：

@JsonIgnoreProperties(ignoreUnknown = true)
public class Employee{
      @JsonIgnoreProperties(ignoreUnknown = true)
      public enum Grade{ A, B, C }
      Grade grade;
      String name;

  public Grade getGrade() {
    return grade;
  }

  public void setGrade(Grade grade) {
    this.grade = grade;
  }

  public String getName() {
    return name;
  }

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

上面的映射工作正常，但将来会有更多的“等级”类型，比如 D、E 等，这会破坏现有的映射并抛出以下异常

05-08 09:56:28.130: W/System.err(21309): org.codehaus.jackson.map.JsonMappingException: Can not construct instance of Employee from String value 'D': value not one of declared Enum instance names

有没有办法忽略枚举类型中的未知字段？

谢谢

Answer 1

我找到了一种方法来做到这一点，如下所示：

public static void main(String[] args) throws JsonParseException, JsonMappingException, UnsupportedEncodingException, IOException {
    String json = "{\"name\":\"John\", \"grade\":\"D\"}";

    ObjectMapper mapper = new ObjectMapper();
    mapper.configure(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL, true);
    Employee employee = mapper.readValue(new ByteArrayInputStream(json.getBytes("UTF-8")), Employee.class);

    System.out.println(employee.getGrade());
}

这输出：

无效的

其他类：

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)
public class Employee {
    private String name;
    private Grade grade;

    public String getName() {
        return name;
    }

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

    public Grade getGrade() {
        return grade;
    }

    public void setGrade(Grade grade) {
        this.grade = grade;
    }
}



import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)
public enum Grade {A, B, C}

我还没有遇到用注释来做到这一点的方法。

我希望这有帮助。

Answer 2

我认为您应该为Grade枚举定义外部解串器。

我向枚举添加了额外的字段 - 未知：

enum Grade {
    A, B, C, UNKNOWN;

    public static Grade fromString(String value) {
        for (Grade grade : values()) {
            if (grade.name().equalsIgnoreCase(value)) {
                return grade;
            }
        }

        return UNKNOWN;
    }
}
class Employee {

    @JsonDeserialize(using = GradeDeserializer.class)
    private Grade grade;
    private String name;

    public Grade getGrade() {
        return grade;
    }

    public void setGrade(Grade grade) {
        this.grade = grade;
    }

    public String getName() {
        return name;
    }

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

    @Override
    public String toString() {
        return "Employee [grade=" + grade + ", name=" + name + "]";
    }
}

现在，解析器看起来像这样：

class GradeDeserializer extends JsonDeserializer<Grade> {
    @Override
    public Grade deserialize(JsonParser parser, DeserializationContext context)
            throws IOException, JsonProcessingException {
        return Grade.fromString(parser.getValueAsString());
    }
}

用法示例：

public class JacksonProgram {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        JsonFactory jsonFactory = new JsonFactory();
        JsonParser parser = jsonFactory
                .createJsonParser("{\"name\":\"John\", \"grade\":\"D\"}");
        Employee employee = objectMapper.readValue(parser, Employee.class);
        System.out.println(employee);
    }

}

输出：

Employee [grade=UNKNOWN, name=John]

例如，如果您不想添加其他字段，则可以返回null 。

Answer 3

与@JsonDeserialize相比， @JsonDeserialize @JsonCreator提供了更简洁的解决方案。

我们的想法是来注释valueOf()替代（称为safeValueOf()在这个例子中）与@JsonCreator ，然后杰克逊会使用您的实现反序列化的字符串。

请注意，实现位于枚举内部，您可以将其用作其他对象中的字段而无需更改。

下面的解决方案包含在单元测试中，因此您可以直接运行它。

import static junit.framework.TestCase.assertEquals;

import java.io.IOException;

import org.junit.Test;

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

public class EmployeeGradeTest {

    public enum Grade {
        A, B, C, OTHER;

        @JsonCreator
        public static Grade safeValueOf(String string) {
            try {
                return Grade.valueOf(string);
            } catch (IllegalArgumentException e) {
                return OTHER;
            }
        }
    }

    @Test
    public void deserialize() throws IOException {
        assertEquals(Grade.A, new ObjectMapper().readValue("\"A\"", Grade.class));
    }

    @Test
    public void deserializeNewValue() throws IOException {
        assertEquals(Grade.OTHER, new ObjectMapper().readValue("\"D\"", Grade.class));
    }
}

Answer 4

我正在使用 boot2（尽管这也可以在引导 1 中工作）但您可以在应用程序属性/yaml 中启用反序列化功能；

spring:
  jackson:
    deserialization:
      READ_UNKNOWN_ENUM_VALUES_AS_NULL: true

Answer 5

这种情况有两种处理方式：

选项 1：将未知枚举值替换为null

为此，在ObjectMapper启用READ_UNKNOWN_ENUM_VALUES_AS_NULL设置。 在此之后，当您解析具有未知枚举字段值的 Object 时，它将被反序列化为null 。 参考下面的示例代码：

import com.fasterxml.jackson.databind.*;

public static ObjectMapper getMapper() {
    return ObjectMapper().enable(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL);
}

选项 2：用默认枚举值替换未知枚举值（比如UNKNOWN ）

为此，首先在ObjectMapper启用READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE设置。 然后，在您的枚举类中，使用@JsonEnumDefaultValue注释要用作默认枚举值的@JsonEnumDefaultValue 。 参考下面的代码示例：

import com.fasterxml.jackson.databind.*;

public static ObjectMapper getMapper() {
    return ObjectMapper().enable(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE);
}


public enum YourEnum {
   A,
   B,
   C,
   @JsonEnumDefaultValue UNKNOWN;

}