如何在SwaggerUI中显示父项目的端点

Question

我有两个项目，一个是类似机箱的项目，具有某些依赖项，并且以spring-boot-starter-parent作为父项，一个模块是REST端点，而第二个是以第一个项目为父项的项目，其主要方法运行Spring Boot应用。我正在使用Swagger记录此终结点，但是未显示父项目中的自定义终结点。我只能看到一个端点BasicErrorController /error，它也来自父级Spring Boot项目，我想以相同的方式显示我的端点。

我尝试将ExampleChassis注释为@Controller（与BasicErrorController中的注释相同，但它不能正常工作（下面的代码）。主类具有批注@EnableSwagger2。

父项目pom.xml：

<groupId>com.example</groupId>
<artifactId>chassis</artifactId>
<version>1.1-SNAPSHOT</version>
<packaging>pom</packaging>

<properties>
    <swagger2.version>2.9.2</swagger2.version>
</properties>

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.5.RELEASE</version>
</parent>

<modules>
    <module>rest</module>
</modules>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

其余模块pom.xml：

<parent>
    <artifactId>chassis</artifactId>
    <groupId>com.example</groupId>
    <version>1.1-SNAPSHOT</version>
</parent>

<artifactId>rest</artifactId>
<dependencies>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>${swagger2.version}</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>${swagger2.version}</version>
    </dependency>
</dependencies>

可运行的SpringBoot项目pom.xml：

<artifactId>micro</artifactId>
<version>1.0-SNAPSHOT</version>

<parent>
    <groupId>com.example</groupId>
    <artifactId>chassis</artifactId>
    <version>1.1-SNAPSHOT</version>
</parent>

<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>rest</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
</dependencies>

REST端点：

@RestController
@RequestMapping("/example")
public class ExampleChassis {

    @RequestMapping
    public String getXing() {
        return "example";
    }
}

我期望在SwaggerUI和/example中看到.json端点，但是我只能看到/error端点。

Answer 1

编写您自己的swagger配置并在下面定义一个Bean，无论您将提供的基本包如何，都要根据swagger过滤API。