1. Spring Profile

Spring可使用Profile絕對程序在不同環(huán)境下執(zhí)行情況，包含配置、加載Bean、依賴等。

Spring的Profile一般項目包含：dev(開發(fā)), test(單元測試), qa(集成測試), prod(生產(chǎn)環(huán)境)。由spring.profiles.active屬性絕定啟用的profile。

SpringBoot的配置文件默認(rèn)為 application.properties(或yaml，此外僅心properties配置為說明)。不同Profile下的配置文件由application-{profile}.properties管理，同時獨立的 Profile配置文件會覆蓋默認(rèn)文件下的屬性。

2. Maven Profile

Maven同樣也有Profile設(shè)置，可在構(gòu)建過程中針對不同的Profile環(huán)境執(zhí)行不同的操作，包含配置、依賴、行為等。

Maven的Profile由 pom.xml 的<Profiles>標(biāo)簽管理。每個Profile中可設(shè)置：id(唯一標(biāo)識), properties(配置屬性), activation(自動觸發(fā)的邏輯條件), dependencies(依賴)等。

此文章不對Spring和Maven的Profile作過多說明，詳細(xì)情況請自行查閱。

3. Maven 管理 Spring Profile

由于構(gòu)建是基于Maven(或Gradle，此處僅以Maven說明)。所以使用Maven管理Spring構(gòu)建時的Profile是非常方便的。

Maven管理Spring Profile分五步，以下詳細(xì)介紹。

3.1 去掉默認(rèn)的 Tomcat依賴

在SpringBoot MVC項目中，默認(rèn)以內(nèi)嵌Tomcat運行，如果需要特殊的設(shè)置或者使用Undertow，需要去掉默認(rèn)的Tomcat依賴：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
    </exclusion>
  </exclusions>
</dependency>

如果你同時使用了 MyBatis，需要去掉tomcat-jdbc依賴：

<dependency>
  <groupId>org.mybatis.spring.boot</groupId>
  <artifactId>mybatis-spring-boot-starter</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-jdbc</artifactId>
    </exclusion>
  </exclusions>
</dependency>

3.2 Maven Profile設(shè)置

在項目（如果有模塊為具體模塊）的pom.xml下設(shè)置:

<!-- Maven控制Spring Profile -->
<profiles>
  <profile>
    <id>dev</id>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
      <profileActive>dev</profileActive>
    </properties>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
      </dependency>
      <dependency>
        <groupId>org.apache.tomcat</groupId>
        <artifactId>tomcat-jdbc</artifactId>
      </dependency>
    </dependencies>
  </profile>
  <profile>
    <id>prod</id>
    <properties>
      <profileActive>prod</profileActive>
    </properties>
  </profile>
</profiles>

從上面的配置可以看出，Maven的Profile配置了兩個：dev和prod，并且在dev中使用了內(nèi)嵌Tomcat，而 prod 中沒有，所以這兩個Profile打包的文件dev可以直接運行（Plugin使用了SpringBoot Plugin），而prod并不能直接運行（或部署在外部Tomcat下，并不推薦這樣，后面會說明）。

properties中的profileActive是我們申明的屬性，此處對應(yīng)Spring的Profile值。

3.3 Maven資源過濾

SpringBoot的 Profile選擇需要在 application.properties中配置，如果定死在文件，那么每次打包都需要手動修改，很麻煩，而且容易出錯。

Maven的資源過濾功能可以實現(xiàn)在構(gòu)建時修改以“@xxx@”表示的屬性。資源過濾需要在pom.xml的<build>標(biāo)簽下配置 resources：

<!-- profile對資源的操作 -->
<resources>
  <resource>
    <directory>src/main/resources</directory>
    <excludes>
      <exclude>application*.properties</exclude>
    </excludes>
  </resource>
  <resource>
    <directory>src/main/resources</directory>
    <!-- 是否替換@xx@表示的maven properties屬性值 -->
    <filtering>true</filtering>
    <includes>
      <include>application.properties</include>
      <include>application-${profileActive}.properties</include>
    </includes>
  </resource>
</resources>

上面的第一個resource去掉了src/main/resources下的所有application.properties文件，“”是通配符，表示此處有任何內(nèi)容（沒有也可以）都匹配。

第二個resource添加了application.properties默認(rèn)配置文件和由profileActive屬性決定的相應(yīng)profile配置文件。并且filtering為true表示，會將文件內(nèi)容的“@xx@”替換為相應(yīng)的變量（如文件中的@profileActive@會替換為profileActive屬性值）。

3.4 Spring配置Profile

在application.properties默認(rèn)配置文件中配置：

spring.profiles.active = @profileActive@

@profileActive@表示該屬性值會在maven構(gòu)建時被替換掉。

3.5 構(gòu)建

構(gòu)建命令：

mvn clean package -Pdev

上面的命令會根據(jù)Maven Profile的 dev構(gòu)建環(huán)境包，如果需要prod包，則把-P的參數(shù)替換成prod即可。

為了方便我會在每個項目下生成一個build.sh文件，內(nèi)容如下：

#!/bin/bash
profileActive=prod
if [ -n "$1" ]; then
  profileActive=$1
fi
mvn clean package -Dmaven.test.skip=true -P$profileActive

該腳本接收一個參數(shù)，即打包對應(yīng)的Profile。默認(rèn)情況下如果不帶參數(shù)，會打包prod環(huán)境包。

需要注意的是，該命令跳過了測試。

4. 總結(jié)

完成了上面的五步，即可使項目根據(jù)你的構(gòu)建參數(shù)的不同，打包出不同環(huán)境下運行的包。

第1步去掉了SpringBoot內(nèi)嵌的tomcat和tomcat-jdbc。使得我們可以決定在什么情況下使用何種容器運行我們的項目。
第2步配置了Maven構(gòu)建Porfile，使得構(gòu)建可根據(jù)我們的指令分發(fā)不同的包。
第3步配置了Maven資源過濾，不僅使得不同Profile下的資源文件互不可見，且替換了資源文件中以“@xx@”表示的屬性值。
第4步使Spring的Profile由Maven決策，這樣，我們就不用每次打包都修改Spring的Profile配置了。
第5步展示了如何執(zhí)行不同Profile下的構(gòu)建命令，并且使用了一個Shell腳本方便我們執(zhí)行構(gòu)建和跳過測試（多數(shù)時候我們在構(gòu)建項目時先測試，并不需要在構(gòu)建時測試，測試和構(gòu)建的解耦使得我們更專注。但同時，如果你忘記了前置測試，也可能會引發(fā)未察覺的測試問題）。

以上就是本文關(guān)于Maven管理SpringBoot Profile詳解的全部內(nèi)容，希望對大家有所幫助。歡迎參閱：maven學(xué)習(xí)-初窺門徑、使用maven運行Java Main的三種方法解析等，有什么問題可以留言，歡迎大家交流討論。

最新評論