作者 | 良名 阿里巴巴技術(shù)專家

背景

相信很多人都使用過 start.spring.io 來初始化自己的 Spring Boot 工程，這個工具為開發(fā)者提供了豐富的可選組件，并且可以選擇多種打包方式，大大方便了開發(fā)人員的使用。最近，阿里的 Nacos、Sentinel 也進入 start.spring.io 的選項中，進一步的方便開發(fā)者使用阿里云的產(chǎn)品。

但是，生成的工程骨架中，只有組件坐標信息，缺少對應(yīng)的使用方法和 Demo 代碼；于是，開發(fā)者還是需要去尋找相關(guān)使用教程，或者樣例代碼；如果找的不對，或者是版本不匹匹配，還需要花費不少時間去排查和解決問題；這些問題都在無形中增加用戶的工作量。

我們將對軟件工程的抽象層次自上而下進行切分，會得到如下的幾個層級：行業(yè)、解決方案、應(yīng)用、功能、組件；明顯的， start.spring.io 目前只能提供組件級別的支持。再將組件這層展開，會發(fā)現(xiàn)這樣一個生命周期：組件引入、組件配置、功能開發(fā)、線上運維。start.spring.io 也只實現(xiàn)了“組件引入”這一功能。

我們的目標是**“讓阿里云成為廣大 Java 開發(fā)者最好用的云”**。要實現(xiàn)這個目標，是否可以再向前走幾步，在解決“組件引入”問題的基礎(chǔ)上，將組件的典型使用方法、樣例代碼、使用說明也加入到工程中呢？

基于這種思考，我們上線了自己的 bootstrap 站點 start.aliyun.com ：

https://start.aliyun.com/

當然，本著不重復(fù)造輪子的原則，我們不再構(gòu)建一套工程生成底層框架，而是使用 Spring Initializr 來實現(xiàn)這部分功能。在此之上專注于增加新特性，實現(xiàn)服務(wù)廣大開發(fā)者的目標。

Spring Initializr：https://github.com/spring-io/initializr

在 start.aliyun.com 中，我們?yōu)閺V大開發(fā)者帶來了如下便利特性：

• 為每個組件提供了單獨的 DemoCode 和對應(yīng)的配置樣例（本次已發(fā)布）；
• 工程內(nèi)置說明，減少用戶查找文檔的困難（部分實現(xiàn)）；
• 開發(fā)者只需要做減法，而非加法的使用方式（部分實現(xiàn)）；
• 提供多組件集成的解決方案（開發(fā)中）；
• 定期跟進 start.spring.io 的更新，方便大家使用到 spring 的最新功能。

start.aliyun.com：https://start.aliyun.com/

未來，我們還需要再助力開發(fā)者這條路上繼續(xù)發(fā)力，不僅僅是做好組件集成的工作，還要需要繼續(xù)向上支持，提供更多功能、服務(wù)、應(yīng)用層級的快速構(gòu)建能力。

本文，圍繞 spring initializr 框架，以 start.spring.io 為例，全面的給大家介紹如何使用和擴展這個框架，以及背后的運行原理。

使用篇

由于 spring-initializr 提供了靈活的擴展能力，以及豐富的默認實現(xiàn)；其使用方式也是非常的靈活多變；為了便于說明，我們直接通過 start.spring.io ，看看 Spring 自己是怎么使用這套框架的。

1. 基本用法

基本用法的原則，是盡量少寫代碼，甚至是不寫代碼。只通過配置就可以實現(xiàn) initializr 工程的創(chuàng)建。

依賴引入

要使用 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 依賴，我們就不用再關(guān)心內(nèi)部組件的版本等信息了。

一般來說，我們還需要引入具體組件：

<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: 監(jiān)控診斷的附加信息，這個暫時忽略；
• initializr-bom: 便于外部使用的bom依賴；
• initializr-docs: 使用文檔；
• initializr-generator: 核心工程生成庫；
• initializr-generator-spring: 用于生成典型的spring boot工程；
• initializr-generator-test: 測試框架；
• initializr-metadata: 項目各個方面的元數(shù)據(jù)基礎(chǔ)結(jié)構(gòu)；
• initializr-service-sample: 基本使用案例；
• initializr-version-resolver:版本號解析能力；
• initializr-web: 提供給三方客戶端使用的web入口。

基本配置

• 完成了框架引入，就需要做一些基礎(chǔ)配置了
• 支持哪些語言：Java、groovy、Kotlin
• 支持哪些版本：1.8、11、13
• 支持哪些打包方式：jar、war

