Maven系列第9篇:多環境構建,作為核心開發,這個玩不轉有點說不過去!
- 2019 年 11 月 29 日
- 筆記
maven系列目標:從入門開始開始掌握一個高級開發所需要的maven技能。
這是maven系列第9篇。
整個maven系列的內容前後是有依賴的,如果之前沒有接觸過maven,建議從第一篇看起,本文尾部有maven完整系列的連接。
如果你作為公司核心開發,打算使用maven來搭建項目骨架,這篇文章的內容是你必須要掌握的。
平時我們在開發系統的時候,會有開發環境、測試環境、線上環境,每個環境中配置文件可能都是不一樣的,比如:資料庫的配置,靜態資源的配置等等,所以我們希望構建工具能夠適應不同環境的構建工作,能夠靈活處理,並且操作足夠簡單。Maven作為一款優秀的構建工具,這方面做的足夠好了,能夠很好的適應不同環境的構建工作,本文主要講解maven如何靈活的處理各種不同環境的構建工作,廢話不多說,上乾貨。
重點提示
本文中的所有案例均在上一篇的b2b
項目上進行操作,上一篇還沒有看的可以移步過去看一下:Maven系列第8篇:大型Maven項目,快速按需任意構建,必備神技能!相知恨晚!
所有mvn命令均在b2b/pom.xml
所在目錄執行。
Maven屬性
自定義屬性
maven屬性前面我們有用到過,可以自定義一些屬性進行重用,如下:
<properties> <spring.verion>5.2.1.RELEASE</spring.verion> </properties> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${spring.verion}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>${spring.verion}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aop</artifactId> <version>${spring.verion}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${spring.verion}</version> </dependency> </dependencies>
可以看到上面依賴了4個spring相關的構建,他們的版本都是一樣的,在properties
元素中自定義了一個spring.version
屬性,值為spring的版本號,其他幾個地方使用${}
直接進行引用,這種方式好處還是比較明顯的,升級spring版本的時候非常方便,只需要修改一個地方,方便維護。
上面這個是maven自定義屬性,需要先在properties
中定義,然後才可以在其他地方使用${屬性元素名稱}
進行引用。
maven的屬性主要分為2大類,第一類就是上面說的自定義屬性,另外一類是不需要自定義的,可以直接拿來使用的。
2類屬性在pom.xml中都是採用${屬性名稱}
進行引用,maven運行的時候會將${}
替換為屬性實際的值。
下面我們來看一下maven中不需要自定義的5類屬性。
內置屬性
${basedir}:表示項目根目錄,即包含pom.xml文件的目錄 ${version}:表示項目的版本號
POM屬性
用戶可以使用該屬性引用pom.xml文件中對應元素的值,例如${project.artifactId}就可以取到project->artifactId
元素的值,常用的有:
${pom.build.sourceDirectory}:項目的主源碼目錄,默認為src/main/java/ ${project.build.testSourceDirectory}:項目的測試源碼目錄,默認為src/test/java/ ${project.build.directory}:項目構建輸出目錄,默認為target/ ${project.build.outputDirectory}:項目主程式碼編譯輸出目錄,默認為target/classes ${project.build.testOutputDirectory}:項目測試程式碼編譯輸出目錄,默認為target/test-classes ${project.groupId}:項目的groupId ${project.artifactId}:項目的artifactId ${project.version}:項目的version,與${version}等價 ${project.build.finalName}:項目打包輸出文件的名稱,默認為${project.artifactId}-${project.version}
Settings屬性
這種屬性以settings.開頭來引用~/.m2/settings.xml
中的內容,如:
${settings.localRepository}
指向用戶本地倉庫的地址。
java系統屬性
所有java系統屬性都可以使用maven屬性來進行引用,例如${user.home}
指向了當前用戶目錄。
java系統屬性可以通過mvn help:system
命令看到。
環境變數屬性
所有的環境變數都可以使用env.開頭的方式來進行引用,如:
${env.JAVA_HOME}
可以獲取環境變數JAVA_HOME
的值。
用戶可以使用mvn help:system
命令查看所有環境變數的值。
上面的maven屬性,我們在pom.xml
中通過${屬性名稱}
可以靈活的引用,對我們寫pom.xml文件幫助還是比較大的。
實操案例
將下面配置放在b2b-account-service/pom.xml
中:
<properties> <!-- 項目的主源碼目錄,默認為src/main/java/ --> <a>${pom.build.sourceDirectory}</a> <!-- 項目的測試源碼目錄,默認為src/test/java/ --> <b>${project.build.testSourceDirectory}</b> <!-- 項目構建輸出目錄,默認為target/ --> <c>${project.build.directory}</c> <!-- 項目主程式碼編譯輸出目錄,默認為target/classes --> <d>${project.build.outputDirectory}</d> <!-- 項目測試程式碼編譯輸出目錄,默認為target/test-classes --> <e>${project.build.testOutputDirectory}</e> <!-- 項目的groupId --> <f>${project.groupId}</f> <!-- 項目的artifactId --> <g>${project.artifactId}</g> <!-- 項目的version,與${version}等價--> <h>${project.version}</h> <!-- 項目打包輸出文件的名稱,默認為${project.artifactId}-${project.version} --> <i>${project.build.finalName}</i> <!-- setting屬性 --> <!-- 獲取本地倉庫地址--> <a1>${settings.localRepository}</a1> <!-- 系統屬性 --> <!-- 用戶目錄 --> <a2>${user.home}</a2> <!-- 環境變數屬性,獲取環境變數JAVA_HOME的值 --> <a3>${env.JAVA_HOME}</a3> </properties>
然後在b2b/pom.xml
所在目錄執行下面命令:
D:codeIdeaProjectsb2b>mvn help:effective-pom -pl :b2b-account-service > 1.xml
上面這個命令會將mvn ...
執行的結果輸出到b2b/1.xml
目錄,mvn
這段命令有看不懂的朋友,可以去看看前面的文章。
b2b目錄中產生了一個1.xml,如下:

我們打開1.xml看一下,部分內容如下:
<properties> <a>D:codeIdeaProjectsb2bb2b-accountb2b-account-servicesrcmainjava</a> <a1>${settings.localRepository}</a1> <a2>C:UsersThink</a2> <a3>D:installsoftJavajdk1.8.0_121</a3> <b>D:codeIdeaProjectsb2bb2b-accountb2b-account-servicesrctestjava</b> <b2>D:codeIdeaProjectsb2b</b2> <c>D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget</c> <d>D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetclasses</d> <e>D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargettest-classes</e> <f>com.javacode2018</f> <g>b2b-account-service</g> <h>1.0-SNAPSHOT</h> <i>b2b-account-service-1.0-SNAPSHOT</i> </properties>
大家去和上面的pom.xml中的對比一下,感受一下!
多套環境構建問題
b2b-account-service
會操作資料庫,所以我們需要一個配置文件來放資料庫的配置資訊,配置文件一般都放在src/main/resources
中,在這個目錄中新建一個jdbc.properties
文件,內容如下:
jdbc.url=jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8 jdbc.username=root jdbc.password=root
現在系統需要打包,我們運行下面命令
mvn clean package -pl :b2b-account-service
問題來了:
上面jdbc的配置的是開發庫的db資訊,打包之後生成的jar中也是上面開發環境的配置,那麼上測試環境是不是我們需要修改上面的配置,最終上線的時候,上面的配置是不是又得重新修改一次,相當痛苦的。
我們能不能寫3套環境的jdbc配置,打包的時候去指定具體使用那套配置?
還是你們聰明,maven支援這麼做,pom.xml的project
元素下面提供了一個profiles
元素可以用來對多套環境進行配置。
在講profiles的使用之前,需要先了解資源文件打包的過程。
理解資源文件打包過程
我們將src/main/resouces/jdbc.properties
複製一份到src/test/resources
目錄,2個文件如下:

