Hi,
assuming your "web services" are JAX-RS services, a setup as in your sample
should work ok; a similar setup is available in sample
https://github.com/swagger-api/swagger-samples/tree/2.0/java/java-jaxrs2-openapiservlet,
please check it out.
Also are you using latest 2.0.0-SNAPSHOT version of swagger-jaxrs2? If not,
please switch to that (available on Sonatype).
*openApi.configuration.resourcePackages *does indeed recurse into
subpackages
Il giorno giovedì 15 marzo 2018 00:55:10 UTC+1, Gunnar Gissel ha scritto:
>
> I am trying to use the Swagger Core JAX-RS 2.0 project to generate
> documentation for my existing webservices. My project is set up so the
> webservices are in one project and the servlets that use the webservices
> are in another project.
>
>
> I added the dependency for swagger-jaxrs2 to both projects and added the
> following to the web.xml in the servlet project:
>
>
> <servlet>
> <!-- use OpenApi servlet to serve spec -->
> <servlet-name>OpenApi</servlet-name>
>
> <servlet-class>io.swagger.jaxrs2.integration.OpenApiServlet</servlet-class>
>
> <init-param>
> <param-name>openApi.configuration.resourcePackages</param-name>
>
> <param-value>myorg.webservices.resources,myorg.webservices.resources.subpackage1,myorg.webservices.resources.subpackage2</param-value>
> </init-param>
> <!-- alternatively specify configuration file location <init-param>
> <param-name>openApi.configuration.location</param-name>
> <param-value>/openapi-configuration.json</param-value> </init-param>
> -->
> <!-- alternatively include a file openapi-configuration.json or
> openapi-configuration.yaml
> in classpath -->
>
> <load-on-startup>2</load-on-startup></servlet>
> <servlet-mapping>
> <servlet-name>OpenApi</servlet-name>
> <url-pattern>/openapi/*</url-pattern>
> </servlet-mapping>
>
>
> I can run the servlet project and it works, but when I go to /openapi all
> I get is:
>
>
> {"openapi":"3.0.0"}
>
>
> I expect to instead see that and a bunch of RESTful webservice
> documentation stubs.
>
>
> I'm clearly missing something obvious - most of the documentation is for
> Jersey; my project does not use Jersey or really any framework. Is there a
> magic annotation, or am I referring to the classes wrong, or ?
>
>
> While we're on the subject, do I need to explicitly refer to subpackages,
> or does it recurse into subpackages?
>
--
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.