將這些信息全部配置到 application.yml 文件中，如下：

initializr:packagings:- name: Jarid: jardefault: true- name: Warid: wardefault: falsejavaVersions:- id: 13default: false- id: 11default: false- id: 1.8name: 8default: truelanguages:- name: Javaid: javadefault: true- name: Kotlinid: kotlindefault: false- name: Groovyid: groovydefault: false

其中 name 是可選的， id 是必填的。

每個配置項下，可以有一個默認值（將 default 這是為 true 即可），除了這些基本配置，我們還需要定義可以支持的項目類型：

initializr:types:- name: Maven Projectid: maven-projectdescription: Generate a Maven based project archive.tags:build: mavenformat: projectdefault: trueaction: /starter.zip- name: Maven POMid: maven-builddescription: Generate a Maven pom.xml.tags:build: mavenformat: builddefault: falseaction: /pom.xml- name: Gradle Projectid: gradle-projectdescription: Generate a Gradle based project archive.tags:build: gradleformat: projectdefault: falseaction: /starter.zip- name: Gradle Configid: gradle-builddescription: Generate a Gradle build file.tags:build: gradleformat: builddefault: falseaction: /build.gradle

默認情況下， initializr 已經(jīng)支持 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: Webcontent:- name: Webid: webdescription: Full-stack web development with Tomcat and Spring MVC- name: Developer Toolscontent:- name: Spring Boot DevToolsid: devtoolsgroupId: org.springframework.bootartifactId: spring-boot-devtoolsdescription: Provides fast application restarts, LiveReload, and configurations for enhanced development experience.- name: Lombokid: lombokgroupId: org.projectlombokartifactId: lombokdescription: Java annotation library which helps to reduce boilerplate code.

dependencies 下定義分組。分組的作用是便于展示和快速查找，所以不需要 id ，只需要 name 信息；每個分組的 content 是分組的具體內(nèi)容，也就是這個分組下的組件定義；支持以列表形式定義多個；另外，每個分組都可以設(shè)置當前分組內(nèi)組件公用的配置信息。

每一依賴，包含如下的基本信息：

• id：組件的唯一標識符
• groupId & artifactId：組件的坐標
• name：顯示名稱
• description：描述信息，主要用于展示用途
• version：組件版本

關(guān)于 groupId & artifactId：如果設(shè)置了坐標，生成的項目里會使用這里的坐標定位組件；但是如果沒有設(shè)置坐標，框架會認為這是一個標準的 spring-boot 組件，自動添加 spring-boot-starter-{id} 作為生成的依賴坐標。

關(guān)于 version：如果直接在組件上設(shè)置版本信息，框架會直接使用這個值作為組件依賴的版本；但是很多時候，組件的版本會受到 spring-boot 版本的影響，此時就需要對版本做特殊的定義 & 管理。

配置依賴版本管理

這里需要先了解一下版本命名規(guī)則：一個典型的版本，一般包含如下 4 個信息：大版本、小版本、修正版本、版本限定符。

版本范圍有一個上界和下界，可以方括號 [] 或者圓括號 () 表示。方括號代表上下界的閉區(qū)間，圓括號代表上下界的開區(qū)間。