我們先運行一下下面命令:
mvn clean package -pl :b2b-account-service
輸出如下:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent! [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent! [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.572 s [INFO] Finished at: 2019-11-21T17:13:20+08:00 [INFO] ------------------------------------------------------------------------
再去看一下項目的target目錄,如下圖:

下面我們來對這個過程做詳細分析:
從輸出中可以看到有下面幾行:
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent! [INFO] Copying 1 resource
從上面輸出中可以看出,使用了插件maven-resources-plugin的resources目標
,將src/main/resouces
目錄中的資源文件複製到了target/classess
目錄,複製了一個文件,複製過程中使用是GBK
編碼。
還有幾行輸出如下:
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent! [INFO] Copying 1 resource
從上面輸出中可以看出,使用了插件maven-resources-plugin的testResources目標
,將src/main/resouces
目錄中的資源文件複製到了target/classess
目錄,複製了一個文件,複製過程中使用是GBK
編碼。
resources目錄中的文件一般放的都是配置文件,配置文件一般最好我們都不會寫死,所以此處有幾個問題:
- 這個插件複製資源文件如何設置編碼?
- 複製的過程中是否能夠對資源文件進行替換,比如在資源文件中使用一些佔位符,然後複製過程中對這些佔位符進行替換。
maven-resources-plugin
這個插件還真好,他也想到了這個功能,幫我們提供了這樣的功能,下面我們來看看。
設置資源文件複製過程採用的編碼
這個之前有提到過,有好幾種方式,具體可以去前面的文章看一下。這裡只說一種:
<properties> <encoding>UTF-8</encoding> </properties>
設置資源文件內容動態替換
資源文件中可以通過${maven屬性}
來引用maven屬性中的值,打包的過程中這些會被替換掉,替換的過程默認是不開啟的,需要手動開啟配置。
修改src/main/resource/jdbc.properties
內容如下:
jdbc.url=${jdbc.url} jdbc.username=${jdbc.username} jdbc.password=${jdbc.password}
修改src/test/resource/jdbc.properties
內容如下:
jdbc.url=${jdbc.url} jdbc.username=${jdbc.username} jdbc.password=${jdbc.password}
b2b-account-service/pom.xml
中加入下面內容:
<properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> <jdbc.url>jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8</jdbc.url> <jdbc.username>root</jdbc.username> <jdbc.password>root</jdbc.password> </properties>
開啟動態替換配置,需要在pom.xml中加入下面配置:
<build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> </build>
注意上面開啟動態替換的元素是
filtering
。 上面build元素中的resources
和testResources
是用來控制構建過程中資源文件配置資訊的,比資源文件位於哪個目錄,需要複製到那個目錄,是否開啟動態過濾等資訊。resources
元素中可以包含多個resource
,每個resource
表示一個資源的配置資訊,一般使用來控制主資源的複製的。testResources
元素和testResources
類似,是用來控制測試資源複製的。
最終pom.xml內容如下:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-service</artifactId> <version>1.0-SNAPSHOT</version> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> <jdbc.url>jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8</jdbc.url> <jdbc.username>root</jdbc.username> <jdbc.password>root</jdbc.password> </properties> <dependencies> <dependency> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> </build> </project>
運行下面命令看效果:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.798 s [INFO] Finished at: 2019-11-21T17:53:48+08:00 [INFO] ------------------------------------------------------------------------
4個文件截圖看一下效果,如下:

target中的2個資源文件內容被動態替換掉了。
上面會將資源文件中${}
的內容使用maven屬性中的值進行替換,${}
中包含的內容默認會被替換,那麼我們是否可以自定義${}
這個格式,比如我希望被##
包含內容進行替換,這個就涉及到替換中分隔符的指定了,需要設置插件的一些參數。
自定義替換的分隔符
自定義分隔符,需要我們配置maven-resources-plugin
插件的參數,如下:
<plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <configuration> <!-- 是否使用默認的分隔符,默認分隔符是${*}和@ ,這個地方設置為false,表示不啟用默認分隔符配置--> <useDefaultDelimiters>false</useDefaultDelimiters> <!-- 自定義分隔符 --> <delimiters> <delimiter>$*$</delimiter> <delimiter>##</delimiter> </delimiters> </configuration> </plugin> </plugins>
delimiters
中可以配置多個delimiter
,可以配置#*#
,其中的*
表示屬性名稱,那麼資源文件中的#屬性名#
在複製的過程中會被替換掉,*
前後都是#,表示前後分隔符都一樣,那麼可以簡寫為#
,所以#*#
和#
寫法是一樣的,我們去看一下源碼,delimiters的默認值如下:
this.delimiters.add("${*}"); this.delimiters.add("@");
案例
我們將pom.xml修改成下面這樣:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-service</artifactId> <version>1.0-SNAPSHOT</version> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> <jdbc.url>jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8</jdbc.url> <jdbc.username>root</jdbc.username> <jdbc.password>root</jdbc.password> </properties> <dependencies> <dependency> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <configuration> <!-- 是否使用默認的分隔符,默認分隔符是${*}和@ ,這個地方設置為false,表示不啟用默認分隔符配置--> <useDefaultDelimiters>false</useDefaultDelimiters> <!-- 自定義分隔符 --> <delimiters> <delimiter>$*$</delimiter> <delimiter>##</delimiter> </delimiters> </configuration> </plugin> </plugins> </build> </project>
將兩個jdbc.properties修改成下面這樣:
jdbc.url=${jdbc.url} jdbc.username=$jdbc.username$ jdbc.password=##jdbc.password##
再運行一下下面的命令:
mvn clean package -pl :b2b-account-service
看一下target/classes
中的jdbc.properties
文件,變成了下面這樣:
jdbc.url=${jdbc.url} jdbc.username=root jdbc.password=root
可以看到後面兩符合分隔符的要求,被替換了,第一個沒有被替換。
指定需要替換的資源文件
在src/main/resources
中新增一個const.properties
文件,內容如下:
[email protected] jdbc.url=${jdbc.url} jdbc.username=$jdbc.username$ jdbc.password=##jdbc.password##
執行下面命令:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 2 resources [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.667 s [INFO] Finished at: 2019-11-21T18:26:01+08:00 [INFO] ------------------------------------------------------------------------
看一下target/classes
中,如下圖:

target/classes/const.properties
內容變成下面這樣了:
[email protected] jdbc.url=${jdbc.url} jdbc.username=root jdbc.password=root
說明const.properteis
也被替換了。2個資源文件都被複制到了target中,如果我們不想讓cont.properties
被複制到target/classes
目錄,我們怎麼做?我們需要在資源構建的過程中排除他,可以使用exclude
元素資訊進行排除操作。
修改pom.xml中resources
元素配置如下:
<resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> <includes> <include>**/jdbc.properties</include> </includes> <excludes> <exclude>**/const.properties</exclude> </excludes> </resource> </resources>
上面使用
includes
列出需要被處理的,使用excludes
排除需要被處理的資源文件列表,採用通配符的寫法,**匹配任意深度的文件路徑,*匹配任意個字元。
再執行下面命令:
mvn clean package -pl :b2b-account-service
再看一下target/classes
中,如下:

const.properties
被排除了,確實沒有被複制過來。
如果此時我想讓const.propertis
只是被複制到target下面,但是不要去替換裡面的內容,該怎麼做呢?此時需要配置多個resouce
元素了,如下案例。
多個resource元素的使用案例
修改pom.xml中resources
,如下:
<resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> <includes> <include>**/jdbc.properties</include> </includes> </resource> <resource> <directory>${project.basedir}/src/main/resources</directory> <includes> <include>**/const.properties</include> </includes> </resource> </resources>
現在pom.xml內容如下:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-service</artifactId> <version>1.0-SNAPSHOT</version> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> <jdbc.url>jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8</jdbc.url> <jdbc.username>root</jdbc.username> <jdbc.password>root</jdbc.password> </properties> <dependencies> <dependency> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> <includes> <include>**/jdbc.properties</include> </includes> </resource> <resource> <directory>${project.basedir}/src/main/resources</directory> <includes> <include>**/const.properties</include> </includes> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <configuration> <!-- 是否使用默認的分隔符,默認分隔符是${*}和@ ,這個地方設置為false,表示不啟用默認分隔符配置--> <useDefaultDelimiters>false</useDefaultDelimiters> <!-- 自定義分隔符 --> <delimiters> <delimiter>$*$</delimiter> <delimiter>##</delimiter> </delimiters> </configuration> </plugin> </plugins> </build> </project>
執行命令看效果:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 2.116 s [INFO] Finished at: 2019-11-21T18:38:59+08:00 [INFO] ------------------------------------------------------------------------
上面有如下輸出:
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] Copying 1 resource
插件處理了2個資源文件。
我們看一下target/classes
目錄下兩個文件的內容。
jdbc.proerties:
jdbc.url=${jdbc.url} jdbc.username=root jdbc.password=root
const.properties:
[email protected] jdbc.url=${jdbc.url} jdbc.username=$jdbc.username$ jdbc.password=##jdbc.password##
2個資源都被複制到target/classes目錄了,只有jdbc.properties
中的內容被替換了。
關於資源文件處理的,更詳細的過程可以去看這個插件的源碼,下面我們來說多環境處理的問題。
使用profiles處理多環境構建問題
maven支援讓我們配置多套環境,每套環境中可以指定自己的maven屬性,mvn命令對模組進行構建的時候可以通過-P
參數來指定具體使用哪個環境的配置,具體向下看。
profiles元素支援定義多套環境的配置資訊,配置如下用法:
<profiles> <profile>測試環境配置資訊</profile> <profile>開發環境配置資訊</profile> <profile>線上環境配置資訊</profile> <profile>環境n配置資訊</profile> </profiles>
profiles中包含多個profile元素,每個profile可以表示一套環境,profile示例如下:
<profile> <id>dev</id> <properties> <jdbc.url>dev jdbc url</jdbc.url> <jdbc.username>dev jdbc username</jdbc.username> <jdbc.password>dev jdbc password</jdbc.password> </properties> </profile>
id:表示這套環境的標識資訊,properties可以定義環境中使用到的屬性列表。 執行mvn命令編譯的時候可以帶上一個
-P profileid
來使用指定的環境進行構建。
指定環境進行構建
在b2b-account-service/pom.xml
加入下面配置:
<profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <properties> <jdbc.url>dev jdbc url</jdbc.url> <jdbc.username>dev jdbc username</jdbc.username> <jdbc.password>dev jdbc password</jdbc.password> </properties> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <properties> <jdbc.url>test jdbc url</jdbc.url> <jdbc.username>test jdbc username</jdbc.username> <jdbc.password>test jdbc password</jdbc.password> </properties> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <properties> <jdbc.url>test jdbc url</jdbc.url> <jdbc.username>test jdbc username</jdbc.username> <jdbc.password>test jdbc password</jdbc.password> </properties> </profile> </profiles>
將pom.xml的project->properties
中的下面幾個元素幹掉,這些和profile中的重複了,需要幹掉:
<jdbc.url>jdbc:mysql://localhost:3306/javacode2018?characterEncoding=UTF-8</jdbc.url> <jdbc.username>root</jdbc.username> <jdbc.password>root</jdbc.password>
此時pom.xml內容如下,建議大家直接貼進去:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-service</artifactId> <version>1.0-SNAPSHOT</version> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> </properties> <!-- 配置多套環境 --> <profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <properties> <jdbc.url>dev jdbc url</jdbc.url> <jdbc.username>dev jdbc username</jdbc.username> <jdbc.password>dev jdbc password</jdbc.password> </properties> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <properties> <jdbc.url>test jdbc url</jdbc.url> <jdbc.username>test jdbc username</jdbc.username> <jdbc.password>test jdbc password</jdbc.password> </properties> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <properties> <jdbc.url>prod jdbc url</jdbc.url> <jdbc.username>prod jdbc username</jdbc.username> <jdbc.password>prod jdbc password</jdbc.password> </properties> </profile> </profiles> <dependencies> <dependency> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> <includes> <include>**/jdbc.properties</include> </includes> </resource> <resource> <directory>${project.basedir}/src/main/resources</directory> <includes> <include>**/const.properties</include> </includes> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <configuration> <!-- 是否使用默認的分隔符,默認分隔符是${*}和@ ,這個地方設置為false,表示不啟用默認分隔符配置--> <useDefaultDelimiters>false</useDefaultDelimiters> <!-- 自定義分隔符 --> <delimiters> <delimiter>$*$</delimiter> <delimiter>##</delimiter> </delimiters> </configuration> </plugin> </plugins> </build> </project>
修改src/main/resource/jdbc.properties
內容如下:
jdbc.url=$jdbc.url$ jdbc.username=$jdbc.username$ jdbc.password=##jdbc.password##
運行下面的構建命令:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service -Pdev [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 2.361 s [INFO] Finished at: 2019-11-21T18:51:16+08:00 [INFO] ------------------------------------------------------------------------
注意上面命令中多了一個
-Pdev
參數,-P後面跟的是pom.xml中profile的id
,表示需要使用那套環境進行構建。此時我們使用的是dev
環境,即開發環境。
看一下target/classes/jdbc.properties
,內容變成了下面這樣:
jdbc.url=dev jdbc url jdbc.username=dev jdbc username jdbc.password=dev jdbc password
上面文件的內容和pom.xml中dev的profile中的properties對比一下,內容是不是一樣的,說明資源文件中內容被替換為了dev環境的配置,我們再來試試test
環境,執行下面命令:
mvn clean package -pl :b2b-account-service -Ptest
看一下target/classes/jdbc.properties
,內容變成了下面這樣:
jdbc.url=test jdbc url jdbc.username=test jdbc username jdbc.password=test jdbc password
看到了么,神奇的效果出現了,test環境起效了。
開啟默認環境配置
我們在執行下面命令:
mvn clean package -pl :b2b-account-service
看一下target/classes/jdbc.properties
,內容變成了下面這樣:
jdbc.url=$jdbc.url$ jdbc.username=$jdbc.username$ jdbc.password=##jdbc.password##
內容沒有被替換,因為我們沒有通過-P來指定具體使用哪個環境進行構建,所以出現了這種現象。
但是我們可以指定一個默認開啟的配置,我們默認開啟dev的配置,修改dev的profile元素,在這個元素下面加上:
<activation> <activeByDefault>true</activeByDefault> </activation>
activeByDefault表示默認開啟這個環境的配置,默認值是false,這個地方我們設置為true,表示開啟默認配置。
此時dev的配置如下:
<profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> </activation> <properties> <jdbc.url>dev jdbc url</jdbc.url> <jdbc.username>dev jdbc username</jdbc.username> <jdbc.password>dev jdbc password</jdbc.password> </properties> </profile>
執行下面命令:
mvn clean package -pl :b2b-account-service
看一下target/classes/jdbc.properties
,內容變成了下面這樣:
jdbc.url=dev jdbc url jdbc.username=dev jdbc username jdbc.password=dev jdbc password
這次我們沒有指定環境,默認使用了dev環境。
通過maven屬性來控制環境的開啟
剛才上面說了通過-P profileId的方式來指定環境,現在我們想通過自定義的屬性值來控制使用哪個環境。
可以在profile元素中加入下面配置
<activation> <property> <name>屬性xx</name> <value>屬性xx的值</value> </property> </activation>
那麼我們可以在mvn後面跟上下面的命令可以開啟匹配的環境:
mvn ... -D屬性xx=屬性xx的值
-D可以通過命令行指定一些屬性的值,這個前面有講過,-D後面的屬性會和activation->properties中的name、value進行匹配,匹配成功的環境都會被開啟。
將pom.xml中profiles
元素修改成下面這樣:
<!-- 配置多套環境 --> <profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> <property> <name>env</name> <value>env_dev</value> </property> </activation> <properties> <jdbc.url>dev jdbc url</jdbc.url> <jdbc.username>dev jdbc username</jdbc.username> <jdbc.password>dev jdbc password</jdbc.password> </properties> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <activation> <property> <name>env</name> <value>env_test</value> </property> </activation> <properties> <jdbc.url>test jdbc url</jdbc.url> <jdbc.username>test jdbc username</jdbc.username> <jdbc.password>test jdbc password</jdbc.password> </properties> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <activation> <property> <name>env</name> <value>env_prod</value> </property> </activation> <properties> <jdbc.url>prod jdbc url</jdbc.url> <jdbc.username>prod jdbc username</jdbc.username> <jdbc.password>prod jdbc password</jdbc.password> </properties> </profile> </profiles>
運行命令:
mvn clean package -pl :b2b-account-service -Denv=env_prod
target/classes/jdbc.properties
內容如下:
jdbc.url=prod jdbc url jdbc.username=prod jdbc username jdbc.password=prod jdbc password
說明使用到了prod環境的配置。
啟動的時候指定多個環境
可以在-P
參數後跟多個環境的id,多個之間用逗號隔開,當使用多套環境的時候,多套環境中的maven屬性會進行合併,如果多套環境中屬性有一樣的,後面的會覆蓋前面的。
運行下面命令看效果:
mvn clean package -pl :b2b-account-service -Pdev,test,prod
修改pom.xml中的profiles元素,如下:
<!-- 配置多套環境 --> <profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> <property> <name>env</name> <value>env_dev</value> </property> </activation> <properties> <jdbc.url>dev jdbc url</jdbc.url> </properties> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <activation> <property> <name>env</name> <value>env_test</value> </property> </activation> <properties> <jdbc.username>test jdbc username</jdbc.username> </properties> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <activation> <property> <name>env</name> <value>env_prod</value> </property> </activation> <properties> <jdbc.password>prod jdbc password</jdbc.password> </properties> </profile> </profiles>
注意看一下上面3個環境中都只有一個自定義屬性了
下面我們同時使用3個環境,執行下面命令:
mvn clean package -pl :b2b-account-service -Pdev,test,prod
target中的jdbc.properties文件變成了這樣:
jdbc.url=dev jdbc url jdbc.username=test jdbc username jdbc.password=prod jdbc password
查看目前有哪些環境
命令:
mvn help:all-profiles
案例:
D:codeIdeaProjectsb2b>mvn help:all-profiles -pl :b2b-account-service [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-help-plugin:3.2.0:all-profiles (default-cli) @ b2b-account-service --- [INFO] Listing Profiles for Project: com.javacode2018:b2b-account-service:jar:1.0-SNAPSHOT Profile Id: dev (Active: true , Source: pom) Profile Id: prod (Active: false , Source: pom) Profile Id: test (Active: false , Source: pom) [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.527 s [INFO] Finished at: 2019-11-21T19:16:34+08:00 [INFO] ------------------------------------------------------------------------
從輸出中可以看到有3個環境,他們的id,默認激活的是那個等資訊。
查看目前激活的是哪些環境
命令:
mvn help:active-profiles
案例:
D:codeIdeaProjectsb2b>mvn help:active-profiles -pl :b2b-account-service -Ptest,prod [INFO] Scanning for projects... [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-help-plugin:3.2.0:active-profiles (default-cli) @ b2b-account-service --- [INFO] Active Profiles for Project 'com.javacode2018:b2b-account-service:jar:1.0-SNAPSHOT': The following profiles are active: - test (source: com.javacode2018:b2b-account-service:1.0-SNAPSHOT) - prod (source: com.javacode2018:b2b-account-service:1.0-SNAPSHOT) [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.387 s [INFO] Finished at: 2019-11-21T19:25:56+08:00 [INFO] ------------------------------------------------------------------------
從輸出中可以看到啟用了2套環境,分別是test
和prod
。
新問題:配置太分散了
我們的系統中有2個模組需要用到資料庫的配置,這兩個模組是:
b2b-account-service b2b-order-service
上面我們介紹了b2b-account-service
不同環境的構建操作,是在pom.xml
中進行配置的,b2b-order-service
中數據的配置也可以這麼做,如果以後有更多的模組都需要連接不同的資料庫,是不是每個模組中都需要配置這樣的pom.xml
,那時候資料庫的配置分散在幾十個pom.xml
文件中,如果運維需要修改資料庫的配置的時候,需要去每個模組中去修改pom.xml
中的屬性,這種操作會讓人瘋掉的,我們可以怎麼做?
我們可以將資料庫所有的配置放在一個文件中,運維只用修改這一個文件就行了,然後執行構件操作,重新發布上線,就ok了。
maven支援我們這麼做,可以在profile中指定一個外部屬性文件xx.properties
,文件內容是這種格式的:
key1=value1 key2=value2 keyn=value2
然後在profile元素中加入下面配置:
<build> <filters> <filter>xx.properties文件路徑(相對路徑或者完整路徑)</filter> </filters> </build>
上面的filter
元素可以指定多個,當有多個外部屬性配置文件的時候,可以指定多個來進行引用。
然後資源文件複製的時候就可以使用下面的方式引用外部資源文件的內容:
xxx=${key1}
案例
新建文件b2b/config/dev.properties
,內容如下:
# b2b-account-service jdbc配置資訊 b2b-account-service.jdbc.url=dev_account_jdbc_url b2b-account-service.jdbc.username=dev_account_jdbc_username b2b-account-service.jdbc.password=dev_account_jdbc_password # b2b-order-service jdbc配置資訊 b2b-order-service.jdbc.url=dev_order_jdbc_url b2b-order-service.jdbc.username=dev_order_jdbc_username b2b-order-service.jdbc.password=dev_order_jdbc_password
新建文件b2b/config/test.properties
,內容如下:
# b2b-account-service jdbc配置資訊 b2b-account-service.jdbc.url=test_account_jdbc_url b2b-account-service.jdbc.username=test_account_jdbc_username b2b-account-service.jdbc.password=test_account_jdbc_password # b2b-order-service jdbc配置資訊 b2b-order-service.jdbc.url=test_order_jdbc_url b2b-order-service.jdbc.username=test_order_jdbc_username b2b-order-service.jdbc.password=test_order_jdbc_password
新建文件b2b/config/prod.properties
,內容如下:
# b2b-account-service jdbc配置資訊 b2b-account-service.jdbc.url=prod_account_jdbc_url b2b-account-service.jdbc.username=prod_account_jdbc_username b2b-account-service.jdbc.password=prod_account_jdbc_password # b2b-order-service jdbc配置資訊 b2b-order-service.jdbc.url=prod_order_jdbc_url b2b-order-service.jdbc.username=prod_order_jdbc_username b2b-order-service.jdbc.password=prod_order_jdbc_password
b2b-account-service/src/main/resource/jdbc.properties
文件內容:
jdbc.url=${b2b-account-service.jdbc.url} jdbc.username=${b2b-account-service.jdbc.username} jdbc.password=${b2b-account-service.jdbc.password}
看到了沒,這裡面
${}
中的屬性名稱取的是上面b2b/config
目錄中資源文件中的屬性名稱。
b2b-order-service/src/main/resource/jdbc.properties
文件內容:
jdbc.url=${b2b-order-service.jdbc.url} jdbc.username=${b2b-order-service.jdbc.username} jdbc.password=${b2b-order-service.jdbc.password}
b2b-account/pom.xml
內容如下:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-service</artifactId> <version>1.0-SNAPSHOT</version> <dependencies> <dependency> <groupId>com.javacode2018</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> </properties> <!-- 配置多套環境 --> <profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> <property> <name>env</name> <value>env_dev</value> </property> </activation> <build> <filters> <filter>../../config/dev.properties</filter> </filters> </build> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <activation> <property> <name>env</name> <value>env_test</value> </property> </activation> <build> <filters> <filter>../../config/test.properties</filter> </filters> </build> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <activation> <property> <name>env</name> <value>env_prod</value> </property> </activation> <build> <filters> <filter>../../config/prod.properties</filter> </filters> </build> </profile> </profiles> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> </build> </project>
b2b-order/pom.xml
內容如下:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.javacode2018</groupId> <artifactId>b2b-order-service</artifactId> <version>1.0-SNAPSHOT</version> <dependencies> <dependency> <groupId>${project.groupId}</groupId> <artifactId>b2b-account-api</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>${project.groupId}</groupId> <artifactId>b2b-order-api</artifactId> <version>${project.version}</version> </dependency> </dependencies> <properties> <!-- 指定資源文件複製過程中採用的編碼方式 --> <encoding>UTF-8</encoding> </properties> <!-- 配置多套環境 --> <profiles> <!-- 開發環境使用的配置 --> <profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> <property> <name>env</name> <value>env_dev</value> </property> </activation> <build> <filters> <filter>../../config/dev.properties</filter> </filters> </build> </profile> <!-- 測試環境使用的配置 --> <profile> <id>test</id> <activation> <property> <name>env</name> <value>env_test</value> </property> </activation> <build> <filters> <filter>../../config/test.properties</filter> </filters> </build> </profile> <!-- 線上環境使用的配置 --> <profile> <id>prod</id> <activation> <property> <name>env</name> <value>env_prod</value> </property> </activation> <build> <filters> <filter>../../config/prod.properties</filter> </filters> </build> </profile> </profiles> <build> <resources> <resource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/main/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </resource> </resources> <testResources> <testResource> <!-- 指定資源文件的目錄 --> <directory>${project.basedir}/src/test/resources</directory> <!-- 是否開啟過濾替換配置,默認是不開啟的 --> <filtering>true</filtering> </testResource> </testResources> </build> </project>
見證奇蹟的時刻來了。
執行下面命令:
D:codeIdeaProjectsb2b>mvn clean package -pl :b2b-account-service,:b2b-order-service -Pdev [INFO] Scanning for projects... [INFO] ------------------------------------------------------------------------ [INFO] Reactor Build Order: [INFO] [INFO] b2b-account-service [jar] [INFO] b2b-order-service [jar] [INFO] [INFO] ----------------< com.javacode2018:b2b-account-service >---------------- [INFO] Building b2b-account-service 1.0-SNAPSHOT [1/2] [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-account-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-account-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-account-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-account-service --- [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-account-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-accountb2b-account-servicetargetb2b-account-service-1.0-SNAPSHOT.jar [INFO] [INFO] -----------------< com.javacode2018:b2b-order-service >----------------- [INFO] Building b2b-order-service 1.0-SNAPSHOT [2/2] [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ b2b-order-service --- [INFO] Deleting D:codeIdeaProjectsb2bb2b-orderb2b-order-servicetarget [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ b2b-order-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ b2b-order-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ b2b-order-service --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] skip non existing resourceDirectory D:codeIdeaProjectsb2bb2b-orderb2b-order-servicesrctestresources [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ b2b-order-service --- [INFO] Nothing to compile - all classes are up to date [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ b2b-order-service --- [INFO] No tests to run. [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ b2b-order-service --- [INFO] Building jar: D:codeIdeaProjectsb2bb2b-orderb2b-order-servicetargetb2b-order-service-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary for b2b-account-service 1.0-SNAPSHOT: [INFO] [INFO] b2b-account-service ................................ SUCCESS [ 2.510 s] [INFO] b2b-order-service .................................. SUCCESS [ 0.257 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 3.026 s [INFO] Finished at: 2019-11-21T20:11:32+08:00 [INFO] ------------------------------------------------------------------------
看一下兩個模組target/classes下面jdbc.properties內容,如下圖:

使用了dev環境的配置,dev環境中處理資源文件替換的時候採用了config/dev.properties
文件的內容,這部分配置如下,重點在於build->filters元素
:
<profile> <id>dev</id> <activation> <activeByDefault>true</activeByDefault> <property> <name>env</name> <value>env_dev</value> </property> </activation> <build> <filters> <filter>../../config/dev.properties</filter> </filters> </build> </profile>
我們再使用prod環境看一下效果,執行下面命令:
mvn clean package -pl :b2b-account-service,:b2b-order-service -Pprod
效果圖如下:

感受一下,這次使用了b2b/config/prod.properties
文件的內容對資源文件進行了替換,這次將所有配置的資訊集中在config目錄的幾個文件中進行處理了,對於運維和開發來說都非常方便了。
profile元素更強大的功能
profile元素可以用於對不同環境的構建進行配置,project中包含的元素,在profile元素中基本上都有,所以profile可以訂製更複雜的構建過程,不同的環境依賴的構件、插件、build過程、測試過程都是不一樣的,這些都可以在profile中進行指定,也就是說不同的環境所有的東西都可以通過profile元素來進行個性化的設置,這部分的功能有興趣的大家可以自己去研究一下,截個圖大家感受一下:

從上圖中可以看出這些屬性都可以根據環境進行訂製的。
還是那句話,上面這些用法大家會經常用到的,建議大家下去了多練練。看和操作,所獲取到的是不能比的,看的過程中可能覺得一切都知道了,但是實際操作就不一樣了,可能中間會遇到各種問題,然後自己會想辦法解決這些問題,領會和學到的東西是不一樣的!
Maven系列目錄
- Maven系列:第1篇:Maven未出世前,我們那些痛苦的經歷!
- Maven系列第2篇:安裝、配置、mvn運行過程詳解
- Maven系列第3篇:詳解maven解決依賴問題
- Maven系列第4篇:倉庫詳解
- Maven系列第5篇:私服詳解
- Maven系列第6篇:生命周期和插件詳解,高手必備!
- Maven系列第7篇:聚合、繼承、單繼承問題詳解,必備技能!
- Maven系列第8篇:大型Maven項目,快速按需任意構建,必備神技能!