Создание Swagger 2.0 JSON из Restlet

Question

Использование Restlet 2.3.3 Я объявил, что мое приложение-рестарт выведено из SwaggerApplication. Когда я посещаю URI по умолчанию/api-docs, я наблюдаю, что версия метаданных Swagger - 1.2. Впоследствии я не могу загрузить это в Swagger-UI без ошибок.

Как я могу получить Swagger 2.0 JSON от расширения Swagger от Restlet? Документация, похоже, предполагает, что она может выводить версии 2.0 JSON.

Спасибо!

Answer 1

Класс SwaggerApplication поддерживает только Swagger 1.2. Если вы хотите использовать Swagger 2.0, необходимо подключить вручную соответствующий Restlet для создания контента на основе класса Swagger2SpecificationRestlet, как описано ниже:

public Restlet createInboundRoot() { 
    Router router = new Router(getContext()); 

    // Configuring Swagger 2 support 
    Swagger2SpecificationRestlet swagger2SpecificationRestlet 
        = new Swagger2SpecificationRestlet(this); 
    swagger2SpecificationRestlet.setBasePath(
          "http://myapp.com/api/v1"); 
    swagger2SpecificationRestlet.attach(router); 

    return router; 
} 

При такой конфигурации, связанный ресурс, чтобы получить содержание Swagger прилагается на путь /swagger.json. Вы можете заметить, что вы можете указать свой собственный путь с помощью метода Swagger2SpecificationRestlet#attach(Router, String).

Надеется, что это помогает, Тьерри