例如：“[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：發(fā)布候選版本
• RELEASE：發(fā)布版本
• BUILD-SNAPSHOT：為開發(fā)構(gòu)建的快照版本

所以快照版本是所有限定符里優(yōu)先級最高的。假設(shè)某個組件需要 Spring Boot 的最新版本，可以使用 1.5.x.BUILD-SNAPSHOT (假設(shè) 1.5 版是 Spring Boot 的最新版本)。

最后，版本范圍中討論的版本，指的都是 Spring Boot的版本，而不是組件自己的版本。

前面介紹了，可以使用 version 屬性定義組件的具體版本號；但是，如果組件版本與Spring Boot 的版本存在關(guān)聯(lián)關(guān)系，就需要使用 compatibilityRange 來配置依賴的版本范圍。

compatibilityRange 可以定義在兩個地方：

• 直接定義在組件（或 Bom ）上

這種定義方式，代表組件只支持 Spring Boot 的某一個版本范圍，例如下面的配置：

initializr:dependencies:- name: Stuffcontent:- name: Fooid: foo...compatibilityRange: 1.2.0.M1- name: Barid: 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 不同版本之下對組件做不同的設(shè)置（可以重置組件部分或者是所有的屬性），下面的例子中對 artifactId 做了特殊定義：

initializr:dependencies:- name: Stuffcontent:- name: Fooid: foogroupId: org.acme.fooartifactId: foo-spring-boot-startercompatibilityRange: 1.3.0.RELEASEmappings:- 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 的方式管理組件版本；此時不需要對組件單獨設(shè)置版本號。

要使用 Bom ，首先要配置 Bom 定義：

initializr:env:boms:my-api-bom:groupId: org.acmeartifactId: my-api-dependenciesversion: 1.0.0.RELEASErepositories: my-api-repo-1

注意：Bom 信息，定義在 initializr.env.boms下面。

其屬性和依賴組件基本一致，都是坐標、版本；同時， Bom 也支持版本范圍管理。

完成了 Bom 的定義，就需要在組件中引用 Bom ：

initializr:dependencies:- name: Othercontent:- name: My APIid : my-apigroupId: org.acmeartifactId: my-apibom: my-api-bom

一旦用戶選擇了 my-api 組件，框架會自動為生成的項目添加了 my-api-dependencies 的 Bom 依賴；

2. 高級定制

啟用緩存

如果你啟動過 start.spring.io 項目，你會在日志里發(fā)現(xiàn)這樣的輸出 “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 注解:

如果需要自己定義緩存，可以調(diào)整如下緩存配置：

**增加 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 組件時，創(chuàng)建一個 OSSDemoCodeContributor 用于對應(yīng) Demo 代碼的生成。

**生成具體的 Demo 代碼：**繼續(xù)以 OSSDemoCodeContributor 為例，它是一個 ProjectContributor ，會在項目文件空間創(chuàng)建完成了調(diào)用。我們需要為這個 Contributor 在實例化時增加生成過程中需要的元數(shù)據(jù)信息，例如 ProjectDescription 。

代碼生成過程，比較簡單，可以直接復(fù)用框架中就提供的 mstache 模板引擎。

我們直接將 Demo 代碼，以模板的形式，放置在 resources 文件夾之下：

然后，我們再通過模板引擎，解析這些模板文件，再拷貝到項目目錄下即可：

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 文件寫入模塊的配置信息。

這里，我們依然可以使用代碼生成的方式：創(chuàng)建模板、解析模板，追加文件的方式來實現(xiàn)。具體代碼這里就不貼了，讀者可以自己發(fā)揮。

原理篇

原理篇，主要介紹 spring.initializr 是如何實現(xiàn)項目工程構(gòu)建的，以及作為一個框架，如何提供豐富的擴展能力的。

在原理篇，我們將 initializr 的執(zhí)行分為兩個階段：啟動階段和生成階段。

• 啟動階段：啟動應(yīng)用，加載配置，擴展信息初始化；
• 生成階段：一個項目生成，從收到請求，到返回內(nèi)容的完整流程。

1. 啟動階段

再開始啟動流程之前，先要看一下 initializr 的擴展體系。

整個架構(gòu)大量使用了 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 的具體內(nèi)容見參考資料）。

不過要注意，這些 spring.factories 定義，僅僅代表了各個 SPI 有哪些擴展。不同spi的實現(xiàn)創(chuàng)建和使用完全是在不同的階段進行的。

在應(yīng)用啟動階段，其實只有一個 spi 會被加載（暫不考慮 actuator）：io.spring.initializr.web.autoconfigure.InitializrAutoConfiguration 。

@Configuration @EnableConfigurationProperties(InitializrProperties.class) public class InitializrAutoConfiguration {@Bean@ConditionalOnMissingBeanpublic ProjectDirectoryFactory projectDirectoryFactory()@Bean@ConditionalOnMissingBeanpublic IndentingWriterFactory indentingWriterFactory()@Bean@ConditionalOnMissingBean(TemplateRenderer.class)public MustacheTemplateRenderer templateRenderer(Environment environment, ObjectProvider<CacheManager> cacheManager)@Bean@ConditionalOnMissingBeanpublic InitializrMetadataUpdateStrategy initializrMetadataUpdateStrategy(RestTemplateBuilder restTemplateBuilder,ObjectMapper objectMapper)@Bean@ConditionalOnMissingBean(InitializrMetadataProvider.class)public InitializrMetadataProvider initializrMetadataProvider(InitializrProperties properties,InitializrMetadataUpdateStrategy initializrMetadataUpdateStrategy)@Bean@ConditionalOnMissingBeanpublic DependencyMetadataProvider dependencyMetadataProvider()@Configuration@ConditionalOnWebApplicationstatic class InitializrWebConfiguration {@BeanInitializrWebConfig initializrWebConfig()@Bean@ConditionalOnMissingBeanProjectGenerationController<ProjectRequest> projectGenerationController(InitializrMetadataProvider metadataProvider, ApplicationContext applicationContext)@Bean@ConditionalOnMissingBeanProjectMetadataController projectMetadataController(InitializrMetadataProvider metadataProvider,DependencyMetadataProvider dependencyMetadataProvider)@Bean@ConditionalOnMissingBeanCommandLineMetadataController commandLineMetadataController(InitializrMetadataProvider metadataProvider,TemplateRenderer templateRenderer)@Bean@ConditionalOnMissingBeanSpringCliDistributionController cliDistributionController(InitializrMetadataProvider metadataProvider)} }

這里會做如下幾件事情：

• 初始化元數(shù)據(jù) Provider
• 創(chuàng)建模板引擎
• 創(chuàng)建目錄、縮進工廠
• 初始化 web 配置
• 創(chuàng)建 spring mvc 的 web 入口
• 各種 ProjectGenerationController

其中最關(guān)鍵的元數(shù)據(jù)加載部分，使用了 EnableConfigurationProperties 注解，將 spring 環(huán)境中的配置項寫到 InitializrProperties 上：

在 application.yml 文件中，可以找到如下的配置信息，這里就是實際的項目依賴關(guān)系元數(shù)據(jù)的配置存儲點：

整體來看，啟動階段的動作還是比較簡單的，這也是為什么 start.spring.io 啟動只需要數(shù)秒的原因。

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

2. 生成階段

生成階段，spring-initializr 使用了一個很有意思的實現(xiàn)方式：initializr 框架會為每一次項目生成，創(chuàng)建一個獨立的 context 用于存放生成流程中需要使用到的各種 bean 。

先來一張時序圖：

• 藍色的類，是在應(yīng)用啟動階段就完成了創(chuàng)建和數(shù)據(jù)填充；其生命周期和整個應(yīng)用一致；
• 黃色的類，會在具體的項目構(gòu)建過程中生成；其生命周期在一次項目生成流程之內(nèi)結(jié)束。

從上面的時序圖中可以看出：一個典型的創(chuàng)建行為，通常從 ProjectGenerationController收到web端的創(chuàng)建請求開始，通過 ProjectGenerationInvoker 這個中間層轉(zhuǎn)換，最終進入 ProjectGenerator 的核心構(gòu)建流程。

主干流程

下圖，是 ProjectGenerator 的核心構(gòu)建流程：

106 行，通過 contextFactory 構(gòu)建了一個新的 ProjectGenerationContext 。

看一下這個context的繼承關(guān)系，原來于spring提供的AnnotationConfigApplicationContext 。

再結(jié)合 110 行的 refresh() 方法，是不是發(fā)現(xiàn)了什么？就是 spring 的 ApplicationContext 的刷新流程。

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

由于注冊的是 Provider ，所以這段邏輯會在 Context 執(zhí)行 refresh 時運行。

這里的 ProjectDescriptionCustomizer 就是針對 ProjectDescription 的擴展，用于對用戶傳入的 ProjectDescription 做調(diào)整。這里主要是一些強制依賴關(guān)系的調(diào)整，例如語言版本等。

這時候再看 108 行，這里向 Context 注冊一個 Configuration 。

那么這個 Configuration 包含了什么內(nèi)容呢？一起來看下面這段代碼：

ProjectGenerationConfiguration！！！前面提到的 spring.factories 中有很多這個 SPI 的實現(xiàn)（參見參考資料）。

原來，initializr 的整個擴展體系，在這里才開始創(chuàng)建實例；

ProjectGenerator 的 109 行，對一個 consumer 做了 accept 操作；其實就是調(diào)用了下面的代碼：

這里通過 setParent 將應(yīng)用的主上下文設(shè)置為這次 ProjectGenerationContext 的父節(jié)點。

并且向這次 ProjectGenerationContext 中注冊了元數(shù)據(jù)對象。

最后，在 ProjectGenerator 的 112 行，調(diào)用了 projectAssetGenerator 的 generate 方法，實現(xiàn)如下：

通過上面的代碼可以發(fā)現(xiàn)，這里對實際的工程構(gòu)建工作，其實就是很多的 ProjectContributor 共同疊加；

至此，主干流程已經(jīng)結(jié)束了。

我們可以發(fā)現(xiàn)，在主干流程中，沒有做任何寫文件的操作（只創(chuàng)建了根文件夾）；它僅僅是定義了一套數(shù)據(jù)加載、擴展加載的機制與流程，將所有的具體實現(xiàn)都作為擴展的一部分。

擴展流程

spring-initializr 提供了 2 種主要擴展途徑：ProjectContributor 和 xxxxxCustomizer。

從方法簽名就可以看出，入?yún)⒅挥幸粋€項目的根路徑，其職責就是向這個路徑下些人項目文件。這個擴展點非常的靈活，幾乎可以支持任何的代碼、配置文件寫入工作。

