天天看點

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

背景

相信很多人都使用過start.spring.io來初始化自己的spring boot工程,這個工具為開發者提供了豐富的可選元件,并且可以選擇多種打包方式,大大友善了開發人員的使用。最近,阿裡的nacos、sentinel也進入start.spring.io的選項中,進一步的友善開發者使用阿裡雲的産品。

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

但是,生成的工程中骨架中,隻有元件坐标資訊,缺少對應的使用方法和demo代碼;于是,開發者還是需要去尋找相關使用教程,或者樣例代碼;如果找的不對,或者是版本不匹比對,還需要花費不少時間去排查和解決問題;這些問題都在無形中增加使用者的工作量。

我們将對軟體工程的抽象層次自上而下進行切分,會得到如下的幾個層級:行業、解決方案、應用、功能、元件;明顯的,start.spring.io目前隻能提供元件級别的支援。再将元件這層展開,會發現這樣一個生命周期:元件引入、元件配置、功能開發、線上運維。start.spring.io也隻實作了“元件引入”這一功能。

我們的目标是“讓阿裡雲成為廣大java開發者最好用的雲”。要實作這個目标,是否可以再向前走幾步,在解決“元件引入”問題的基礎上,将元件的典型使用方法、樣例代碼、使用說明也加入到工程中呢?基于這種思考,我們上線了自己的bootstrap站點:

start.aliyun.com

當然,本着不重複造輪子的原則,我們不再建構一套工程生成底層架構,而是使用

Spring Initializr

來實作這部分功能。在此之上專注于增加新特性,實作服務廣大開發者的目标。

中,我們為廣大開發者帶來了如下便利特性:

  • 為每個元件提供了單獨的DemoCode和對應的配置樣例(本次已釋出);
  • 工程内置說明,減少使用者查找文檔的困難(部分實作);
  • 開發者隻需要做減法,而非加法的使用方式(部分實作);
  • 提供多元件內建的解決方案(開發中);
  • 定期跟進start.spring.io的更新,友善大家使用到spring的最新功能;

未來,我們還需要再助力開發者這條路上繼續發力,不僅僅是做好元件內建的工作,還要需要繼續向上支援,提供更多功能、服務、應用層級的快速建構能力。

本文,圍繞spring initializr架構,以start.spring.io為例,全面的給大家介紹如何使用和擴充這個架構,以及背後的運作原理。

使用篇

由于spring-initializr提供了靈活的擴充能力,以及豐富的預設實作;其使用方式也是非常的靈活多變;為了便于說明,我們直接通過start.spring.io,看看spring自己是怎麼使用這套架構的;

基本用法

基本用法的原則,是盡量少寫代碼,甚至是不寫代碼。隻通過配置就可以實作initializr工程的建立;

依賴引入

要使用spring-initializr,首先要引入這套架構。很簡單,直接依賴bom即可:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.spring.initializr</groupId>
            <artifactId>initializr-bom</artifactId>
            <version>0.9.0.BUILD-SNAPSHOT</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>           

有了這個bom依賴,我們就不用再關心内部元件的版本等資訊了。

一般來說,我們還需要引入具體元件:

<dependency>
            <groupId>io.spring.initializr</groupId>
            <artifactId>initializr-generator-spring</artifactId>
        </dependency>
        <dependency>
            <groupId>io.spring.initializr</groupId>
            <artifactId>initializr-version-resolver</artifactId>
        </dependency>
        <dependency>
            <groupId>io.spring.initializr</groupId>
            <artifactId>initializr-web</artifactId>
        </dependency>           

具體每個子子產品的用途,這裡列出來,供讀者參考:

  • initializr-actuator: 監控診斷的附加資訊,這個暫時忽略;
  • initializr-bom: 便于外部使用的bom依賴
  • initializr-docs: 使用文檔
  • initializr-generator: 核心工程生成庫
  • initializr-generator-spring: 用于生成典型的spring boot工程
  • initializr-generator-test: 測試架構
  • initializr-metadata: 項目各個方面的中繼資料基礎結構
  • initializr-service-sample: 基本使用案例;
  • initializr-version-resolver:版本号解析能力;
  • initializr-web: 提供給三方用戶端使用的web入口;

