/dropwizard-swagger

a Dropwizard bundle that serves Swagger UI static content and loads Swagger endpoints.

Primary LanguageJavaScriptOtherNOASSERTION

dropwizard-swagger

a Dropwizard bundle that serves Swagger UI static content and loads Swagger endpoints. Swagger UI static content is taken from https://github.com/wordnik/swagger-ui

Current version has been tested with Dropwizard 0.7.1 and Swagger 1.3.2

NOTE: the project's group id has been changed io.federecio and therefore all packages have been renamed accordingly

License

http://www.apache.org/licenses/LICENSE-2.0

How to use it

  • Add the Maven dependency (now available in Maven Central!)

      <dependency>
      <groupId>io.federecio</groupId>
      <artifactId>dropwizard-swagger</artifactId>
      <version>0.5.2</version>
  </dependency>

  • In your Application class:

      private final SwaggerDropwizard swaggerDropwizard = new SwaggerDropwizard();

  @Override
  public void initialize(Bootstrap<TestConfiguration> bootstrap) {
      ...
  	swaggerDropwizard.onInitialize(bootstrap);
  }

  @Override
  public void run(TestConfiguration configuration, Environment environment) throws Exception {
      ...
  	swaggerDropwizard.onRun(configuration, environment);
  }

  • As usual, add Swagger annotations to your resource classes and methods

  • Open a browser and hit http://localhost:8080/swagger (replace port 8080 accordingly)

Sample Application

Take a look at this sample application that shows how to integrate DropWizard and Swagger: dropwizard-swagger-sample-app

Running in AWS

Whether this service is running on AWS is determined by checking for the presence of the folder "/var/lib/cloud". If the folder is actually present then the host Swagger should be bound to is set to the result of a GET request to "http://169.254.169.254/latest/meta-data/public-hostname/".

Should the directory /var/lib/cloud not be present the host is set to the result of InetAddress.getLocalHost().getHostName() or localhost.

Manually setting the host name and the port number

Swagger needs to be able to tell the client what hostname and port number to talk to, in the simple case where the user talks directly to the dropwizard process, that's easy, but users often stick a reverse proxy, such as nginx, in front of an application server, so the drop wizard process might listen on localhost:4242 while the client talks to it via nginx on api.example.com:80.

If you need to force swagger to generate urls for a different host and port number, then you need to use the longer version of the onRun method:

	@Override
	public void run(TestConfiguration configuration, Environment environment) throws Exception {
	    ...
		swaggerDropwizard.onRun(configuration, environment, "your_host_here", 4242);
	}

Contributors