Swagger-ui对List <MonetartyAmount>显示为空

我在springboot项目上使用了swagger。
端点出现问题，该端点返回带有MonetaryAmount列表的实体，即(List<MonetaryAmount> rates)

Swagger-ui显示以下端点的不正确数据:

{
  "rates": [
    null
  ]
}

但是，我希望将每个MonetaryAmount值视为Double和String对。像这样:

{
  "rates": [
   {"currency":"EUR", "rate": 12.23}
  ]
}

我尝试使用directModelSubstitute，但似乎不适用于List。

这是我的模特:

public class CurrencyRatesResponse implements Serializable {

private List<MonetaryAmount> rates;

public CurrencyRatesResponse() {
}

public CurrencyRatesResponse(List<MonetaryAmount> rates) {
    this.rates = rates;
}

public List<MonetaryAmount> getRates() {
    return rates;
}

public void setRates(List<MonetaryAmount> rates) {
    this.rates = rates;
}
}

这是我的终点的一个例子

@RequestMapping(path = "/public/rates", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
public CurrencyRatesResponse getRates() {...}

生成的 Swagger JSON:

 "/public/rates":{
         "get":{
            "tags":[
               "rate-endpoint"
            ],
            "summary":"getRates",
            "operationId":"getRatesUsingGET",
            "produces":[
               "application/json;charset=UTF-8"
            ],
            "parameters":[
               {
                 ....
               }
            ],
            "responses":{
               "200":{
                  "description":"OK",
                  "schema":{
                     "$ref":"#/definitions/CurrencyRatesResponse"
                  }
               },
               "401":{
                  "description":"Unauthorized"
               },
               "403":{
                  "description":"Forbidden"
               },
               "404":{
                  "description":"Not Found"
               }
            }
         }
      }
    }  ....

   "CurrencyRatesResponse":{
         "type":"object",
         "properties":{
            "rates":{
               "type":"array",
               "items":{
                  "$ref":"#/definitions/MonetaryAmount"
               }
            }
         },
         "title":"CurrencyRatesResponse"
      },

最佳答案

有几个步骤可以实现此目的。

首先，我们需要适当的objectMapper，以便MonetaryAmount映射到具有两个字段currency和rate的适当对象。为此，我们需要为springfox的objectMapper添加自定义模块。

import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;
import org.zalando.jackson.datatype.money.MoneyModule;
import springfox.documentation.schema.configuration.ObjectMapperConfigured;

@Component
public class SwaggerJacksonModule implements ApplicationListener<ObjectMapperConfigured> {

    @Override
    public void onApplicationEvent(ObjectMapperConfigured event) {
        event.getObjectMapper().registerModule(new MoneyModule());
    }
}

说明:我们在springfox的ObjectMapperConfigured事件中添加了一个监听器，并且每当触发该事件时，我们只需获取映射器并注册我们的模块。我使用Zalando's Jackson数据类型货币库，这样就不会编写自己的库了。

下一步将是实际的Swagger表示形式。让我们创建自己的表示对象MonetaryWrapper，我们将使用它代替MonetaryAmount。

public class MonetaryWrapper {

    private BigDecimal amount;

    private String currency;

  // getters and setters  (getters are important)
}

为了正确获得单个对象表示形式，只需将.directModelSubstitute(MonetaryAmount.class, MonetaryWrapper.class)添加到Docket对象即可。

但是对于集合来说，并不是那么简单。例如在这种情况下列出。我们需要将特殊的AlternateTypeRule对象添加到Docket对象中，以使列表正确显示。

可以在springfox的documentation中找到有关此主题的更多详细信息

像这样的东西:

TypeResolver resolver = new TypeResolver();
AlternateTypeRule monetaryAmountListRule =
        newRule(resolver.resolve(List.class,  MonetaryAmount.class),
                resolver.resolve(List.class, MonetaryWrapper.class))

最后，我们的Docket bean看起来像这样:

@Bean
public Docket productApi() {
    TypeResolver resolver = new TypeResolver();
    AlternateTypeRule monetaryAmountListRule =
            newRule(resolver.resolve(List.class,  MonetaryAmount.class),
                    resolver.resolve(List.class, MonetaryWrapper.class));


    return new Docket(DocumentationType.SWAGGER_2)
            .alternateTypeRules(monetaryAmountListRule)
            .directModelSubstitute(MonetaryAmount.class, MonetaryWrapper.class)
            .select().apis(RequestHandlerSelectors.basePackage("com.swagger.test"))
            .paths(PathSelectors.regex("/public.*")).build();
}

还有一些演示屏幕截图:

演示执行请求时:



仅针对对象描述的演示:

关于Swagger-ui对List <MonetartyAmount>显示为空，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/50113143/