基本配置

完成了架構引入,就需要做一些基礎配置了,

支援哪些語言:java、groovy、Kotlin

支援哪些版本:1.8、11、13

支援哪些打包方式:jar、war

将這些資訊全部配置到application.yml檔案中,如下:

initializr:
    packagings:
    - name: Jar
      id: jar
      default: true
    - name: War
      id: war
      default: false
  javaVersions:
    - id: 13
      default: false
    - id: 11
      default: false
    - id: 1.8
      name: 8
      default: true
  languages:
    - name: Java
      id: java
      default: true
    - name: Kotlin
      id: kotlin
      default: false
    - name: Groovy
      id: groovy
      default: false           

其中name是可選的,id是必填的;

每個配置項下,可以有一個預設值(将default這是為true即可)

除了這些基本配置,我們還需要定義可以支援的項目類型:

initializr:
    types:
    - name: Maven Project
      id: maven-project
      description: Generate a Maven based project archive.
      tags:
        build: maven
        format: project
      default: true
      action: /starter.zip
    - name: Maven POM
      id: maven-build
      description: Generate a Maven pom.xml.
      tags:
        build: maven
        format: build
      default: false
      action: /pom.xml
    - name: Gradle Project
      id: gradle-project
      description: Generate a Gradle based project archive.
      tags:
        build: gradle
        format: project
      default: false
      action: /starter.zip
    - name: Gradle Config
      id: gradle-build
      description: Generate a Gradle build file.
      tags:
        build: gradle
        format: build
      default: false
      action: /build.gradle           

預設情況下,initializr已經支援4種項目類型:

  • /pom.xml 生成一個Maven的pom.xml配置檔案
  • /build.gradle 生成Gradle的配置檔案
  • /starter.zip 生成zip方式壓縮的工程檔案
  • /starter.tgz 生成以tgz方式壓縮的工程檔案

通過tags标簽,我們可以定義不同配型的編譯方式(build)和打包格式(format)

配置基本依賴

完成了基本配置以後,就可以配置可選的依賴元件了

依賴配置以dependency為key,同樣配置在application.yml的initializr下面,這裡給出一個簡單的樣例:

initializr:
  dependencies:
    - name: Web
      content:
        - name: Web
          id: web
          description: Full-stack web development with Tomcat and Spring MVC
        - name: Developer Tools
      content:
        - name: Spring Boot DevTools
          id: devtools
          groupId: org.springframework.boot
          artifactId: spring-boot-devtools
          description: Provides fast application restarts, LiveReload, and configurations for enhanced development experience.
        - name: Lombok
          id: lombok
          groupId: org.projectlombok
          artifactId: lombok
          description: Java annotation library which helps to reduce boilerplate code.           

dependencies下定義分組。

分組的作用是便于展示和快速查找,是以不需要id,隻需要name資訊;每個分組的content是分組的具體内容,也就是這個分組下的元件定義;支援以清單形式定義多個;另外,每個分組都可以設定目前分組内元件公用的配置資訊;

每一依賴,包含如下的基本資訊:

  • id:元件的唯一辨別符
  • groupId & artifactId:元件的坐标;
  • name:顯示名稱
  • description:描述資訊,主要用于展示用途;
  • version:元件版本;

關于groupId & artifactId:

如果設定了坐标,生成的項目裡會使用這裡的坐标定位元件;但是如果沒有設定坐标,架構會認為這是一個标準的spring-boot元件,自動添加spring-boot-starter-{id}作為生成的依賴坐标;

關于version:

如果直接在元件上設定版本資訊,架構會直接使用這個值作為元件依賴的版本;但是很多時候,元件的版本會受到spring-boot版本的影響,此時就需要對版本做特殊的定義&管理;

