Swagger-ui shows null for List

Обновить	December 2018
Просмотры	159 раз

Я использую чванство на моем springboot проекта. Проблема появляется конечная точка , которая возвращает объект со списком MONETARYAMOUNT т.е. ( List<MonetaryAmount> rates)

Форс-щ показывает неверные данные для таких конечных точек, как:

{
  "rates": [
    null
  ]
}

Однако я ожидаю увидеть каждое значение MONETARYAMOUNT как пары двойных и String. Smth как это:

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

Я пытался использовать directModelSubstitute, но кажется, что это не работает для списка.

Вот моя модель:

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() {...}

Сформирован чванство 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"
      },

smaiakov

1 ответы

Есть несколько шагов для достижения этой цели.

Прежде всего, нам нужно собственно ObjectMapper так MonetaryAmountполучает отображается на соответствующий объект с двумя полями currencyи rate. Для достижения этой цели нам нужно добавить пользовательский модуль для ObjectMapper в springfox в.

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 в библиотеку Джексона Datatype деньги , так что я не пишу сам.

Следующий шаг должен был бы работать на фактическом представлении 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 в документации

Что-то вроде этого:

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

И , наконец , наша Docketфасоль будет выглядеть примерно так:

@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();
}

И некоторые скриншоты здесь:

Демонстрационный при выполнении запроса:

Демонстрационный только для описания объекта :

Amiko

Связанные вопросы

Последние вопросы

Горячие теги

javascript java c# python android php jquery c++ html ios css sql mysql .net c r asp.net ruby-on-rails objective-c arrays node.js sql-server iphone regex ruby angularjs json swift django linux asp.net-mvc xml wpf angular spring string ajax python-3.x git excel windows xcode multithreading pandas database reactjs bash scala algorithm eclipse html5 vba performance macos postgresql mongodb laravel oracle visual-studio list vb.net wordpress linq entity-framework winforms unit-testing matlab typescript image python-2.7 perl twitter-bootstrap numpy css3 qt swing hibernate c++11 shell apache amazon-web-services haskell maven forms azure facebook powershell rest function excel-vba delphi tsql ruby-on-rails-3 symfony google-chrome firebase api docker dataframe oop