如何通過OpenAPI生成Java API jar包并上傳到私有倉(cāng)庫(kù)

本篇內(nèi)容主要講解“如何通過OpenAPI生成Java API jar包并上傳到私有倉(cāng)庫(kù)”，感興趣的朋友不妨來(lái)看看。本文介紹的方法操作簡(jiǎn)單快捷，實(shí)用性強(qiáng)。下面就讓小編來(lái)帶大家學(xué)習(xí)“如何通過OpenAPI生成Java API jar包并上傳到私有倉(cāng)庫(kù)”吧!

目的

通過OpenAPI格式定義的接口信息，生成SpringBoot Reactive接口Jar包，并上傳到私有倉(cāng)庫(kù)

環(huán)境交待

開發(fā)工作IDEA 構(gòu)建工具Gradle 接口定義OpenAPI 3.0.0 Java版本 JDK11 SpringBoot版本 2.1.7.RELEASE

實(shí)施

根據(jù)OpenAPI接口生成SpringBoot Reactive接口Java類

這里使用Gradle中的第三方插件來(lái)將OpenAPI接口生成Java接口

plugins {
    // Gradle第三方插件，可通過swagger接口文檔生成代碼
    id "org.hidetake.swagger.generator" version "2.18.1"
}

同時(shí)引入依賴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'
            // 指定生成代碼時(shí)的個(gè)性化配置文件
            configFile = file("$projectDir/src/main/resources/swagger/config.json")
        }
    }
}

在config.json文件中指定了代碼生成的包名，所使用的庫(kù)，是否支持Reactive，各種路徑，及指定Java類型的轉(zhuǎn)換等

{
  "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，同時(shí)引入java插件

plugins {
    id 'java'
    // Gradle官方插件，用來(lái)發(fā)布jar包
    id "maven-publish"
}

同時(shí)引入SpringBoot，Springfox-Swagger包等

dependencies {
    // 引入spring-boot-starter-webflux:2.1.x版本，以支持reactive，打包時(shí)需要
    implementation('org.springframework.boot:spring-boot-starter-webflux:2.1.7.RELEASE')
    // 引入springfox-swagger2，以支持swagger生成的接口，打包時(shí)需要
    implementation("io.springfox:springfox-swagger2:2.9.2")
}

配置發(fā)布jar包到指定私有倉(cāng)庫(kù)

// 發(fā)布jar包
publishing {
    publications {
        maven(MavenPublication) {
            //指定group/artifact/version信息，可以不填。默認(rèn)使用項(xiàng)目group/name/version作為groupId/artifactId/version
            //artifactId = rootProject.name
            //如果是war包填寫components.web，如果是jar包填寫components.java
            from components.java
        }
    }
    // 不配置repositories,會(huì)發(fā)布到本地maven倉(cāng)庫(kù)
    repositories {
        maven {
            //指定要上傳的maven私服倉(cāng)庫(kù)
            url = "http://localhost:8081/repository/maven-releases/"
            //認(rèn)證用戶和密碼
            credentials {
                username 'admin'
                password 'buddie'
            }
        }
    }
}

到此，相信大家對(duì)“如何通過OpenAPI生成Java API jar包并上傳到私有倉(cāng)庫(kù)”有了更深的了解，不妨來(lái)實(shí)際操作一番吧！這里是億速云網(wǎng)站，更多相關(guān)內(nèi)容可以進(jìn)入相關(guān)頻道進(jìn)行查詢，關(guān)注我們，繼續(xù)學(xué)習(xí)！