配置依賴版本管理

版本範圍

這裡需要先了解一下版本命名規則:

一個典型的版本,一般包含如下4個資訊:大版本、小版本、修正版本、版本限定符;

版本範圍有一個上界和下界,可以方括号[]或者圓括号()表示。方括号代表上下界的閉區間,圓括号代表上下界的開區間;

例如:“[1.1.6.RELEASE,1.3.0.M1)”代表所有從1.1.6.RELEASE到1.3.0.M1之間所有的版本(包含1.1.6.RELEASE,但不包含1.3.0.M1)

同時,可以使用單一版本号作為版本範圍,例如“1.2.0.RELEASE”。單一版本号的版本範圍代表“從這個版本以及之後的所有版本”

如果需要使用“最新的Release版本”的概念,可以使用一個字母x代表具體的版本号。

例如,1.4.x.BUILD-SNAPSHOT代表1.4.x的最新快照版本;

再比如:如果需要表達,從1.1.0.RELEASE到1.3.x之間的所有版本,可以用[1.1.0.RELEASE,1.3.x.RELEASE]來表達;

另外,版本限定符也是有順序的(升序):

  • M:裡程碑版本
  • RC:釋出候選版本
  • RELEASE:釋出版本
  • BUILD-SNAPSHOT:為開發建構的快照版本

是以快照版本是所有限定符裡優先級最高的。假設某個元件需要spring boot的最新版本,可以使用1.5.x.BUILD-SNAPSHOT (假設1.5版是spring boot的最新版本)。

最後,版本範圍中讨論的版本,指的都是spring boot的版本,而不是元件自己的版本。

使用版本範圍

前面介紹了,可以使用version屬性定義元件的具體版本号;但是,如果元件版本與spring boot的版本存在關聯關系,就需要使用compatibilityRange來配置依賴的版本範圍;

compatibilityRange可以定義在兩個地方:

  • 直接定義在元件(或bom)上:

這種定義方式,代表元件隻支援spring boot的某一個版本範圍;

例如下面的配置:

initializr:
  dependencies:
    - name: Stuff
      content:
        - name: Foo
          id: foo
          ...
          compatibilityRange: 1.2.0.M1
        - name: Bar
          id: bar
          ...
          compatibilityRange: "[1.5.0.RC1,2.0.0.M1)"           

Foo可以支援Spring boot 1.2.0 之後的所有版本;而Bar隻能支援Spring Boot 1.5.0 到2.0.0之間的版本,且不包含2.0.0;

  • 定義在元件的mappgin屬性下:

可以支援在spring boot不同版本之下對元件做不同的設定(可以重置元件部分或者是所有的屬性),下面的例子中對artifactId做了特殊定義:

initializr:
  dependencies:
    - name: Stuff
      content:
        - name: Foo
          id: foo
          groupId: org.acme.foo
          artifactId: foo-spring-boot-starter
          compatibilityRange: 1.3.0.RELEASE
          mappings:
            - compatibilityRange: "[1.3.0.RELEASE,1.3.x.RELEASE]"
              artifactId: foo-starter
            - compatibilityRange: "1.4.0.RELEASE"           

這個例子中,foo在spring boot的1.3使用foo-starter作為坐标的artifactId;在1.4.0.RELEASE以及之後的版本中,還是使用foo-spring-boot-starter作為artifactId的值;

使用Bom管理版本

有時候,需要使用bom的方式管理元件版本;此時不需要對元件單獨設定版本号;

要使用bom,首先要配置bom定義:

initializr:
  env:
    boms:
      my-api-bom:
        groupId: org.acme
        artifactId: my-api-dependencies
        version: 1.0.0.RELEASE
        repositories: my-api-repo-1           

注意,bom資訊,定義在initializr.env.boms下面。

其屬性和依賴元件基本一緻,都是坐标、版本;同時,bom也支援版本範圍管理。

完成了bom的定義,就需要在元件中引用bom:

