Yeah, I understand how it can be confusing. That specific page is more about how to configure the app, less about how to use the annotations.
Swagger-core uses the annotations to build up the description, either JAX-RS’s or its own. We need some of those annotations to hint on things. Take a look at https://github.com/swagger-api/swagger-core/wiki/Annotations-1.5.X please. From: <[email protected]> on behalf of David Rickard <[email protected]> Reply-To: "[email protected]" <[email protected]> Date: Wednesday, 31 May 2017 at 13:02 To: "[email protected]" <[email protected]> Subject: Re: Swagger Core Scanning Web App But Not Generating Documentation No. they're not... And FWIW there's no reference to @Api on the Swagger Core tutorial page... On Wed, May 31, 2017 at 12:57 PM, Ron Ratovsky <[email protected]> wrote: Gotcha. Are your resources annotated with @Api? From: <[email protected]> on behalf of David Rickard <[email protected]> Reply-To: "[email protected]" <[email protected]> Date: Wednesday, 31 May 2017 at 11:59 To: "[email protected]" <[email protected]> Subject: Re: Swagger Core Scanning Web App But Not Generating Documentation This is my BootstrapServlet: public class SwaggerBootstrap extends HttpServlet { public SwaggerBootstrap() { super(); } @Override public void init( ServletConfig config ) throws ServletException { super.init( config ); BeanConfig beanConfig = new BeanConfig(); beanConfig.setVersion( "1.0.0" ); beanConfig.setSchemes( new String[] { "https" } ); beanConfig.setHost( "webservices-test.library.ucla.edu" ); beanConfig.setBasePath( "/pss" ); beanConfig.setResourcePackage( "edu.ucla.library.libservices.pubstats.web.service" ); beanConfig.setScan( true ); } } We are pointing to our resource classes. On Wed, May 31, 2017 at 11:54 AM, Ron Ratovsky <[email protected]> wrote: Hi David, Yup, it looks like you skipped a step. You mentioned the Bootstrap servlet. Take a look at https://github.com/swagger-api/swagger-core/wiki/Swagger-Core-Jersey-2.X-Project-Setup-1.5#using-a-servlet: The line: beanConfig.setResourcePackage("io.swagger.resources"); should actually point to your resource packages. The value given there is just an example. That would tell swagger-core which packages to scan for resources and read the annotations. From: <[email protected]> on behalf of David Rickard <[email protected]> Reply-To: "[email protected]" <[email protected]> Date: Wednesday, 31 May 2017 at 10:52 To: Swagger <[email protected]> Subject: Swagger Core Scanning Web App But Not Generating Documentation UCLA Library IT is making a stab at integrating Swagger into our webservices. Our test app has two services, one which consumes JSON via PUT, one which generates JSON via GET. We've Swagger Core into our application, following the instructions setup instructions here. Our code is in GitHub: https://github.com/UCLALibrary/StatsServices According to log4j output, our application is being scanned at startup: 2017-05-31 10:39:19 DEBUG ApiListingResource:47 - using scanner io.swagger.jaxrs.config.BeanConfig@78a92042 2017-05-31 10:39:19 DEBUG Reflections:185 - going to scan these urls: file:/usr/local/pss/webapps/pss/WEB-INF/classes/ 2017-05-31 10:39:19 INFO Reflections:228 - Reflections took 12 ms to scan 1 urls, producing 10 keys and 26 values However, the only output we get from https://our.app.edu/app/swagger.json is: { swagger: "2.0", info: { version: "1.0.0"}, host: "webservices-test.library.ucla.edu", basePath: "/pss", schemes: [ "https"]} That is, the values defined in the SwaggerBootstrap servlet. Is there a configuration step we're missing, or servlet config param we need to add to get the full Swagger output? -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to a topic in the Google Groups "Swagger" group. To unsubscribe from this topic, visit https://groups.google.com/d/topic/swagger-swaggersocket/tPHJTra2Tpw/unsubscribe. To unsubscribe from this group and all its topics, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to a topic in the Google Groups "Swagger" group. To unsubscribe from this topic, visit https://groups.google.com/d/topic/swagger-swaggersocket/tPHJTra2Tpw/unsubscribe. To unsubscribe from this group and all its topics, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
