Swagger не работает

Question

У меня возникли проблемы с отображением API API Swagger с использованием Restlet. Что Кураж показывает только эти вещи:

И проверка Апи-документы он показывает только это:

Интересно, что случилось с моим кодом:

public class MyApplication extends SwaggerApplication { 
    private static final String ROOT_URI = "/"; 
    public Restlet createInboundRoot() { 
     Router router = new Router(getContext()); 
     router.attach(ROOT_URI, RootServerResource.class); 
     router.attach(ROOT_URI + "ping", PingServerResource.class); 
     router.attach(ROOT_URI + "ping/", PingServerResource.class); 
     // Some code omitted for simplicity 
     return router; 
    } 
} 

Answer 1

Вы могли бы посмотреть на эту статью:

• Что может APISpark принести ваши существующие веб-API (часть 2) - http://restlet.com/blog/2016/01/04/what-can-apispark-bring-to-your-existing-web-apis-part-2/

Оба Swagger1 и 2 поддерживаются расширением чванство Restlet:

• Кураж v1

  public class ContactsApplication extends SwaggerApplication { 
      public Restlet createInboundRoot() { 
       Router router = new Router(); 
       (...) 
       attachSwaggerSpecificationRestlet(router, "/docs"); 
  
       return router; 
      } 
  } 
  

• Кураж v2

  public class ContactsApplication extends Application { 
      public Restlet createInboundRoot() { 
       Router router = new Router(); 
       (...) 
       Swagger2SpecificationRestlet swagger2SpecificationRestlet 
             = new Swagger2SpecificationRestlet(this); 
       swagger2SpecificationRestlet.setBasePath("http://myapp.org/"); 
       swagger2SpecificationRestlet.attach(router, "/docs"); 
       return router; 
      } 
  } 
  

Answer 2

Swagger должен найти ваши операции API. Я не уверен в Restlet, в Джерси вы комментируете свои классы ресурсов REST с помощью @Api и ваши методы с помощью @ApiOperation. Подробнее здесь in the swagger docs.

Answer 3

Решение добавить этот код:

// Configuring Swagger 2 support 
    Swagger2SpecificationRestlet swagger2SpecificationRestlet 
      = new Swagger2SpecificationRestlet(this); 
    swagger2SpecificationRestlet.setBasePath("http://localhost:8080/api-docs"); 
    swagger2SpecificationRestlet.attach(router); 

И направьте Swagger интерфейс для /swagger.json