initializr:
  dependencies:
    - name: Other
      content:
        - name: My API
          id : my-api
          groupId: org.acme
          artifactId: my-api
          bom: my-api-bom           

一旦使用者選擇了my-api元件,架構會自動為生成的項目添加了my-api-dependencies的bom依賴;

進階定制

啟用緩存

如果你啟動過start.spring.io項目,你會在日志裡發現這樣的輸出“Fetching boot metadata from spring.io/project_metadata/spring-boot”為了避免過于頻繁的檢查spring boot版本,官方是建議配合緩存一起使用。

首先需要引入緩存架構:

<dependency>
    <groupId>javax.cache</groupId>
    <artifactId>cache-api</artifactId>
</dependency>
<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
</dependency>           

然後,在SpringBootApplication類上增加@EnableCaching注解:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

如果需要自己定義緩存,可以調整如下緩存配置:

緩存key 說明
initializr.metadata 包含了完整的服務中繼資料。如果中繼資料緩存過期,會完整重新整理全部資料(包含最新的spring boot版本資訊)
initializr.dependency-metadata 緩存元件依賴中繼資料
initializr.templates 緩存項目生成過程中的模闆檔案

增加demo代碼

由于不同的元件有不同的功能,如果需要為項目增加demo代碼。

為不同的元件增加獨立配置

還記得原理篇中提到的spring.factories嗎?對,我們要增加自己的配置項,就需要在這裡增加針對不同元件樣例代碼的擴充入口:

io.spring.initializr.generator.project.ProjectGenerationConfiguration=\
com.alibaba.alicloud.initializr.extension.dependency.springboot.SpringCloudProjectGenerationConfiguration           

在SpringCloudProjectGenerationConfiguration中,我們通過ConditionalOnRequestedDependency注解來識别不同元件:

@ProjectGenerationConfiguration
public class SpringCloudAlibabaProjectGenerationConfiguration {

    private final InitializrMetadata metadata;

    private final ProjectDescription description;

    private final IndentingWriterFactory indentingWriterFactory;

    private final TemplateRenderer templateRenderer;

    public SpringCloudAlibabaProjectGenerationConfiguration(InitializrMetadata metadata,
                                                            ProjectDescription description,
                                                            IndentingWriterFactory indentingWriterFactory,
                                                            TemplateRenderer templateRenderer) {
        this.metadata = metadata;
        this.description = description;
        this.indentingWriterFactory = indentingWriterFactory;
        this.templateRenderer = templateRenderer;
    }

    @Bean
    @ConditionalOnRequestedDependency("sca-oss")
    public OSSDemoCodeContributor ossContributor() {
        return new OSSDemoCodeContributor(description, templateRenderer);
    }
    
    ......
}
           

上面的代碼,會在選擇了sca-oss元件時,建立一個OSSDemoCodeContributor用于對應demo代碼的生成;

生成具體的demo代碼

繼續以OSSDemoCodeContributor為例,他是一個ProjectContributor,會在項目檔案空間建立完成了調用。我們需要為這個Contributor在執行個體化時增加生成過程中需要的中繼資料資訊,例如ProjectDescription。

代碼生成過程,比較簡單,可以直接複用架構中就提供的mstache模闆引擎。

我們直接将demo代碼,以模闆的形式,放置在resources檔案夾之下:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

然後,我們在通過模闆引擎,解析這些模闆檔案,再拷貝到項目目錄下即可:

private void writeCodeFile(TemplateRenderer templateRenderer, Language langeuage,
                               Map<String, Object> params, Path path, String temp) throws IOException {
        ......

        Path pkgPath = 生成包路徑
        Path filePath = 成成代碼檔案路徑

        // 渲染模闆
        String code = templateRenderer.render(temp, params);

        // demo檔案寫入
        Files.createDirectories(pkgPath);
        Files.write(filePath, code.getBytes("UTF-8"));
    }           

除了模闆代碼意外,我們通常還需要在applicatioin.properties檔案寫寫入子產品的配置資訊。

