[英]How to generate client code using springdoc-openapi-maven-plugin and swagger-codegen-maven-plugin?
[英]How can I generate a maven repository-ready library with swagger-codegen-maven-plugin?
我正在使用Maven插件swagger-codegen-maven-plugin
来生成Java客户端jar。 我将swagger.json
放在src/main/resources
文件夹中并运行mvn clean install
。 这是我的pom.xml。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>my-java-client</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>my-java-client</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<swagger.version>1.5.13</swagger.version>
</properties>
<dependencies>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>com.squareup.okhttp</groupId>
<artifactId>okhttp</artifactId>
<version>2.7.5</version>
</dependency>
<dependency>
<groupId>com.squareup.okhttp</groupId>
<artifactId>logging-interceptor</artifactId>
<version>2.7.5</version>
</dependency>
<dependency>
<groupId>io.swagger</groupId>
<artifactId>swagger-codegen</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>com.squareup.okio</groupId>
<artifactId>okio</artifactId>
<version>1.12.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>io.swagger</groupId>
<artifactId>swagger-codegen-maven-plugin</artifactId>
<version>2.2.2</version>
<executions>
<execution>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>src/main/resources/swagger.json</inputSpec>
<modelPackage>mypackage.model</modelPackage>
<apiPackage>mypackage</apiPackage>
<invokerPackage>mypackage.invoker</invokerPackage>
<language>java</language>
<configOptions>
<interfaceOnly>true</interfaceOnly>
<dateLibrary>java8</dateLibrary>
<java8>true</java8>
</configOptions>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
当我运行mvn clean install
,会在目标文件夹中创建一个jar文件my-java-client-1.0-SNAPSHOT.jar
。 它包含源代码,但没有pom.xml文件。 target/generated-sources/swagger
文件夹中有一个pom.xml
文件,但它有groupId
和artifactId
:
<groupId>io.swagger</groupId>
<artifactId>swagger-java-client</artifactId>
target/generated-sources/swagger
的README.md文件说在pom.xml
包含以下内容以使用生成的jar:
<dependency>
<groupId>io.swagger</groupId>
<artifactId>swagger-java-client</artifactId>
<version>1.0.0</version>
<scope>compile</scope>
</dependency>
我猜这些只是默认值,因为如果我生成多个swagger客户端,它们会与名称冲突,我可以在swagger-codegen源代码中看到这些字段是从{{artifactId}}
等占位符生成的。 我无法找到可以设置这些占位符的位置。
我怎样才能让jar包含一个带有我选择的artifactId
和groupId
的pom.xml
,所以我可以将它上传到像Artifactory这样的Maven存储库,并在我的Maven依赖项中使用它?
它没有特别好的文档记录,但看起来你可以从configOptions中覆盖artifactId,groupId等:
<configOptions>
<groupId>com.your.group.id</groupId>
<artifactId>your-artifact-id</artifactId>
<artifactVersion>0.0.1-SNAPSHOT</artifactVersion>
</configOptions>
CodegenConstants.java中的许多属性都可以以相同的方式设置。
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.