1. 说明

使用Jackson进行JSON序列化时，假如通过@JsonProperty注解指定了重复的字段（Java中的字段名称不同，但@JsonProperty注解属性中的名称相同），在不同情况下会有不同的结果，以下进行分析。

以下使用的Jackson版本为2.14.0。

2. 同一个类中存在重复字段

假如在同一个类中通过@JsonProperty注解指定了重复的字段，如下所示（get/set方法略）：

public class SameFieldsInSameClass {
@JsonProperty("json_property")
private String jsonProperty1;
@JsonProperty("json_property")
private String jsonProperty2;
}

使用Jackson默认的ObjectMapper对以上类进行JSON序列化时，会出现以上异常，即Jackson禁止同一个类中存在重复字段：

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Conflicting getter definitions for property "json_property": SameFieldsInSameClass#getJsonProperty1() vs SameFieldsInSameClass#getJsonProperty2()
at com.fasterxml.jackson.databind.exc.InvalidDefinitionException.from(InvalidDefinitionException.java:77)
at com.fasterxml.jackson.databind.SerializerProvider.reportBadDefinition(SerializerProvider.java:1306)
at com.fasterxml.jackson.databind.SerializerProvider._createAndCacheUntypedSerializer(SerializerProvider.java:1453)
at com.fasterxml.jackson.databind.SerializerProvider.findValueSerializer(SerializerProvider.java:550)
at com.fasterxml.jackson.databind.SerializerProvider.findTypedValueSerializer(SerializerProvider.java:828)
at com.fasterxml.jackson.databind.ser.DefaultSerializerProvider.serializeValue(DefaultSerializerProvider.java:308)
at com.fasterxml.jackson.databind.ObjectMapper._writeValueAndClose(ObjectMapper.java:4624)
at com.fasterxml.jackson.databind.ObjectMapper.writeValueAsString(ObjectMapper.java:3869)
at TestJSONUtil.toDenseJsonStr(TestJSONUtil.java:10)
at SameFieldsInSameClass.main(SameFieldsInSameClass.java:27)

3. 父类与子类中存在重复字段

假如分别在父类与子类中通过@JsonProperty注解指定了重复的字段，如下所示（get/set方法略）：

public class SameFieldsInDiffClassSuper {
@JsonProperty("json_property")
private String jsonPropertyInSuper;
}
public class SameFieldsInDiffClassChild extends SameFieldsInDiffClassSuper {
@JsonProperty("json_property")
private String jsonPropertyInChild;
}

创建子类SameFieldsInDiffClassChild的对象，使用Jackson默认的ObjectMapper进行JSON序列化的结果如下：

• 仅对父类字段赋值

将父类SameFieldsInDiffClassSuper中的jsonPropertyInSuper字段值设为"super"

进行JSON序列化时，结果为"{}"

• 仅对子类字段赋值

将子类中的jsonPropertyInChild字段值设为"child"，进行JSON序列化时，结果为"{“json_property”:“child”}"；

• 同时对父类与子类字段赋值

将父类SameFieldsInDiffClassSuper中的jsonPropertyInSuper字段值设为"super"，将子类中的jsonPropertyInChild字段值设为"child"，进行JSON序列化时，结果为"{“json_property”:“child”}"；

通过以上结果可以看到，父类中的重复字段未出现在序列化结果中，子类中的重复字段出现在序列化结果中。

4. 允许父类与子类中存在重复字段存在的问题

默认情况下，Jackson允许父类与子类中通过@JsonProperty注解指定重复字段（Java中的字段名称不同，但@JsonProperty注解属性中的名称相同），但只有子类中的对应字段会出现在序列化结果中，父类中的对应字段不会出现在序列化结果中。

以上特性在日常开发中可能会造成问题，例如在父类与子类中分别存在使用下线划与驼峰形式的字段，都通过@JsonProperty注解将名称设置为下划线的形式，假如调用了父类对应字段的set方法，则JSON序列化结果不会包含对应的字段，JSON序列化的结果会与预期不相同。

5. 禁止父类与子类中存在重复字段

为了禁止父类与子类中存在重复字段，可以通过以下方式对Jackson的JSON序列化处理进行修改。

5.1. 修改POJOPropertiesCollector对重复字段的处理

Jackson在找到重复字段时的处理由com.fasterxml.jackson.databind.introspect.POJOPropertiesCollector类的_renameProperties()方法处理。

可以重载以上方法，使Jackson找到重复字段时抛出异常，能够使存在重复字段的问题暴露出来：

• 创建POJOPropertiesCollector的子类；

• 重载_renameProperties()方法，修改“old.addAll(prop);”处理为抛出异常，其他代码保持不变；

• 在静态代码块中判断Jackson组件的版本，当版本与预期不一致时抛出异常，使得Jackson版本发生变化时能够发现，可能需要重新调整_renameProperties()方法的代码。

POJOPropertiesCollector子类静态代码块及构造函数示例代码如下：

public class TestPOJOPropertiesCollector extends POJOPropertiesCollector {
static {
if (PackageVersion.VERSION.getMajorVersion() != 2 ||
PackageVersion.VERSION.getMinorVersion() != 14 ||
PackageVersion.VERSION.getPatchLevel() != 0) {
throw new RuntimeException("jackson版本发生变化");
}
}
protected TestPOJOPropertiesCollector(MapperConfig<?> config, boolean forSerialization, JavaType type, AnnotatedClass classDef, AccessorNamingStrategy accessorNaming) {
super(config, forSerialization, type, classDef, accessorNaming);
}

POJOPropertiesCollector子类重载_renameProperties()方法并修改后的相关代码如下：

@Override
protected void _renameProperties(Map<String, POJOPropertyBuilder> props) {
// 代码省略
// and if any were renamed, merge back in...
if (renamed != null) {
for (POJOPropertyBuilder prop : renamed) {
String name = prop.getName();
POJOPropertyBuilder old = props.get(name);
if (old == null) {
props.put(name, prop);
} else {
// 在这里进行修改，抛出异常
throw new RuntimeException("出现重复字段");
// old.addAll(prop);
}
// 代码省略
}
}
}

5.2. 通过ClassIntrospector使用指定的POJOPropertiesCollector

Jackson在com.fasterxml.jackson.databind.introspect.BasicClassIntrospector类的constructPropertyCollector()方法中创建了需要使用的POJOPropertiesCollector类实例。

可以重载以上方法，使Jackson使用以上创建的POJOPropertiesCollector子类实例：

• 创建BasicClassIntrospector的子类；

• 重载constructPropertyCollector()方法，将返回对象类型由POJOPropertiesCollector修改为以上POJOPropertiesCollector的子类。

BasicClassIntrospector子类重载constructPropertyCollector()方法并修改后的代码如下：

public class TestBasicClassIntrospector extends BasicClassIntrospector {
@Override
protected POJOPropertiesCollector constructPropertyCollector(MapperConfig<?> config,
AnnotatedClass classDef,
JavaType type,
boolean forSerialization,
AccessorNamingStrategy accNaming) {
return new TestPOJOPropertiesCollector(config, forSerialization, type, classDef, accNaming);
}
}

5.3. 通过Module使用指定的ClassIntrospector

Jackson通过com.fasterxml.jackson.databind.Module类的setClassIntrospector()方法对ClassIntrospector类的实例进行设置。

向ObjectMapper注册Module时，Jackson会调用Module的setupModule()方法，可在Module子类的以上方法中通过setClassIntrospector()方法设置以上创建的ClassIntrospector子类实例：

• 创建SimpleModule（属于Module的子类）的子类；

• 重载setupModule()方法，在调用父类的该方法后，调用setClassIntrospector()方法设置以上创建的ClassIntrospector子类实例。

SimpleModule子类重载setupModule()方法并修改后的代码如下：

public class TestSimpleModule extends SimpleModule {
@Override
public void setupModule(SetupContext context) {
super.setupModule(context);
context.setClassIntrospector(new TestBasicClassIntrospector());
}
}

5.4. 在ObjectMapper中注册Module

在创建Jackson的com.fasterxml.jackson.databind.ObjectMapper对象后，可以通过registerModule()方法注册需要使用的Module。

创建ObjectMapper对象后，通过registerModule()注册以上创建的SimpleModule的子类，可以使以上BasicClassIntrospector子类、POJOPropertiesCollector子类依次生效，使Jackson能够发现重复字段时抛出指定的异常。

使Jackson进行JSON序列化时禁止父类与子类中存在重复字段的示例代码如下：

ObjectMapper mapper = new ObjectMapper();
mapper.setDefaultPropertyInclusion(JsonInclude.Value.construct(JsonInclude.Include.NON_NULL, JsonInclude.Include.NON_NULL));
mapper.registerModule(new TestSimpleModule());
return mapper.writeValueAsString(value);

6. 禁止父类与子类中存在重复字段的效果

通过以上方式使Jackson禁止父类与子类中存在重复字段，进行JSON序列化时，会出现指定的异常，如下所示：

Exception in thread "main" java.lang.RuntimeException: 出现重复字段
at TestPOJOPropertiesCollector._renameProperties(TestPOJOPropertiesCollector.java:77)
at com.fasterxml.jackson.databind.introspect.POJOPropertiesCollector.collectAll(POJOPropertiesCollector.java:436)
at com.fasterxml.jackson.databind.introspect.POJOPropertiesCollector.getJsonValueAccessor(POJOPropertiesCollector.java:270)
at com.fasterxml.jackson.databind.introspect.BasicBeanDescription.findJsonValueAccessor(BasicBeanDescription.java:258)
at com.fasterxml.jackson.databind.ser.BasicSerializerFactory.findSerializerByAnnotations(BasicSerializerFactory.java:391)
at com.fasterxml.jackson.databind.ser.BeanSerializerFactory._createSerializer2(BeanSerializerFactory.java:225)
at com.fasterxml.jackson.databind.ser.BeanSerializerFactory.createSerializer(BeanSerializerFactory.java:174)
at com.fasterxml.jackson.databind.SerializerProvider._createUntypedSerializer(SerializerProvider.java:1501)
at com.fasterxml.jackson.databind.SerializerProvider._createAndCacheUntypedSerializer(SerializerProvider.java:1449)
at com.fasterxml.jackson.databind.SerializerProvider.findValueSerializer(SerializerProvider.java:550)
at com.fasterxml.jackson.databind.SerializerProvider.findTypedValueSerializer(SerializerProvider.java:828)
at com.fasterxml.jackson.databind.ser.DefaultSerializerProvider.serializeValue(DefaultSerializerProvider.java:308)
at com.fasterxml.jackson.databind.ObjectMapper._writeValueAndClose(ObjectMapper.java:4624)
at com.fasterxml.jackson.databind.ObjectMapper.writeValueAsString(ObjectMapper.java:3869)
at TestJSONUtil.toDenseJsonStrForbidDuplicateFields(TestJSONUtil.java:33)
at SameFieldsInDiffClassChild.main(SameFieldsInDiffClassChild.java:30)

最后

以上就是英勇眼睛为你收集整理的Jackson @JsonProperty重复字段处理1. 说明2. 同一个类中存在重复字段3. 父类与子类中存在重复字段4. 允许父类与子类中存在重复字段存在的问题5. 禁止父类与子类中存在重复字段6. 禁止父类与子类中存在重复字段的效果的全部内容，希望文章能够帮你解决Jackson @JsonProperty重复字段处理1. 说明2. 同一个类中存在重复字段3. 父类与子类中存在重复字段4. 允许父类与子类中存在重复字段存在的问题5. 禁止父类与子类中存在重复字段6. 禁止父类与子类中存在重复字段的效果所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。