實現(xiàn)過程中，可以通過 ProjectGenerationContext 獲取相關(guān)依賴，然后通過自定義邏輯完成文件生成工作。

下面是 initializr 和 start.spring.io 提供的 ProjectContributor 實現(xiàn)：

拿幾個主要的實現(xiàn)看看：

• MavenBuildProjectContributor：寫入 maven 項目 pom.xml 文件；
• WebFoldersContributor：創(chuàng)建 web 項目的資源文件夾；
• ApplicationPropertiesContributor：寫入 application.properties 文件；
• MainSourceCodeProjectContributor：寫入應(yīng)用入口類 xxxApplication.java 文件；
• HelpDocumentProjectContributor：寫入幫助文檔 HELP.md 文件。

相對于 ProjectContributor，xxxxxCustomizer 不是一個統(tǒng)一的接口，我把他理解為一種感念和與之對應(yīng)的命名習慣；每個 Customizer 都有自己明確的名字，同時也對應(yīng)了明確的觸發(fā)邏輯和職責邊界。

下面列出框架提供的 Customizer 的說明：

• MainApplicationTypeCustomizer：自定義 MainApplication 類；
• MainCompilationUnitCustomizer：自定義 MainApplication 編譯單元；
• MainSourceCodeCustomizer：自定義 MainApplication 源碼；
• BuildCustomizer：自定義項目構(gòu)建工具的配置內(nèi)容；
• GitIgnoreCustomizer：自定義項目的 .gitignore 文件；
• HelpDocumentCustomizer：自定義項目的幫助文檔；
• InitializrMetadataCustomizer：自定義項目初始化配置元數(shù)據(jù)；這個 Customizer 比較特殊，框架會在首次加載元數(shù)據(jù)配置時調(diào)用；
• ProjectDescriptionCustomizer：自定義 ProjectDescription ；即在生成項目文件之前，允許調(diào)整項目描述信息；
• ServletInitializerCustomizer：自定義 web 應(yīng)用在類上的配置內(nèi)容；
• TestApplicationTypeCustomizer：自定義測試 Application 類；
• TestSourceCodeCustomizer：自定義測試 Application 類的源碼。

