apideploy-java-client is a java system API document automatic generation toolkit and apideploy.com website deployment SDK. It supports Swagger2(OAS 2.0), Swagger3 (OAS 3.0), Javadoc specifications, and Java development frameworks such as Spring WebMVC, Spring WebFlux and Apache Dubbo's documentation comments.
Note: This client is suitable for systems using Java 1.8 or below. The swagger part is implemented based on springfox.If your system is based on Spring Boot 3.0 or above, please use apideploy-jakarta-client.
1.Add maven dependency to pom.xml.
You have to choose the appropriate dependencies according to the framework of your system. The following is the correspondence between maven dependencies and frameworks.
| / | Spring WebMVC | Spring WebFlux | Apache Dubbo |
|---|---|---|---|
| Swagger2(OAS 2.0) | <dependency> <groupId>com.kalman03</groupId> <artifactId>apideploy-swagger2-webmvc</artifactId> </dependency> | ||
| Swagger3(OAS 3.0) | <dependency> <groupId>com.kalman03</groupId> <artifactId>apideploy-swagger3-webmvc</artifactId> </dependency> | <dependency> <groupId>com.kalman03</groupId> <artifactId>apideploy-swagger3-webflux</artifactId> </dependency> | |
| Javadoc | <dependency> <groupId>com.kalman03</groupId> <artifactId>apideploy-javadoc-springweb</artifactId> </dependency> | <dependency> <groupId>com.kalman03</groupId> <artifactId>apideploy-javadoc-springweb</artifactId> </dependency> |
2.Config the application.properties or application.yaml.
apideploy.config.enabled=true
apideploy.config.endpoint=https://www.apideploy.cn/openapi/sync
apideploy.config.appId=${appId}
apideploy.config.appSecret=${appSecret}
apideploy.config.autoPublish=trueThe ${appId} and ${appSecret} in the configuration file can be applied for free through the apideploy.com website. For detailed application methods, please refer to: www.
For more parameter configuration, please refer to: www
3.Run it and see the final result.
The above three steps have completed all the configuration of apideploy. The next step is to write your Javadoc (strongly recommended) or complete the API definition based on Swagger. When everything is ready, run the system locally and the API will be automatically generated and synchronized to the apideploy.com website. Then you can happily check, debug and do version management on apideploy.com .
For more samples, please refer to apideploy-java-demos.
apideploy-java-client is released under the Apache 2.0 license.