我们已经开始使用 REST api 开发一个网络应用程序,我找到了 Swagger,我真的很想要它......但是,我正在努力弄清楚如何将它添加到我们的应用程序中。该应用程序是这样声明的(假设的):
package hello.world;
import org.glassfish.jersey.server.ResourceConfig;
public class CloudApplication extends ResourceConfig {
public CloudApplication() {
// Add all resources from hello.world
packages("hello.world", "com.fasterxml.jackson.jaxrs");
}
}
该项目有一个这样的 web.xml:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<display-name>hello.world</display-name>
<servlet>
<servlet-name>hello.world.CloudApplication</servlet-name>
<async-supported>true</async-supported>
</servlet>
<servlet-mapping>
<servlet-name>hello.world.CloudApplication</servlet-name>
<url-pattern>/hw/*</url-pattern>
</servlet-mapping>
</web-app>
我的 pom.xml 文件包含
...
<dependency>
<groupId>com.wordnik</groupId>
<artifactId>swagger-jaxrs_2.9.1</artifactId>
<scope>compile</scope>
<version>1.3.0</version>
</dependency>
...
查看https://github.com/wordnik/swagger-core/tree/master/samples,我发现所有不同的设置,但我不知道该使用哪个。https://github.com/wordnik/swagger-core/tree/master/samples/java-jaxrs似乎是正确的,但是我可以只使用资源配置来保留当前的项目结构吗?/samples/java-jaxrs 似乎需要很多 web.xml 的东西......我可以用代码来代替吗?有样品吗?
我对 Web 应用程序没有太多经验,但我很想让这个 Swagger 工作。
//乔纳斯