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

Question

我正在使用杰克逊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/ 时，杰克逊生成：

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

而不是：

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

有什么想法吗？

更新：有关相关讨论，请参阅 https://github.com/FasterXML/jackson-core/issues/41。

Answer 1

在这种情况下，如果要这样做，您最终会尝试生成以下内容：

{ "http://test.com" }

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

但相反，有效的是@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;
    }
}