maven profile自動切換環(huán)境參數的2種方法詳解
前言
痛點:
在java開發(fā)的過程中,我們經常要面對各種各樣的環(huán)境,比如開發(fā)環(huán)境,測試環(huán)境,正式環(huán)境,而這些環(huán)境對項目的需求也不相同。
在此之前,我們往往需要手動去修改相對應的配置文件然后打成war,才能部署到相應的環(huán)境上。
但是這樣很容易出現問題,因為很容易出現少改或者漏改,造成不必要的麻煩
幻想:
要是有一種東西,能讓我們打war的時候指定一個參數,就能自動把項目編譯成對應環(huán)境的war,那該有多幸福?。。。?/p>
結果:這樣的東西還真有,那就是maven-profile
在開發(fā)過程中,我們經常會根據不同的環(huán)境配置不同的參數,如數據源的ip,username,password、url、秘鑰等都會不同,傳統(tǒng)方式是在一個配置文件中通過修改properties文件中的參數值或者通過注釋解注釋來達到目的,這樣不僅容易出錯,還浪費不必要的時間,更重要的是把代碼發(fā)布到測試環(huán)境或者生產環(huán)境還容易忘記改。為解決這種問題,maven提供了一種解決方案,就是profile。
下圖為傳統(tǒng)方式,需要來回的注釋和解注釋

profile定義的位置
- 針對于特定項目的profile配置我們可以定義在該項目的pom.xml中。
- 針對于特定用戶的profile配置,我們可以在用戶的settings.xml文件中定義profile。該文件在用戶家目錄下的“.m2”目錄下。
- 全局的profile配置。全局的profile是定義在Maven安裝目錄下的“conf/settings.xml”文件中的。
filter方式實現
第一步:分別定義application-dev.properties、application-test.properties、application-pro.properties三個文件
application-dev.properties
env.jdbc.username=dev env.jdbc.password=123456
application-test.properties
env.jdbc.username=test env.jdbc.password=888888
application-pro.properties
env.jdbc.username=root env.jdbc.password=666666
第二步:定義總的屬性文件application.properties,該文件中的值去引用application-<env>.properties中的key
application.properties
// 引用application-<env>中的key
jdbc.username=${env.jdbc.username}
jdbc.password=${env.jdbc.password}
# 公共配置
salt=123456789
第三步:配置profile
<profiles> <profile> <!-- 開發(fā)環(huán)境 --> <id>dev</id> <properties> <env>dev</env> </properties> <activation> <!-- 設置默認激活這個配置 --> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <!-- 測試環(huán)境 --> <id>test</id> <properties> <env>test</env> </properties> </profile> <profile> <!-- 發(fā)布環(huán)境 --> <id>pro</id> <properties> <env>pro</env> </properties> </profile> </profiles>
第四步:配置filter和resource
${env}就是在mvn package -P <env>的名字,這樣就告訴application.properties中應用的key是那個屬性文件的key了
<build>
<finalName>profile-app</finalName>
<!-- 定義了變量配置文件的地址 -->
<filters>
<filter>src/main/resources/config/application/application-${env}.properties</filter>
</filters>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
</plugin>
</plugins>
</build>
打包運行
// 如果不指定環(huán)境,默認是activeByDefault=true的環(huán)境,當前是指開發(fā)環(huán)境 mvn package // 打包指定的環(huán)境通過-P 參數,注意p是大寫的 mvn package -P <env>

