为什么 Swagger 1.X 会忽略 @XmlAttribute 字段？答案

【问题标题】：Why are @XmlAttribute fields ignored by Swagger 1.X?为什么 Swagger 1.X 会忽略 @XmlAttribute 字段？
【发布时间】：2018-06-25 09:19:46
【问题描述】：

我有一个使用 Swagger 1.X、Jackson 和 JAXB 注释的简单模型类，例如：

@XmlRootElement(name = "ClassA")
@ApiModel(value = "ClassA")
@XmlAccessorType(XmlAccessType.NONE)
@JsonInclude(JsonInclude.Include.NON_NULL)
public class ClassA
{
    @ApiModelProperty(value = "The attribute key", example = "a key")
    @XmlAttribute
    private String key;

    @ApiModelProperty(value = "The attribute name", example = "a name")
    @XmlAttribute
    private String name;

    @ApiModelProperty(value = "a value")
    @XmlElement
    private Object value;

    public String getKey()
    {
        return key;
    }

    public void setKey(String key)
    {
        this.key = key;
    }

    public String getName()
    {
        return name;
    }

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

    public Object getValue()
    {
        return value;
    }

    public void setValue(Object value)
    {
        this.value = value;
    }
}

这由 CXF 的Swagger2Feature 处理以生成通过 Swagger-UI 呈现的 swagger.json 文档。 CXF 是 3.2.1 版本，好像用的是 Swagger 1.5.16。

在生成的 swagger.json 文档中，使用@XmlAttribute 注解的字段被忽略（仅包含@XmlElement 注解的值字段）。有没有办法让 Swagger 在生成的规范中包含这些，而不是将它们全部更改为 XML 元素？

【问题讨论】：

标签： java swagger

【解决方案1】：

显然这是 CXF 3.2.1 - Swagger Core 1847 使用的 Swagger 版本 (1.5.16) 中的一个错误。该错误已在Swagger Core 1.5.18 中修复。

【讨论】：