如何基于Tags生成指定API接口的Maven客户端代码？

完全可以通过Tags筛选生成你需要的3个接口对应的客户端代码，避免全量生成带来的冗余类。主流的OpenAPI Generator Maven插件原生支持这个功能，以下是具体配置和说明：

核心配置示例 #

在你的pom.xml中添加OpenAPI Generator插件，并通过<tags>参数指定需要生成的接口标签：

<build>
    <plugins>
        <plugin>
            <groupId>org.openapitools</groupId>
            <artifactId>openapi-generator-maven-plugin</artifactId>
            <version>6.6.0</version> <!-- 使用最新稳定版本 -->
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <inputSpec>${project.basedir}/src/main/resources/openapi-spec.yaml</inputSpec> <!-- 你的API规范文件路径或URL -->
                        <generatorName>java</generatorName> <!-- 根据需要选择客户端类型，比如spring、jaxrs等 -->
                        <configOptions>
                            <tags>Tag1,Tag2,Tag3</tags> <!-- 替换为你需要的3个接口对应的Tags，用逗号分隔 -->
                            <library>resttemplate</library> <!-- 可选，指定客户端实现库 -->
                            <dateLibrary>java8</dateLibrary>
                        </configOptions>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

关键说明 #

• Tags匹配逻辑：插件会只生成OpenAPI规范中标记了指定<tags>的接口，以及这些接口依赖的请求/响应对象，不会生成其他无关类。
• 标签验证：确保你需要的3个接口在服务商提供的OpenAPI规范文件中，已经被正确添加了对应的Tag（通常在每个paths节点下的tags字段定义）。
• 进阶筛选：如果需要排除某些标签，可搭配<excludeTags>参数使用，但直接指定<tags>更适合你的场景。

执行mvn clean install后，插件就会只生成你需要的那部分客户端代码，有效减少类路径中的冗余内容。

内容的提问来源于stack exchange，提问作者Jigar Shah