Swagger with embedded Jetty

Question

Может кто-нибудь, пожалуйста, сообщите мне, если это правильный способ настройки Swagger со встроенным причалом.

public class TestMain { 

public static void main(String[] args) throws Exception { 
    Server gs = new Server(); 
    ServletContextHandler sch = gs.getServletContextHandler(); 

    sch.addFilter(new FilterHolder(new RequestTrackerFilter()), "/*",  EnumSet.of(DispatcherType.REQUEST)); 
    sch.addFilter(new FilterHolder(new ActionIdFilter()), "/*", EnumSet.of(DispatcherType.REQUEST)); 

    ResourceHandler resource_handler = new ResourceHandler(); 
    resource_handler.setDirectoriesListed(false); 

    resource_handler.setResourceBase("public/2.0"); 

    ContextHandler context = new ContextHandler("/apitest"); 

    context.setHandler(resource_handler); 

    ContextHandlerCollection contexts = new ContextHandlerCollection(); 


    setupSwaggerContextHandler(); 

    //  context.getServletContext().addListener(new SwaggerInitializer()); 

    contexts.setHandlers(new Handler[]{sch, context}); 

    gs.getServer().setHandler(contexts); 

    gs.start(); 
} 

private static ServletContextHandler setupSwaggerContextHandler() { 
    // Configure Swagger-core 
    final ServletHolder swaggerServletHolder = new ServletHolder(new JerseyJaxrsConfig()); 
    swaggerServletHolder.setName("JerseyJaxrsConfig"); 
    swaggerServletHolder.setInitParameter("api.version", "1.0.0"); 
    swaggerServletHolder.setInitParameter("swagger.api.basepath", "http://localhost:9000/apitest"); 
    swaggerServletHolder.setInitOrder(2); 

    final ServletContextHandler swaggerContextHandler = new ServletContextHandler(); 
    swaggerContextHandler.setSessionHandler(new SessionHandler()); 
    // Bind Swagger-core to the url HOST/api-docs 
    swaggerContextHandler.setContextPath("/api-docs"); 
    swaggerContextHandler.addServlet(swaggerServletHolder, "/*"); 

    return swaggerContextHandler; 
    } 
} 

Я не в состоянии видеть любой выход с помощью

http://localhost:9000/apitest/api-docs 

Am после обсуждения на https://groups.google.com/forum/#!topic/swagger-swaggersocket/KHYESESD6c4

Answer 1

Если вы используете чванство жильный 1.5.x, вы должны смотреть в контекстном пути для /swagger.json. Таким образом, для установки:

http://localhost:9000/apitest/api-docs/swagger.json

Answer 2

Я играл много, чтобы получить Кураж работать со встроенным Jetty, без web.xml или весной, и, наконец, в конечном итоге с этим решением: https://github.com/SriramKeerthi/swagger-jersey2-jetty

у меня будет добавила его в качестве комментария, если бы у меня была достаточно репутации. Но это самый простой вариант кода, который я мог бы придумать. Вам нужно две части:

1. Кураж Bean Config:

   BeanConfig beanConfig = new BeanConfig(); 
   beanConfig.setVersion("1.0.0"); 
   beanConfig.setResourcePackage(YourJerseyResourceClass.class.getPackage().getName()); 
   beanConfig.setScan(true); 
   beanConfig.setBasePath("/"); 
   beanConfig.setDescription("Sample API to demonstrate Swagger with Jersey2" + 
        " in an embedded Jetty instance, with no web.xml or Spring MVC."); 
   beanConfig.setTitle("Sample API"); 
   

2. Добавить:

   ResourceConfig resourceConfig = new ResourceConfig(); 
   // Add your resources and Swagger resources (ApiListingResource package) 
   resourceConfig.packages(YourJerseyResourceClass.class.getPackage().getName(), ApiListingResource.class.getPackage().getName()); 
   ServletContainer servletContainer = new ServletContainer(resourceConfig); 
   ServletHolder servletHolder = new ServletHolder(servletContainer); 
   ServletContextHandler servletContextHandler = new ServletContextHandler(ServletContextHandler.SESSIONS); 
   servletContextHandler.setContextPath("/"); 
   servletContextHandler.addServlet(servletHolder, "/*"); 
   

Теперь вы должны быть в состоянии увидеть Swagger spec в /swagger.json конечной точке ,

P.S. Команда в #swagger на irc.freenode.net блестящая, вы должны посетить их, если ничего не исправлено.