Re: Intermittent missing property from Swagger spec definition

2017-05-31 Thread tony tam
Setting the debug level will show you pretty much everything that happens during the scanning process. I’d start there, and feel free to post your findings back here for help. > On May 31, 2017, at 4:45 PM, Ed Wang wrote: > > That was my first suspicion as well. I'm not

Re: Intermittent missing property from Swagger spec definition

2017-05-31 Thread tony tam
Usually this happens when you have multiple models with the same name, but different definitions. The “randomness” has to do with which one is loaded first. > On May 31, 2017, at 3:46 PM, Ron Ratovsky wrote: > > If you’re using Spring as your REST framework, then you

Re: Intermittent missing property from Swagger spec definition

2017-05-31 Thread Ron Ratovsky
If you’re using Spring as your REST framework, then you probably use Springfox. Swagger-jaxrs is used with old jax-rs libraries such as Jersey 1.x. Can you check again please? From: on behalf of Ed Wang Reply-To:

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread Ron Ratovsky
Fair point, done. Thanks for your feedback. From: on behalf of David Rickard Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, 31 May 2017 at 13:53 To:

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread David Rickard
Added annotations to the service classes and hey presto!--we have useful output from Swagger. Maybe a note should be added to the end of the setup guide advising users to read the annotations guide? Just a thought... On Wed, May 31, 2017 at 1:16 PM, Ron Ratovsky wrote: > Yeah,

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread Ron Ratovsky
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

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread David Rickard
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 wrote: > Gotcha. Are your resources annotated with @Api? > > > > > > > > *From: * on behalf of

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread Ron Ratovsky
Gotcha. Are your resources annotated with @Api? From: on behalf of David Rickard Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Wednesday, 31 May 2017 at 11:59 To:

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread David Rickard
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();

Re: Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread Ron Ratovsky
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

Re: Intermittent missing property from Swagger spec definition

2017-05-31 Thread Ed Wang
We're using Spring as our REST framework and I believe we're using swagger-jaxrs-1.5.5 On Tuesday, May 30, 2017 at 8:39:27 PM UTC-7, Ron wrote: > > Interesting. Can you give us some more information as to which REST > framework you use, which swagger project, and which versions? > > > > > >

Swagger Core Scanning Web App But Not Generating Documentation

2017-05-31 Thread David Rickard
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