Question

使用openapi maven插件：

<dependency>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>4.2.2</version>
</dependency>

并使用以下pom配置生成spring boot控制器：

     <plugin>
        <groupId>org.openapitools</groupId>
        <artifactId>openapi-generator-maven-plugin</artifactId>
        <version>4.2.2</version>
        <executions>
          <execution>
            <id>spring-server</id>
            <goals>
              <goal>generate</goal>
            </goals>
            <configuration>
              <!-- specify the swagger yaml -->
              <inputSpec>${project.resources[0].directory}/pet-store.yaml</inputSpec>
              <!-- target to generate java client code -->
              <generatorName>spring</generatorName>
              <!-- pass any necessary config options -->
              <configOptions>
                <serializableModel>true</serializableModel>
                <snapshotVersion>true</snapshotVersion>
              </configOptions>

            </configuration>
          </execution>

        </executions>
      </plugin>

将生成如下所示的控制器：

@Controller
@RequestMapping("${openapi.openAPIPetstore.base-path:/v2}")
public class StoreApiController implements StoreApi {

    private final NativeWebRequest request;

    @org.springframework.beans.factory.annotation.Autowired
    public StoreApiController(NativeWebRequest request) {
        this.request = request;
    }

    @Override
    public Optional<NativeWebRequest> getRequest() {
        return Optional.ofNullable(request);
    }

}

这很好，但是如何绑定到此以添加业务逻辑而不更改实际生成的代码？如果扩展控制器以添加业务逻辑，则会遇到各种问题。

您应该如何使用此生成的代码，以扩展它以添加正确的业务逻辑，而又不更改生成的代码，这会很不好。

Answer 1

我在尝试处理OAS 3.0并因此使用提到的openapi-generator-maven-plugin时遇到了您的问题。同时，我得到它来生成您所描述的内容。

我建议通过

处理

将代码和

单独的包

将Spring的@ComponentScan注释配置为不包含生成的类（单独使用basePackages属性或将其与显式excludeFilters属性组合）。

是的，修改生成的类是不好的。我只是将它们作为创建实际控制器的起点。

修改： 通过各种方式配置代码生成后，我发现最好的解决方案是仅创建API（接口）。这样，我就可以实现我的控制器，而不会受到其他实现的干扰。

要实现此目的，我的插件配置现在看起来像这样（使用configOptions/interfaceOnly选项）：

            <plugin>
                <!-- generate REST API from spec -->
                <groupId>org.openapitools</groupId>
                <artifactId>openapi-generator-maven-plugin</artifactId>
                <version>4.2.2</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                        <configuration>
                            <inputSpec>${project.basedir}/src/main/resources/api.yaml</inputSpec>
                            <generatorName>spring</generatorName>
                            <generateModels>true</generateModels>
                            <generateApis>true</generateApis>
                            <generateApiDocumentation>true</generateApiDocumentation>
                            <generateSupportingFiles>true</generateSupportingFiles>
                            <modelPackage>example.openapi.model</modelPackage>
                            <apiPackage>example.openapi.api</apiPackage>
                            <package>example.openapi</package>
                            <output>${generated.sources.restapi.dir}</output>
                            <configOptions>
                                <interfaceOnly>true</interfaceOnly>
                                <dateLibrary>java8-localdatetime</dateLibrary>
                                <java8>true</java8>
                                <useBeanValidation>true</useBeanValidation>
                            </configOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

OpenApi 3.0 SpringBoot控制器的使用

1 个答案: