使用招摇注释显示自定义HashMap键

Question

我正试图从Java代码生成Swagger文档，我的嵌套模型属性之一是HashMap。生成的示例如下所示：

      "additionalProp1": {
        "customObject": {}
      },
      "additionalProp2": {
        "customObject": {}
      },
      "additionalProp3": {
        "customObject": {}
      }

我需要它看起来像是：

      "objectName": {
        "customObject": {}
      }

换句话说，我需要告诉他们additionalProp字符串应该是什么，最好不要重复三次。有没有办法用夸张的注释来做到这一点？我不想硬编码一个完整的例子，因为CustomObject本身有很多属性，而且仍然在不断变化。有没有可能按照

@ApiModelProperty（example=“objectName:{package.CustomObject}”）

（除了真正有效的东西）？

我尝试过以这种和其他方式使用@ApiModelProperty，但到目前为止没有成功。

@ApiModelProperty
public HashMap<String, CustomObject> getObjectMap(){
    return objectMap;
}

我用的是1.5.18大摇大摆的罐子。到目前为止，我只能找到使用直接yaml或json操作解决的类似问题。

Answer 1

我确实有一个hacky解决方案，其中我制作了一个虚拟类，如下所示：

public class SwaggerObject {
    public CustomObject getObjectName() {
        return null;
    }
}

并在主代码中添加：

@ApiModelProperty(dataType="package.SwaggerObject")
public HashMap<String, CustomObject> getObjectMap(){
    return objectMap;
}

从而产生

"objectName": {
  "customObject": {}
}

然而，需要一个全新的类似乎很傻。它还将虚拟类添加到底部的模型中，这可能会令人困惑。