Notes:

• You can download swagger-ui-dist from: https://www.npmjs.com/package/swagger-ui-dist
  $ wget $(npm view swagger-ui-dist dist.tarball)
  
• Extract the content of the file: swagger-ui-dist-3.24.0.tgz
  
  
• Copy the content of the directory "package" in the folder: "mtitek-swagger-sample/src/main/webapp"
  $ cp package/* ${WORKSPACE_PATH}/mtitek-swagger-sample/src/main/webapp/
  
• Open the file "src/main/webapp/index.html"
  Change: url: "https://petstore.swagger.io/v2/swagger.json",
  With: url: "http://localhost:8080/mtitek-swagger-sample-1.0.0-SNAPSHOT/swagger.json",
  

<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>org.glassfish.jersey.inject</groupId> <artifactId>jersey-hk2</artifactId> <version>2.29.1</version> </dependency> <dependency> <groupId>org.glassfish.jersey.containers</groupId> <artifactId>jersey-container-servlet-core</artifactId> <version>2.29.1</version> </dependency> <dependency> <groupId>org.glassfish.jersey.media</groupId> <artifactId>jersey-media-moxy</artifactId> <version>2.29.1</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>5.2.0.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.2.0.RELEASE</version> </dependency> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-annotations</artifactId> <version>1.5.24</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpcore</artifactId> <version>4.4.12</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-dependency-plugin</artifactId> <version>3.1.1</version> <executions> <execution> <id>dependency-analyze</id> <goals> <goal>analyze</goal> </goals> <phase>package</phase> </execution> </executions> </plugin> <plugin> <groupId>com.github.kongchen</groupId> <artifactId>swagger-maven-plugin</artifactId> <version>3.1.7</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> &lt;table&gt; &lt;tr&gt; &lt;td&gt;Swagger API: MyEntity&lt;/td&gt; &lt;/tr&gt; &lt;/table&gt;</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>^((?!/swagger/).)*$</param-value> </init-param> </filter> <filter-mapping> <filter-name>MyServletContainer</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

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 = "Swagger API: MyEntity") @Consumes({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML }) @Produces({ MediaType.APPLICATION_JSON, 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; import io.swagger.annotations.ApiModel; import io.swagger.annotations.ApiModelProperty; @XmlRootElement(name = "myEntity") @XmlAccessorType(XmlAccessType.NONE) @ApiModel(value = "myEntity", description = "MyEntity resource representation") public class MyEntity { @XmlAttribute(name = "id") @ApiModelProperty(value = "MyEntity's id") private String id; @XmlElement(name = "code") @ApiModelProperty(value = "MyEntity's 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/"

In your browser type the following URL: http://localhost:8080/mtitek-swagger-sample-1.0.0-SNAPSHOT