这对Jackson数据绑定2.7.0还是适用的。
jackson@JsonCreator注释2.5 javadoc或jackson注释文档语法( 构造函数和工厂方法 )让我们确信可以标记多个构造函数。
标记注释,可用于定义构造函数和工厂方法,以用于实例化关联类的新实例。
查看创build者标识的代码,它看起来像Jackson CreatorCollector忽略了重载构造函数,因为它只检查 构造函数 的第一个参数 。
Class> oldType = oldOne.getRawParameterType(0); Class> newType = newOne.getRawParameterType(0); if (oldType == newType) { throw new IllegalArgumentException("Conflicting "+TYPE_DESCS[typeIndex] +" creators: already had explicitly marked "+oldOne+", encountered "+newOne); }
oldOne是第一个确定的构造函数创build者。
newOne是重载的构造函数创build器。
这意味着这样的代码将无法工作
@JsonCreator public Phone(@JsonProperty("value") String value) { this.value = value; this.country = ""; } @JsonCreator public Phone(@JsonProperty("country") String country, @JsonProperty("value") String value) { this.value = value; this.country = country; } assertThat(new ObjectMapper().readValue("{\"value\":\"+336\"}", Phone.class).value).isEqualTo("+336"); // raise error here assertThat(new ObjectMapper().readValue("{\"value\":\"+336\"}", Phone.class).value).isEqualTo("+336");
但是这个代码将起作用:
@JsonCreator public Phone(@JsonProperty("value") String value) { this.value = value; enabled = true; } @JsonCreator public Phone(@JsonProperty("enabled") Boolean enabled, @JsonProperty("value") String value) { this.value = value; this.enabled = enabled; } assertThat(new ObjectMapper().readValue("{\"value\":\"+336\"}", Phone.class).value).isEqualTo("+336"); assertThat(new ObjectMapper().readValue("{\"value\":\"+336\",\"enabled\":true}", Phone.class).value).isEqualTo("+336");
这有点冒险,可能不是未来的certificate 。
文档对于如何创build对象是模糊的; 从我从代码中收集到的信息,就是可以混合不同的方法:
例如,可以有@JsonCreator注解的静态工厂方法
@JsonCreator public Phone(@JsonProperty("value") String value) { this.value = value; enabled = true; } @JsonCreator public Phone(@JsonProperty("enabled") Boolean enabled, @JsonProperty("value") String value) { this.value = value; this.enabled = enabled; } @JsonCreator public static Phone toPhone(String value) { return new Phone(value); } assertThat(new ObjectMapper().readValue("\"+336\"", Phone.class).value).isEqualTo("+336"); assertThat(new ObjectMapper().readValue("{\"value\":\"+336\"}", Phone.class).value).isEqualTo("+336"); assertThat(new ObjectMapper().readValue("{\"value\":\"+336\",\"enabled\":true}", Phone.class).value).isEqualTo("+336");
它有效,但不是理想的。 最后它可能是有道理的,例如,如果json是dynamic的,那么也许应该看看使用委托构造函数来处理有效载荷变化比多注释构造函数更优雅。
另外请注意,jackson按照优先顺序sorting创build者 ,例如在这个代码中:
// Simple @JsonCreator public Phone(@JsonProperty("value") String value) { this.value = value; } // more @JsonCreator public Phone(Map properties) { value = (String) properties.get("value"); // more logic } assertThat(new ObjectMapper().readValue("\"+336\"", Phone.class).value).isEqualTo("+336"); assertThat(new ObjectMapper().readValue("{\"value\":\"+336\"}", Phone.class).value).isEqualTo("+336"); assertThat(new ObjectMapper().readValue("{\"value\":\"+336\",\"enabled\":true}", Phone.class).value).isEqualTo("+336");
这一次jackson不会提出错误,但jackson将只使用委托构造函数Phone(Map properties) ,这意味着Phone(@JsonProperty("value") String value)从不使用。