如何通過OpenAPI生成Java API jar包并上傳到私有倉庫

本篇內容主要講解“如何通過OpenAPI生成Java API jar包并上傳到私有倉庫”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實用性強。下面就讓小編來帶大家學習“如何通過OpenAPI生成Java API jar包并上傳到私有倉庫”吧!

目的

通過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生成Java API jar包并上傳到私有倉庫”有了更深的了解，不妨來實際操作一番吧！這里是億速云網站，更多相關內容可以進入相關頻道進行查詢，關注我們，繼續學習！