jackson - 为什么@JsonUnwrapped 不适用于列表？

Question

我正在使用 jackson 2.1.0。鉴于:

public static final class GetCompanies
{
    private final List<URI> companies;

    /**
     * Creates a new GetCompanies.
     * <p/>
     * @param companies the list of available companies
     * @throws NullPointerException if companies is null
     */
    @JsonCreator
    public GetCompanies(@JsonUnwrapped @NotNull List<URI> companies)
    {
        Preconditions.checkNotNull(companies, "companies");

        this.companies = ImmutableList.copyOf(companies);
    }

    /**
     * @return the list of available companies
     */
    @JsonUnwrapped
    @SuppressWarnings("ReturnOfCollectionOrArrayField")
    public List<URI> getCompanies()
    {
        return companies;
    }
}

当输入列表包含 http://test.com/ ， jackson 生成:

{"companies":["http://test.com/"]}

代替:

["http://test.com/"]

有任何想法吗？

更新 : 见 https://github.com/FasterXML/jackson-core/issues/41进行相关讨论。

Answer 1

在这种情况下，如果这行得通，您最终会尝试生成以下内容:

{ "http://test.com" }

这不是合法的 JSON。 @JsonUnwrapped真的只是去除了一层包装。尽管理论上可以使其适用于“数组中的数组”的情况，但事实并非如此。
事实上，我想知道添加此功能是否是一个错误:主要是因为它鼓励使用通常违反数据绑定(bind)最佳实践(简单性，一对一映射)的使用。

但是可行的是 @JsonValue :

@JsonValue
private final List<URI> companies;

这意味着“使用此属性的值而不是序列化包含它的对象”。

并且创建者方法实际上可以按原样工作，不需要 @JsonUnwrapped或 @JsonProperty .

这是更正后的代码:

public static final class GetCompanies
{
    private final List<URI> companies;

    /**
     * Creates a new GetCompanies.
     * <p/>
     * @param companies the list of available companies
     * @throws NullPointerException if companies is null
     */
    @JsonCreator
    public GetCompanies(@NotNull List<URI> companies)
    {
        Preconditions.checkNotNull(companies, "companies");

        this.companies = ImmutableList.copyOf(companies);
    }

    /**
     * @return the list of available companies
     */
    @JsonValue
    @SuppressWarnings("ReturnOfCollectionOrArrayField")
    public List<URI> getCompanies()
    {
        return companies;
    }
}