參考資料

1. 相關(guān)鏈接

• initializr 說明文檔

https://docs.spring.io/initializr/docs/current-SNAPSHOT/reference/html/

• spring-initializr 項目地址

https://github.com/spring-io/initializr

• start.spring.io 項目地址

https://github.com/spring-io/start.spring.io

2. spring.factories 明細

initializr-generator/src/main/resources/META-INF/spring.factoriesio.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

initializr-generator-spring/src/main/resources/META-INF/spring.factories：

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

initializr-web/src/main/resources/META-INF/spring.factories：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ io.spring.initializr.web.autoconfigure.InitializrAutoConfiguration org.springframework.boot.env.EnvironmentPostProcessor=\ io.spring.initializr.web.autoconfigure.CloudfoundryEnvironmentPostProcessor

initializr-actuator/src/main/resources/META-INF/spring.factories：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ io.spring.initializr.actuate.autoconfigure.InitializrActuatorEndpointsAutoConfiguration,\ io.spring.initializr.actuate.autoconfigure.InitializrStatsAutoConfiguration

start-site/src/main/resources/META-INF/spring.factories：

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

作者信息：
陳曦（花名：良名）阿里巴巴技術(shù)專家。目前在應(yīng)用容器&服務(wù)框架團隊，Spring Cloud Alibaba 項目成員，致力于將阿里云打造為Java開發(fā)者最好用的云。2014 年加入 B2B，多次參與 雙11、618 作戰(zhàn)。

“阿里巴巴云原生關(guān)注微服務(wù)、Serverless、容器、Service Mesh 等技術(shù)領(lǐng)域、聚焦云原生流行技術(shù)趨勢、云原生大規(guī)模的落地實踐，做最懂云原生開發(fā)者的公眾號。”
/

總結(jié)

以上是生活随笔為你收集整理的阿里云发布 Spring Boot 新脚手架，真香的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。