從mvn packege -P test運行的結果中可以看到生成的target目錄下classes/application.perperties中的jdbc.username和jdbc.password 就是application-test.properties中配置的env.jdbc.username和env.jdbc.password的值。
在spring中如果要使用屬性配置文件,直接引入這個總的配置文件即可,其他的環(huán)境配置文件的使命已經結束了。
<context:property-placeholder location="classpath:application.properties"/>
實現原理:
在pom.xml中為每個不同的環(huán)境定義不同的profile,每個profile都有一個環(huán)境名稱,然后為不同環(huán)境定義不同的配置文件(如application-<env>.properties), 再定義一個總的屬性文件(如application.properties), 然后讓application.properties的value去引用application-<env>.properties中對應的key,在打包時指定要打包的環(huán)境的名稱即可,這樣application.properties中的key的值就是相對應環(huán)境application-<env>.properties對應的值了。
多resource實現方式
步驟
第一步:在src/main/resource創(chuàng)建一個env目錄,再創(chuàng)建各個環(huán)境的子目錄,再再各個環(huán)境子目錄下創(chuàng)建名為config.properties的文件,每個鍵相同,值不同。
env/dev/config.properties
jdbc.username=dev jdbc.password=123456
env/test/config.properties
jdbc.username=test jdbc.password=888888
env/pro/config.properties
jdbc.username=root jdbc.password=666666
第二步:創(chuàng)建一個與環(huán)境無關的application.properties
application.properties
# 公共配置 salt=123456789
第三步:配置profiles
<profiles> <profile> <!-- 開發(fā)環(huán)境 --> <id>dev</id> <properties> <env>dev</env> </properties> <activation> <!-- 設置默認激活這個配置 --> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <!-- 測試環(huán)境 --> <id>test</id> <properties> <env>test</env> </properties> </profile> <profile> <!-- 發(fā)布環(huán)境 --> <id>pro</id> <properties> <env>pro</env> </properties> </profile> </profiles>
第四步:配置resource
<build>
<finalName>profile-app</finalName>
<!-- 定義了變量配置文件的地址 -->
<resources>
<resource>
<directory>src/main/resources</directory>
<excludes>
<exclude>env/dev/*</exclude>
<exclude>env/test/*</exclude>
<exclude>env/pro/*</exclude>
</excludes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/resources/env/${env}</directory>
<includes>
<include>*.*</include>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
</plugin>
</plugins>
</build>
第五步:運行 mvn package -P test

如果經常使用mvn package -P <env>可以在idea中配置一些maven, 步驟為:Edit Configurations… —– + —- Maven —- 分別為每個環(huán)境添加maven 命令,以后雙擊Run Configureations中的任意一個就是相當于運行mvn package -P <env>命令了


兩種方式比較
filter方式會把所有的application-dev.properties、application-test.properties、application-pro.properties文件都會打包進去,而且此種方式只能針對屬性文件,如果有其他文件(如.xml)也根據不同的環(huán)境有不同的配置,這種方式是不好處理。
多resource方式在打包時只打包指定環(huán)境的配置文件,可以將各種文件放到各自的環(huán)境文件夾中,在打包的時候會將整個文件夾都打包進去。推薦此種方式
總結
以上就是這篇文章的全部內容了,希望本文的內容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對腳本之家的支持。
- 使用maven profile指定配置文件打包適用多環(huán)境的方法
- Maven管理SpringBoot Profile詳解
- 詳解Maven profile配置管理及激活profile的幾種方式
- maven的pom.xml中profiles的作用詳解
- maven多profile 打包下 -P參和-D參數的實現
- Maven 多profile及指定編譯問題的解決
- 詳解maven中profiles使用實現
- maven profile實現多環(huán)境配置的示例
- maven profile動態(tài)選擇配置文件詳解
- Maven profile實現不同環(huán)境的配置管理實踐
- maven中profile的使用
相關文章
解決springboot?部署到?weblogic?中?jar?包沖突的問題
這篇文章主要介紹了springboot?部署到?weblogic?中?jar?包沖突,weblogic?也有是解決方案的,可以通過新增并配置?weblogic.xml?文件來定義哪些類需要優(yōu)先從項目工程包的?jar?包中加載,本文給大家分享解決方法,需要的朋友可以參考下2022-08-08
Spring應用中使用acutator/refresh刷新屬性不生效的問題分析及解決
在Spring應用收到/actuator/refresh的POST請求后,標注了@RefreshScope以及@ConfiguratioinProperties的bean會被Spring容器重新加載,但是,在實際應用中,并沒有按照預期被Spring容器加載,本文將討論導致這種未按預期刷新的一種原因,感興趣的朋友可以參考下2024-01-01
VSCode新手教程之配置Java環(huán)境的詳細教程
這篇文章主要給大家介紹了關于VSCode新手教程之配置Java環(huán)境的詳細教程,工欲善其事必先利其器,想要工作順利我們先搭建好JAVA的開發(fā)環(huán)境,需要的朋友可以參考下2023-10-10
Java程序員的10道常見的XML面試問答題(XML術語詳解)
包括web開發(fā)人員的Java面試在內的各種面試中,XML面試題在各種編程工作的面試中很常見。XML是一種成熟的技術,經常作為從一個平臺到其他平臺傳輸數據的標準2014-04-04

