目的
通过OpenAPI格式定义的接口信息,生成SpringBoot Reactive接口Jar包,并上传到私有仓库
环境交待
开发工作IDEA 构建工具Gradle 接口定义OpenAPI 3.0.0 Java版本 JDK11 SpringBoot版本 2.1.7.RELEASE
实施
根据OpenAPI接口生成SpringBoot Reactive接口Java类
这里使用Gradle中的第三方插件来将OpenAPI接口生成Java接口
plugins { // Gradle第三方插件,可通过swagger接口文档生成代码 id "org.hidetake.swagger.generator" version "2.18.1" }
同时引入依赖openapi-generator-cli
dependencies { // 以下swaggerCodegen,三选一 // swaggerCodegen 'io.swagger:swagger-codegen-cli:2.4.2' // Swagger Codegen V2 // swaggerCodegen 'io.swagger.codegen.v3:swagger-codegen-cli:3.0.5' // or Swagger Codegen V3 swaggerCodegen 'org.openapitools:openapi-generator-cli:3.3.4' // or OpenAPI Generator }
配置OpenAPI yaml文件位置
// 代码生成,api定义yaml配置 swaggerSources { buddie { // 指定api yaml文件 inputFile = file("$projectDir/src/main/resources/swagger/openApi.yaml") } }
指定swagger生成代码的配置文件
// 代码生成,api定义yaml配置 swaggerSources { buddie { // 指定api yaml文件 inputFile = file("$projectDir/src/main/resources/swagger/openApi.yaml") code { // 指定生成代码的类型 language = 'spring' // 指定生成代码时的个性化配置文件 configFile = file("$projectDir/src/main/resources/swagger/config.json") } } }
在config.json文件中指定了代码生成的包名,所使用的库,是否支持Reactive,各种路径,及指定Java类型的转换等
{ "library": "spring-boot", "dateLibrary": "java8", "reactive": true, "hideGenerationTimestamp": true, "modelPackage": "cn.buddie.demo.api.model", "apiPackage": "cn.buddie.demo.api.controller", "invokerPackage": "cn.buddie.demo.api", "java8": true, "configPackage": "cn.buddie.demo.api.configuration", "useBeanValidation": true, "interfaceOnly": true, "typeMappings": { "OffsetDateTime": "Instant" }, "importMappings": { "java.time.OffsetDateTime": "java.time.Instant" } }
将生成的接口代码类,打包、上传
这里使用Gradle官方插件maven-publish,同时引入java插件
plugins { id 'java' // Gradle官方插件,用来发布jar包 id "maven-publish" }
同时引入SpringBoot,Springfox-Swagger包等
dependencies { // 引入spring-boot-starter-webflux:2.1.x版本,以支持reactive,打包时需要 implementation('org.springframework.boot:spring-boot-starter-webflux:2.1.7.RELEASE') // 引入springfox-swagger2,以支持swagger生成的接口,打包时需要 implementation("io.springfox:springfox-swagger2:2.9.2") }
配置发布jar包到指定私有仓库
// 发布jar包 publishing { publications { maven(MavenPublication) { //指定group/artifact/version信息,可以不填。默认使用项目group/name/version作为groupId/artifactId/version //artifactId = rootProject.name //如果是war包填写components.web,如果是jar包填写components.java from components.java } } // 不配置repositories,会发布到本地maven仓库 repositories { maven { //指定要上传的maven私服仓库 url = "http://localhost:8081/repository/maven-releases/" //认证用户和密码 credentials { username 'admin' password 'buddie' } } } }
相关推荐
openapi对外提供的jar包
openapi生成器
标签:agent-openapi-3.0.jar.zip,agent,openapi,3.0,jar.zip包下载,依赖包
openapi-7.0.3.jar
openapi-6.0.5.jar
OpenAPI安全认证库 (Java)开发指南V1.1.4_20211215182354_20220216173329.pdf
一份收录各种U8系统集成OpenAPI、EAI、API接口问题解决方法。对于U8集成开发工程师予以极大帮助。
openapi sdk 封装了http请求调用,签名,加解密等 调用例子 //必填 String apiUrl = "http://localhost:8082/gateway"; //必填 String appKey = ""; //必填 String appSecret = ""; //如果开启加密,则必填 ...
OpenApi签名生成工具使用说明(海康威视Infovision IoT).pdf
官方版本,亲测可用
钉钉java sdk 配置代码使用,对接钉钉sdk,自动发送文本消息、链接消息、卡片消息、跳转审批消息,可以@所有人。超级方便的API接口。
OpenAPI客户端生成./gradlew openApiGenerate 复制规格和客户export version=v11.0; cp ~/Downloads/openApiSpecification_$version.json . ; cp ~/Downloads/generatedClient_$version.jar libs 比较规格泊坞窗运行...
java开发oa系统源码下载 开放平台 SDK for ...将打包生成的jar发布到私服 mvn deploy:deploy-file -DgroupId=com.XXX.XXX -DartifactId=XXX -Dversion=1.0.0 -Dpackaging=jar -Dfile=openapi-sdk-ja
swagger通过OpenAPI Generator自动生成Jmeter脚本。 我们熟知,Jmeter可以自身录制脚本,还可以Fiddler录制生成Jmeter脚本,不管是Jmeter本身的录制还是Fiddler录制,都需要耗费较长的时间。今天我们介绍更简便的...
开发OpenAPI流程及说明 1.UAP与Restlet框架的集成 UAP在Restlet框架之上,选择了官方JAX-RS扩展,并且在扩展的基础上与NC进行了集成。 主要jar包 modules/uapws/pubuapfw_restframeworkLevel-1.jar UAP平台的扩展...
要生成程序包并生成文档(推荐): stack haddock 它将在docs文件夹中为此库生成文档。 要在正常位置生成文档(以启用到外部库的超链接),请删除 build: haddock-arguments: haddock-args: - "--odir=./docs...
它不仅将allOf和oneOf转换为intersection类型和并union类型,还将参考目标的目录结构转换为namespace并生成API客户端。 目录的层次结构将转换为类型定义的层次结构。用法安装yarn add -D @himenon/openapi-...
spring security所需jar包