java - 如何将 swagger 与 Jersey + spring-boot 结合

原文 标签 java spring-boot jersey swagger swagger-ui

我正在使用 springboot + jersey 进行 web restful 实现。现在我要将 swagger 集成到我们的应用程序中。我做了以下。

@Configuration
@EnableSwagger2
public class JerseyConfiguration extends ResourceConfig {

    public JerseyConfiguration(){
        register(HelloworldAPI.class);
        configureSwagger();
    }

    private void configureSwagger() {
        BeanConfig beanConfig = new BeanConfig();
        beanConfig.setVersion("1.0.2");
        beanConfig.setSchemes(new String[]{"http"});
        beanConfig.setHost("localhost:8080");
        beanConfig.setBasePath("/");
        beanConfig.setResourcePackage("com.cooltoo.api");
        beanConfig.setPrettyPrint(true);
        beanConfig.setScan(true);
    }
}

我添加了以下对 build.gradle 的依赖:
compile('io.springfox:springfox-swagger2:'+springfoxSwaggerVersion)
compile('io.springfox:springfox-petstore:'+springfoxSwaggerVersion)
compile('io.springfox:springfox-swagger-ui:'+springfoxSwaggerVersion)
compile('io.swagger:swagger-jersey2-jaxrs:1.5.8')

我能够启动 web 应用程序,但我徘徊哪个 url 是为了 swagger?我试过 http://localhost:8080 , http://localhost:8080/swagger , 和 http://localhost:8080/swagger-ui.html .但是没有一个可以访问。

最佳答案

我想@EnableSwagger2注释和 springfox如果使用 Spring MVC 而不是 JAX-RS 实现来实现端点,则依赖项将起作用。

几个月前我写了一篇关于这个的博客,Microservices using Spring Boot, Jersey Swagger and Docker

基本上,如果您需要记录 Jersey 实现的端点,则需要:

1)
确保您的 Spring Boot 应用程序通过以下方式扫描位于特定包(即 com.asimio.jerseyexample.config)中的组件:

@SpringBootApplication(
    scanBasePackages = {
        "com.asimio.jerseyexample.config", "com.asimio.jerseyexample.rest"
    }
)

2) Jersey 配置类实现:
package com.asimio.jerseyexample.config;
...
@Component
public class JerseyConfig extends ResourceConfig {

    @Value("${spring.jersey.application-path:/}")
    private String apiPath;

    public JerseyConfig() {
        // Register endpoints, providers, ...
        this.registerEndpoints();
    }

    @PostConstruct
    public void init() {
        // Register components where DI is needed
        this.configureSwagger();
    }

    private void registerEndpoints() {
        this.register(HelloResource.class);
        // Access through /<Jersey's servlet path>/application.wadl
        this.register(WadlResource.class);
    }

    private void configureSwagger() {
        // Available at localhost:port/swagger.json
        this.register(ApiListingResource.class);
        this.register(SwaggerSerializers.class);

        BeanConfig config = new BeanConfig();
        config.setConfigId("springboot-jersey-swagger-docker-example");
        config.setTitle("Spring Boot + Jersey + Swagger + Docker Example");
        config.setVersion("v1");
        config.setContact("Orlando L Otero");
        config.setSchemes(new String[] { "http", "https" });
        config.setBasePath(this.apiPath);
        config.setResourcePackage("com.asimio.jerseyexample.rest.v1");
        config.setPrettyPrint(true);
        config.setScan(true);
    }
}

3)使用JAX-RS(Jersey)和Swagger注解的资源实现:
package com.asimio.jerseyexample.rest.v1;
...
@Component
@Path("/")
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
@Api(value = "Hello resource", produces = "application/json")
public class HelloResource {

    private static final Logger LOGGER = LoggerFactory.getLogger(HelloResource.class);

    @GET
    @Path("v1/hello/{name}")
    @ApiOperation(value = "Gets a hello resource. Version 1 - (version in URL)", response = Hello.class)
    @ApiResponses(value = {
        @ApiResponse(code = 200, message = "Hello resource found"),
        @ApiResponse(code = 404, message = "Hello resource not found")
    })
    public Response getHelloVersionInUrl(@ApiParam @PathParam("name") String name) {
        LOGGER.info("getHelloVersionInUrl() v1");
        return this.getHello(name, "Version 1 - passed in URL");
    }
...
}

4) 确保您的应用程序的 Spring Boot 配置文件区分 Spring MVC(用于执行器端点)和 Jersey(用于资源)端点:

application.yml
...
# Spring MVC dispatcher servlet path. Needs to be different than Jersey's to enable/disable Actuator endpoints access (/info, /health, ...)
server.servlet-path: /
# Jersey dispatcher servlet
spring.jersey.application-path: /api
...

关于java - 如何将 swagger 与 Jersey + spring-boot 结合,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/35966204/

相关文章:

java - 是否可以读取 .txt 文件的文件名并将它们写入二叉树?

java - Thymeleaf 3.0 Spring Boot +安全性集成无法正常工作

java - o.apache.kafka.clients.NetworkClient-引导代理<主机名>:9092已断开连接

java - REST 服务 ClassNotFoundException (com.sun.jersey.spi.container.servlet.ServletContainer)

rest - 为什么 Jersey 的 UriBuilder.build 方法编码 #'s and %' s,而不是/?

java - Rest jersey JSON编码

installation - 无法在Windows 7上安装JDK,“Wrapper.CreateFile失败,错误123”

java - Java矩阵异常

java - BorderLayout.CENTER "disappears"

java - 如何设置Spring应用程序的日志文件名并登录到tomcat/logs文件夹?