這裡,我們依然可以使用代碼生成的方式:建立模闆、解析模闆,追加檔案的方式來實作。具體代碼這裡就不貼了,讀者可以自己發揮;

原理篇

原理篇,主要介紹spring.initializr是如何實作項目工程建構的,以及作為一個架構,如何提供豐富的擴充能力的。

在原理篇,我們将initializr的執行分為兩個階段:啟動階段和生成階段。

  • 啟動階段:啟動應用,加載配置,擴充資訊初始化;
  • 生成階段:一個項目生成,從收到請求,到傳回内容的完整流程;

啟動階段

再開始啟動流程之前,先要看一下initializr的擴充體系:

整個架構大量使用了spring的spi機制,我們來看一下一共有哪些spring.factories:

  • initializr-generator/src/main/resources/META-INF/spring.factories
  • initializr-generator-spring/src/main/resources/META-INF/spring.factories
  • initializr-web/src/main/resources/META-INF/spring.factories
  • initializr-actuator/src/main/resources/META-INF/spring.factories
  • start-site/src/main/resources/META-INF/spring.factories

其中隻有一個在start.spring.io中,其他4個都在initializr工程中(各spring.factories的具體内容見參考資料);

不過要注意,這些spring.factories定義,僅僅代表了各個SPI有哪些擴充。不同spi的實作建立和使用完全是在不同的階段進行的;

在應用啟動階段,其實隻有一個spi會被加載(暫不考慮actuator):io.spring.initializr.web.autoconfigure.InitializrAutoConfiguration

@Configuration
@EnableConfigurationProperties(InitializrProperties.class)
public class InitializrAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public ProjectDirectoryFactory projectDirectoryFactory()

    @Bean
    @ConditionalOnMissingBean
    public IndentingWriterFactory indentingWriterFactory()

    @Bean
    @ConditionalOnMissingBean(TemplateRenderer.class)
    public MustacheTemplateRenderer templateRenderer(Environment environment, ObjectProvider<CacheManager> cacheManager)

    @Bean
    @ConditionalOnMissingBean
    public InitializrMetadataUpdateStrategy initializrMetadataUpdateStrategy(RestTemplateBuilder restTemplateBuilder,
            ObjectMapper objectMapper)

    @Bean
    @ConditionalOnMissingBean(InitializrMetadataProvider.class)
    public InitializrMetadataProvider initializrMetadataProvider(InitializrProperties properties,
            InitializrMetadataUpdateStrategy initializrMetadataUpdateStrategy)

    @Bean
    @ConditionalOnMissingBean
    public DependencyMetadataProvider dependencyMetadataProvider()

    @Configuration
    @ConditionalOnWebApplication
    static class InitializrWebConfiguration {
        @Bean
        InitializrWebConfig initializrWebConfig()

        @Bean
        @ConditionalOnMissingBean
        ProjectGenerationController<ProjectRequest> projectGenerationController(
                InitializrMetadataProvider metadataProvider, ApplicationContext applicationContext)

        @Bean
        @ConditionalOnMissingBean
        ProjectMetadataController projectMetadataController(InitializrMetadataProvider metadataProvider,
                DependencyMetadataProvider dependencyMetadataProvider)

        @Bean
        @ConditionalOnMissingBean
        CommandLineMetadataController commandLineMetadataController(InitializrMetadataProvider metadataProvider,
                TemplateRenderer templateRenderer)

        @Bean
        @ConditionalOnMissingBean
        SpringCliDistributionController cliDistributionController(InitializrMetadataProvider metadataProvider)
    }
}           

這裡會作如下幾件事情:

  • 初始化中繼資料Provider;
  • 建立模闆引擎;
  • 建立目錄、縮進工廠;
  • 初始化web配置;
  • 建立spring mvc的web入口

各種ProjectGenerationController

其中最關鍵的中繼資料加載部分,使用了EnableConfigurationProperties注解,将spring環境中的配置項寫到InitializrProperties上:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

