Notes:
- You can download the swagger-ui code source from: http://swagger.io/swagger-ui/
- Unzip the file "Source code (tar.gz)": swagger-ui-2.2.5.tar.gz
- Copy the content of the "dist" in the folder: "mtitek-swagger-sample/src/main/webapp"

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>mtitek.swagger.sample</groupId> <artifactId>mtitek-swagger-sample</artifactId> <packaging>war</packaging> <version>1.0.0-SNAPSHOT</version> <dependencies> <dependency> <groupId>javax.ws.rs</groupId> <artifactId>javax.ws.rs-api</artifactId> <version>2.0.1</version> </dependency> <dependency> <groupId>org.glassfish.jersey.core</groupId> <artifactId>jersey-server</artifactId> <version>2.23.2</version> </dependency> <dependency> <groupId>org.glassfish.jersey.containers</groupId> <artifactId>jersey-container-servlet</artifactId> <version>2.23.2</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>4.3.2.RELEASE</version> </dependency> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-jaxrs</artifactId> <version>1.5.10</version> </dependency> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-annotations</artifactId> <version>1.5.10</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpcore</artifactId> <version>4.4.5</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>com.github.kongchen</groupId> <artifactId>swagger-maven-plugin</artifactId> <version>3.1.4</version> <configuration> <apiSources> <apiSource> <locations>${project.groupId}</locations> <swaggerDirectory>${project.build.directory}/${project.artifactId}-${project.version}</swaggerDirectory> <basePath>/${project.artifactId}-${project.version}</basePath> <info> <title>${project.artifactId}</title> <version>${project.version}</version> <description><table><tr><td>MyEntity Swagger API</td></tr></table></description> </info> </apiSource> </apiSources> </configuration> <executions> <execution> <phase>compile</phase> <goals> <goal>generate</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project>

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1"> <filter> <filter-name>MyServletContainer</filter-name> <filter-class>org.glassfish.jersey.servlet.ServletContainer</filter-class> <init-param> <param-name>javax.ws.rs.Application</param-name> <param-value>mtitek.swagger.sample.MyResourceConfig</param-value> </init-param> <init-param> <param-name>jersey.config.servlet.filter.staticContentRegex</param-name> <param-value>/.*</param-value> </init-param> </filter> <filter-mapping> <filter-name>MyServletContainer</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> </web-app>

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <context:component-scan base-package="mtitek.swagger.sample" /> </beans>

package mtitek.swagger.sample; import javax.ws.rs.ext.Provider; import org.glassfish.jersey.server.ResourceConfig; @Provider public class MyResourceConfig extends ResourceConfig { public MyResourceConfig() { packages(true, "mtitek.swagger.sample"); } }

package mtitek.swagger.sample; import javax.ws.rs.Consumes; import javax.ws.rs.GET; import javax.ws.rs.HttpMethod; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import org.apache.http.HttpStatus; import io.swagger.annotations.Api; import io.swagger.annotations.ApiOperation; import io.swagger.annotations.ApiResponse; import io.swagger.annotations.ApiResponses; @Path("swagger/myEntity") @Api(value = "MyEntity Swagger API") @Produces({ MediaType.APPLICATION_XML }) public class MyEntitySwaggerAPI { @GET @Path("/") @ApiOperation(httpMethod = HttpMethod.GET, value = "getMyEntity") @ApiResponses({ @ApiResponse(code = HttpStatus.SC_OK, message = "Http status 200 OK", response = MyEntity.class) }) public Response getMyEntity() { MyEntity myEntity = new MyEntity(); myEntity.setId("myEntity - id - 1"); myEntity.setCode("myEntity - code - 1"); myEntity.setDesc("myEntity - desc - 1"); return Response.ok(myEntity).build(); } }

package mtitek.swagger.sample; import javax.xml.bind.annotation.XmlAccessType; import javax.xml.bind.annotation.XmlAccessorType; import javax.xml.bind.annotation.XmlAttribute; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; import javax.xml.bind.annotation.XmlTransient; @XmlRootElement(name = "myEntity") @XmlAccessorType(XmlAccessType.NONE) public class MyEntity { @XmlAttribute(name = "id") private String id; @XmlElement(name = "code") private String code; @XmlTransient private String desc; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getCode() { return code; } public void setCode(final String code) { this.code = code; } public String getDesc() { return desc; } public void setDesc(String desc) { this.desc = desc; } }

Apache Maven: mvn clean package

Apache Tomcat: deploy the war file "mtitek-swagger-sample-1.0.0-SNAPSHOT.war" in the folder "${TOMCAT_ROOT}/webapps/"

REST client tool: http://localhost:8080/mtitek-swagger-sample-1.0.0-SNAPSHOT/

Response: