如何在Spring将 Swagger 与球衣搭配使用？

Question

我尝试在SpringBoot（1.5.8）中使用Swagger（2.6）和Jersey（1.5）

我对公共API的调用工作正常

我试着用Jersey跟踪这个Config Swagger ui，但它仍然没有回来。

这是我的球衣配置

@Configuration
@ApplicationPath("rest")
public class JerseyConfig extends ResourceConfig {

public JerseyConfig()
{
    register(CustomerImpl.class);
    configureSwagger();
}
public void configureSwagger()
{
    this.register(ApiListingResource.class);
    this.register(SwaggerSerializers.class);
    BeanConfig beanConfig = new BeanConfig();
    beanConfig.setTitle("Swagger sample app");
    beanConfig.setVersion("1.0.0");
    beanConfig.setSchemes(new String[]{"http"});
    beanConfig.setHost("localhost:57116");
    beanConfig.setBasePath("/rest");
    beanConfig.setResourcePackage("com.mypackage");
    beanConfig.setScan(true);
}
}

这是我的应用类

@SpringBootApplication
@EnableDiscoveryClient
@EnableSwagger2
public class CustomerApplication {...}

这是我的endpoint

@Component
@Path("customer")
@Api(value = "Customer API")
public class CustomerImpl {
    @Path("list")
    @GET
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(value = "list")
    @ApiResponses(value = {
            @ApiResponse(code = 200, message = "Success", response = List.class),
            @ApiResponse(code = 401, message = "Unauthorized"),
            @ApiResponse(code = 403, message = "Forbidden"),
            @ApiResponse(code = 404, message = "Not Found"),
            @ApiResponse(code = 500, message = "Failure")})
    public String[] getList()
    {
        return new String[]{"IBM", "Microsoft", "Victor"};
    }
}

当我使用Spring Rest控制器尝试类似的配置时，它工作正常，但是对于泽西岛，我看不到我的公共API。它似乎忽略了我的炫耀配置

Answer 1

您是否使用org.springframework.boot：sping-boot-starter-jersey依赖或org.springframework.boot：sping-boot-starter-web在您的pom.xml？

似乎您使用的是由< code>SpringFox生成的Swagger bean，而不是由您的< code>BeanConfig生成的。

为了让Swagger工作，您应该依赖spring boot starter jersey并删除所有SpringFox依赖项，包括@EnableSwagger2annotation。

Jersey应用程序中的< code>swagger.json由< code > io . swagger:swagger-Jersey 2-jaxrs 库生成。至于Swagger UI，可以使用vanilla Swagger UI静态资源。

您可能还需要将 BeanConfig 中的资源包更改为应用程序基本包。目前，您有：

beanConfig.setResourcePackage("io.swagger.resources");

这是一个Spring Boot、Jersey和Swagger的工作示例。在此示例中，资源包设置为应用程序基本包：

beanConfig.setResourcePackage("com.basaki");