在application.yml檔案中,可以找到如下的配置資訊,這裡就是實際的項目依賴關系中繼資料的配置存儲點:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

整體來看,啟動階段的動作還是比較簡單的,這也是為什麼start.spring.io啟動隻需要數秒的原因;

更多的邏輯,都被留在了工程生成階段;

生成階段

生成階段,spring-initializr使用了一個很有意思的實作方式:

initializr架構會為每一次項目生成,建立一個獨立的context用于存放生成流程中需要使用到的各種bean;

先來一張時序圖:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料
  • 藍色的類,是在應用啟動階段就完成了建立和資料填充;其生命周期和整個應用一緻;
  • 黃色的類,會在具體的項目建構過程中生成;其生命周期在一次項目生成流程之内結束;

從上面的時序圖中可以看出:一個典型的建立行為,通常從ProjectGenerationController收到web端的建立請求開始,通過ProjectGenerationInvoker這個中間層轉換,最終進入ProjectGenerator的核心建構流程;

主幹流程

下圖,是ProjectGenerator的核心建構流程:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

106行,通過contextFactory建構了一個新的ProjectGenerationContext;

看一下這個context的繼承關系,原來于spring提供的AnnotationConfigApplicationContext;

再結合110行的refresh()方法,是不是發現了什麼?就是spring的ApplicationContext的重新整理流程;

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

107行的resolve方法,向context中注冊了一個ProjectDescription的Provider,代碼如下:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

由于注冊的是Provider,是以這段邏輯會在Context執行refresh時運作;

這裡的ProjectDescriptionCustomizer就是針對ProjectDescription的擴充,用于對使用者傳入的ProjectDescription做調整。這裡主要是一些強制依賴關系的調整,例如語言版本等;

這時候再看108行,這裡向Context注冊一個Configuration。

那麼這個這個Configuration包含了什麼内容呢?一起來看下面這段代碼:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

ProjectGenerationConfiguration!!!前面提到的spring.factories中有很多這個SPI的實作(參見參考資料)

原來,initializr的整個擴充體系,在這裡才開始建立執行個體;

ProjectGenerator的109行,對一個consumer做了accept操作;其實就是調用了下面的代碼:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

這裡通過setParent将應用的主上下文設定為這次ProjectGenerationContext的父節點;

并且向這次ProjectGenerationContext中注冊了中繼資料對象;

最後,在ProjectGenerator的112行,調用了projectAssetGenerator的generate方法,實作如下:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

通過上面的代碼可以發現,這裡對

實際的工程建構工作,其實就是很多的ProjectContributor共同疊加;

至此,主幹流程已經結束了。

我們可以發現,在主幹流程中,沒有做任何寫檔案的操作(隻建立了根檔案夾);它僅僅是定義了一套資料加載、擴充加載的機制與流程,将所有的具體實作都作為擴充的一部分。

擴充流程

spring-initializr提供了2中主要擴充途徑:

ProjectContributor

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

從方法簽名就可以看出,入參隻有一個項目的根路徑,其職責就是向這個路徑下些人項目檔案。這個擴充點非常的靈活,幾乎可以支援任何的代碼、配置檔案寫入工作;

實作過程中,可以通過ProjectGenerationContext擷取相關依賴,然後通過自定義邏輯完成檔案生成工作。

下面是initializr和start.spring.io提供的ProjectContributor實作:

start.aliyun.com 正式上線!極速建構 bootstrap 應用背景使用篇原理篇參考資料

拿幾個主要的實作看看:

  • MavenBuildProjectContributor:寫入maven項目pom.xml檔案
  • WebFoldersContributor:建立web項目的資源檔案夾
  • ApplicationPropertiesContributor:寫入application.properties檔案
  • MainSourceCodeProjectContributor:寫入應用入口類xxxApplication.java檔案
  • HelpDocumentProjectContributor:寫入幫助文檔HELP.md檔案

xxxxxCustomizer:

