Question

我使用spring-boot + jersey作为宁静的实现。我设置了招摇，我可以在浏览器上打开swagger ui。但是swagger-ui没有任何API显示，它是一个空页面。以下是我为配置swagger设置的代码。我怎样才能让swagger在汗布上扫描我的API定义？

SwaggerConfiguration.java

@Configuration
@EnableSwagger2
public class SwaggerConfiguration  {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.regex("/com.hello.*"))
                .build().pathMapping("/swagger2");
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("App API")
                .description("App API")
                .version("1.0.0-SNAPSHOT")
                .termsOfServiceUrl("")
                .contact("Cooltoo company")
                .license("Public")
                .licenseUrl("http://hello.com/")
                .build();
}

JerseyConfiguration.java

@Configuration
@EnableSwagger2

@EnableAutoConfiguration
@Api(value = "home", description = "Demo API")
@ApplicationPath("/nursego")
public class JerseyConfiguration extends ResourceConfig {

    public JerseyConfiguration() {
        register(BadgeAPI.class);
        register(MultiPartFeature.class);
        register(OrderAPI.class);
        register(NurseAPI.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("/nursego");
        beanConfig.setResourcePackage("com.cooltoo.backend.api");
        beanConfig.setPrettyPrint(true);
        beanConfig.setScan(true);
        register( io.swagger.jaxrs.listing.ApiListingResource.class );
        register( io.swagger.jaxrs.listing.SwaggerSerializers.class );
    }
}

当我打开http://localhost:8080/swagger-ui.html时，我会看到下面的图片，但它们都不是来自我的API。我不知道他们来自哪里

Answer 1

我使用BeanConfig类将Swagger嵌入到我的SpringBoot + Jersey实现中，代码示例如下，

@Component
@ApplicationPath( "/api" )
public class JerseyConfig extends ResourceConfig{

    public JerseyConfig(){
       // method for embedding the Swagger
        configSwagger();
       // registers the REST resource classes
        configEndPoints();
    }

    private void configEndPoints(){
        // here register all the REST resource classes
    }

    private void configSwagger(){
        BeanConfig beanConfig = new BeanConfig();
        beanConfig.setSchemes( new String[]{ "http" } );
        beanConfig.setHost( "localhost:9001" );
        beanConfig.setBasePath( "/api" );
        beanConfig.setDescription( "REST API services for accessing the pcg application"  );
        beanConfig.setTitle( "RESTAPI" );
        beanConfig.setVersion( "1.0.1" );
        // this will tell Swagger config to scan only these packages
        beanConfig.setResourcePackage( "com.aig.rest.web" );
        beanConfig.setScan( true );     

        register( io.swagger.jaxrs.listing.ApiListingResource.class );
        register( io.swagger.jaxrs.listing.SwaggerSerializers.class );

    }

}

Answer 2

如果使用Spring MVC而不是Jersey（或任何其他JAX-RS impl）实现端点，我相信@EnableSwagger2注释有效。

我在今年早些时候创建的博客文章Microservices using Spring Boot, Jersey Swagger and Docker

中详细介绍了如何实现这一目标

基本上，如果您需要通过Swagger记录您的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
...

如何在spring-boot应用程序中为swagger-ui指定我的restful API

2 个答案: