Error 404 for swagger.json/swagger.yaml - Non Maven - jersey

Question

I am trying set up swagger in a non-maven java jetty-web application.
I have taken all the dependency jar files from the git repositories and included them in my web app WEB-INF/lib directory.
Yet I am unable to access localhost:7443/api/swagger.json
Fyi, In my webapp I use jersey 1.x and jax-rs.
I have followed multiple ways to set up as given in the documentation.
Approach-1:
The web-xml way:
I have added the swagger initialization and references in the web xml like this:
<servlet>
<servlet-name>jersey</servlet-name>
<servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
<init-param>
<param-name>com.sun.jersey.config.property.packages</param-name>
<param-value>
io.swagger.jaxrs.json,
io.swagger.jaxrs.listing,
com.myproject.rest
</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>jersey</servlet-name>
<url-pattern>/api/*</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>Jersey2Config</servlet-name>
<servlet-class>io.swagger.jaxrs.config.DefaultJaxrsConfig</servlet-class>
<init-param>
<param-name>api.version</param-name>
<param-value>1.0.0</param-value>
</init-param>
<init-param>
<param-name>swagger.api.basepath</param-name>
<param-value>https://localhost:7443/api</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
....some more servlets and filters defined after this
The build and run were successful and my web-app comes up like as usual. I see these log lines during the runtime:
15:53:36,837 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Could NOT find resource [logback.groovy]
15:53:36,837 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Found resource [logback-test.xml] at [jar:file:/Users/vinayabhishek/Documents/TCPWave/workspace/tims/WebContent/WEB-INF/lib/swagger-core-1.5.11-SNAPSHOT-tests.jar!/logback-test.xml]
15:53:36,848 |-INFO in ch.qos.logback.core.joran.spi.ConfigurationWatchList#32c26e28 - URL [jar:file:/Users/vinayabhishek/Documents/TCPWave/workspace/tims/WebContent/WEB-INF/lib/swagger-core-1.5.11-SNAPSHOT-tests.jar!/logback-test.xml] is not of type file
15:53:36,866 |-INFO in ch.qos.logback.classic.joran.action.ConfigurationAction - debug attribute not set
15:53:37,172 |-INFO in ch.qos.logback.core.joran.action.AppenderAction - About to instantiate appender of type [ch.qos.logback.core.ConsoleAppender]
15:53:37,175 |-INFO in ch.qos.logback.core.joran.action.AppenderAction - Naming appender as [STDOUT]
15:53:37,225 |-WARN in ch.qos.logback.core.ConsoleAppender[STDOUT] - This appender no longer admits a layout as a sub-component, set an encoder instead.
15:53:37,225 |-WARN in ch.qos.logback.core.ConsoleAppender[STDOUT] - To ensure compatibility, wrapping your layout in LayoutWrappingEncoder.
15:53:37,225 |-WARN in ch.qos.logback.core.ConsoleAppender[STDOUT] - See also http://logback.qos.ch/codes.html#layoutInsteadOfEncoder for details
15:53:37,225 |-INFO in ch.qos.logback.classic.joran.action.LoggerAction - Setting level of logger [io.swagger] to ERROR
15:53:37,225 |-INFO in ch.qos.logback.classic.joran.action.RootLoggerAction - Setting level of ROOT logger to ERROR
15:53:37,225 |-INFO in ch.qos.logback.core.joran.action.AppenderRefAction - Attaching appender named [STDOUT] to Logger[ROOT]
15:53:37,226 |-INFO in ch.qos.logback.classic.joran.action.ConfigurationAction - End of configuration.
15:53:37,227 |-INFO in ch.qos.logback.classic.joran.JoranConfigurator#5e9771a5 - Registering current configuration as safe fallback point
However https://localhost:7443/api/swagger.json gives me 404 response.
Approach 2: The Custom Application class
I have defined a custom SampleApplication.java class that looks like this
public class SampleApplication extends Application {
public SampleApplication() {
BeanConfig beanConfig = new BeanConfig();
beanConfig.setVersion("1.0.2");
beanConfig.setSchemes(new String[]{"http"});
beanConfig.setHost("localhost:8002");
beanConfig.setBasePath("/api");
beanConfig.setResourcePackage("io.swagger.resources");
beanConfig.setScan(true);
System.out.println("Did we set it?");
}
#Override
public Set<Class<?>> getClasses() {
Set<Class<?>> resources = new HashSet<Class<?>>();
resources.add(PersonsService.class);
//resources.add(SecondResource.class);
//...
resources.add(io.swagger.jaxrs.listing.ApiListingResource.class);
resources.add(io.swagger.jaxrs.listing.SwaggerSerializers.class);
return resources;
}
}
This also did not work. I do not see any errors in the stack trace except for the logback stuff listed above.
I have also added annotations to one of my WebService class like this:
#Path("/people")
#Api( value = "/people", description = "Manage people" )
public class PeopleService {
#Path("/list/{city_id}")
#GET
#Consumes({ MediaType.TEXT_PLAIN })
#Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
#ApiOperation(
value = "List all people",
notes = "List all people using paging",
response = People.class,
responseContainer = "List"
)
public ArrayList<People> list(....){
}
}
I really appreciate any help on this. Thank you in advance :)

Answer 1

I've just had the same problem and solved it by ensuring that I was referencing the correct swagger dependency.
Originally I included swagger-core but for my Jersey 2.0 project I needed to use swagger-jersey2-jaxrs. My advice is to double check your libraries.