相對于ProjectContributor,xxxxxCustomizer不是一個統一的接口,我把他了解為一種感念和與之對應的命名習慣;每個Customizer都有自己明确的名字,同時也對應了明确的觸發邏輯和職責邊界;

下面列出架構提供的Customizer的說明:

  • MainApplicationTypeCustomizer:自定義MainApplication類
  • MainCompilationUnitCustomizer:自定義MainApplication編譯單元
  • MainSourceCodeCustomizer:自定義MainApplication源碼
  • BuildCustomizer:自定義項目建構工具的配置内容
  • GitIgnoreCustomizer:自定義項目的.gitignore檔案
  • HelpDocumentCustomizer:自定義項目的幫助文檔
  • InitializrMetadataCustomizer:自定義項目初始化配置中繼資料;這個Customizer比較特殊,架構會在首次加載中繼資料配置時調用;
  • ProjectDescriptionCustomizer:自定義ProjectDescription;即在生成項目檔案之前,允許調整項目描述資訊;
  • ServletInitializerCustomizer:自定義web應用在類上的配置内容;
  • TestApplicationTypeCustomizer:自定義測試Application類;
  • TestSourceCodeCustomizer:自定義測試Application類的源碼;

參考資料

相關連結

spring.factories明細

io.spring.initializr.generator.buildsystem.BuildSystemFactory=\
io.spring.initializr.generator.buildsystem.gradle.GradleBuildSystemFactory,\
io.spring.initializr.generator.buildsystem.maven.MavenBuildSystemFactory

io.spring.initializr.generator.language.LanguageFactory=\
io.spring.initializr.generator.language.groovy.GroovyLanguageFactory,\
io.spring.initializr.generator.language.java.JavaLanguageFactory,\
io.spring.initializr.generator.language.kotlin.KotlinLanguageFactory

io.spring.initializr.generator.packaging.PackagingFactory=\
io.spring.initializr.generator.packaging.jar.JarPackagingFactory,\
io.spring.initializr.generator.packaging.war.WarPackagingFactory           
io.spring.initializr.generator.project.ProjectGenerationConfiguration=\
io.spring.initializr.generator.spring.build.BuildProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.build.gradle.GradleProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.build.maven.MavenProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.code.SourceCodeProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.code.groovy.GroovyProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.code.java.JavaProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.code.kotlin.KotlinProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.configuration.ApplicationConfigurationProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.documentation.HelpDocumentProjectGenerationConfiguration,\
io.spring.initializr.generator.spring.scm.git.GitProjectGenerationConfiguration           
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
io.spring.initializr.web.autoconfigure.InitializrAutoConfiguration

org.springframework.boot.env.EnvironmentPostProcessor=\
io.spring.initializr.web.autoconfigure.CloudfoundryEnvironmentPostProcessor           
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
io.spring.initializr.actuate.autoconfigure.InitializrActuatorEndpointsAutoConfiguration,\
io.spring.initializr.actuate.autoconfigure.InitializrStatsAutoConfiguration           
io.spring.initializr.generator.project.ProjectGenerationConfiguration=\
io.spring.start.site.extension.build.gradle.GradleProjectGenerationConfiguration,\
io.spring.start.site.extension.build.maven.MavenProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.DependencyProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springamqp.SpringAmqpProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springboot.SpringBootProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springcloud.SpringCloudProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springdata.SpringDataProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springintegration.SpringIntegrationProjectGenerationConfiguration,\
io.spring.start.site.extension.dependency.springrestdocs.SpringRestDocsProjectGenerationConfiguration,\
io.spring.start.site.extension.description.DescriptionProjectGenerationConfiguration,\
io.spring.start.site.extension.code.kotin.KotlinProjectGenerationConfiguration           

作者資訊:陳曦,花名良名,阿裡巴巴技術專家。目前在應用容器&服務架構團隊,Spring Cloud Alibaba 項目成員,緻力于将阿裡雲打造為java開者發最好用的雲。2014年加入B2B,多次參與雙 11、618 作戰。