首先, 鄭重的吐槽下度娘, 能找到的資料, 都是說(shuō)針對(duì)打包tar.gz的, 找了好一會(huì)兒, 才找到針對(duì)war包.
開(kāi)始并不順利, 因?yàn)樵诟缸幽K的場(chǎng)景下, 有war,有jar. 最后發(fā)現(xiàn)打包的lib里包含war包. 這樣不是重復(fù)打包嗎, 而且, 并不能打成標(biāo)準(zhǔn)war包結(jié)構(gòu).

好啦, 現(xiàn)在上正解.

工程結(jié)構(gòu):

parent          //pom
    | common   //jar
    | dao      //jar
    | web      //war

針對(duì)中這種結(jié)構(gòu)的工程, 網(wǎng)上的tar.gz的做法并不適用. 主要是: 1)會(huì)將web模塊的war包打進(jìn)lib文件中; 2)目錄結(jié)構(gòu)不是war包應(yīng)有的結(jié)構(gòu). 前者是因?yàn)閙aven自帶的編譯打包工具會(huì)先執(zhí)行打包操作, 這樣輪到assembly打包時(shí)會(huì)將打好的war包打進(jìn)lib文件夾中.

針對(duì)上文的工程結(jié)構(gòu), 需要:

1. parentpom中統(tǒng)一配置自帶的編譯插件. 主要是指定編譯的jdk版本.(否則默認(rèn)會(huì)使用1.5的. 不會(huì)的需要補(bǔ)充學(xué)習(xí)下).
2. jar模塊如果需要分環(huán)境打包配置文件, 則不需要任何多余的配置, 使用的默認(rèn)的jar打包即可.
3. web模塊是重點(diǎn). 下文的配置都是針對(duì)web的配置. 通常web工程更多的需要分環(huán)境打包配置文件.

web配置文件結(jié)構(gòu)

1527171764196.png

我這里的思路是: resources下可以放置每個(gè)環(huán)境都需要的公共配置文件. 分環(huán)境的放在./src/main/assembly/下.

1 web模塊的pom.xml中的profiles配置

<profiles>
        <!--profile1: 開(kāi)發(fā)環(huán)境 dev-->
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
                <property>
                    <name>env</name>
                    <value>dev</value>
                </property>
            </activation>

            <!--定制鍵值對(duì)環(huán)境變量
            !重要: 這里才是將env=dev的變量傳入下面的assembly.xml中, 用于給${env}賦值, 上面的
<property>下面的那name,value并沒(méi)有什么亂用, 我也不知道別人為什么用這個(gè)!-->
            <properties>
                <env>dev</env>
            </properties>

            <build>
                <plugins>
                    <plugin>
                        <artifactId>maven-assembly-plugin</artifactId>
                        <configuration>
                            <!-- maven assembly插件需要一個(gè)描述文件 來(lái)告訴插件包的結(jié)構(gòu)以及打包所需的文件來(lái)自哪里 -->
                            <descriptors>
                                <descriptor>${basedir}/src/main/assembly/assembly.xml</descriptor>
                            </descriptors>
                            <finalName>${project.artifactId}-${project.version}</finalName>
                            <outputDirectory>${project.build.directory}</outputDirectory>
                        </configuration>
                    </plugin>
                </plugins>
            </build>

        </profile>
        <!--profile2: 測(cè)試環(huán)境 test-->
        <profile>
            <id>test</id>
            <activation>
                <property>
                    <name>env</name>
                    <value>test</value>
                </property>
            </activation>

            <properties>
                <env>test</env>
            </properties>

            <build>
                <plugins>
                    <plugin>
                        <artifactId>maven-assembly-plugin</artifactId>
                        <configuration>
                            <!-- 發(fā)布模式使用的maven assembly插件描述文件 -->
                            <descriptors>
                                <descriptor>${basedir}/src/main/assembly/assembly.xml</descriptor>
                            </descriptors>
                            <!-- 如果一個(gè)應(yīng)用的包含多個(gè)deploy模塊，如果使用同樣的包名， 如果把它們復(fù)制的一個(gè)目錄中可能會(huì)失敗，所以包名加了 artifactId以示區(qū)分 -->
                            <finalName>${project.artifactId}-${project.version}</finalName>
                            <!-- scm 要求 release 模式打出的包放到頂級(jí)目錄下的target子目錄中 -->
                            <outputDirectory>${project.build.directory}</outputDirectory>
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>

    <!--prod環(huán)境略-->

2 web模塊的pom.xml中引入assembly插件

<build>
        <plugins>
            <!-- deploy模塊的packaging通常是jar，如果項(xiàng)目中沒(méi)有java 源代碼或資源文件，加上這一段配置使項(xiàng)目能通過(guò)構(gòu)建 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>2.5</version>
                <configuration>
                    <archive>
                        <addMavenDescriptor>true</addMavenDescriptor>
                    </archive>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <!-- 這是最新版本，推薦使用這個(gè)版本 -->
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>assemble</id>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <!--綁定package生命周期-->
                        <phase>package</phase>
                    </execution>
                </executions>
                <configuration>
                    <appendAssemblyId>false</appendAssemblyId> <!-- 設(shè)為 FALSE, 防止 WAR 包名加入 assembly.xml 中的 ID -->
                    <attach>false</attach>
                </configuration>
            </plugin>
        </plugins>
    </build>

3 配置定制assembly.xml

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">
    <id>web</id>
    <formats>
        <format>war</format>
        <!--生成同結(jié)構(gòu)的目錄, 方便查看, 可選-->
        <format>dir</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <!--打war包的文件配置-->
    <fileSets>
        <fileSet>
            <directory>${project.build.outputDirectory}</directory>
            <outputDirectory>WEB-INF/classes</outputDirectory>
        </fileSet>
        <!--分環(huán)境打包配置文件-->
        <!-- ${env} 的值由 -P 的參數(shù)傳遞進(jìn)來(lái), 如：-Pdev, 那么, ${env} 的值就是 dev -->
        <fileSet>
            <directory>${project.basedir}/src/main/assembly/${env}</directory>
            <outputDirectory>WEB-INF/classes</outputDirectory>
        </fileSet>
        <!--公共配置文件-->
        <fileSet>
            <directory>${project.basedir}/src/main/resources</directory>
            <outputDirectory>WEB-INF/classes</outputDirectory>
        </fileSet>
        <!-- 將 webapp 下的文件輸出到 WAR 包 -->
        <fileSet>
            <directory>${project.basedir}/src/main/webapp</directory>
            <outputDirectory>/</outputDirectory>
        </fileSet>
    </fileSets>


    <dependencySets>
        <!-- 將項(xiàng)目依賴(lài)的JAR包輸出到 WEB-INF/lib -->
        <dependencySet>
            <outputDirectory>WEB-INF/lib</outputDirectory>
            <!--經(jīng)測(cè)試可以不需要-->
            <!--<excludes>-->
                <!--<exclude>*.war</exclude>-->
            <!--</excludes>-->
            <useProjectArtifact>false</useProjectArtifact>
        </dependencySet>
    </dependencySets>
</assembly>

這里采用的方案是, 不同環(huán)境公用同一個(gè)assembly.xml文件.

4 執(zhí)行打包的命令

各環(huán)境對(duì)應(yīng)的命令:

mvn clean package
mvn clean package -P dev
mvn clean package -P test
mvn clean package -P prod

后記

分環(huán)境打包的分支控制策略有兩種:

1. 通過(guò)profile配置不同的環(huán)境下的配置, 然后打包的時(shí)候通過(guò)參數(shù)-P 環(huán)境id定位到對(duì)應(yīng)profile, 就會(huì)執(zhí)行該profile下的所有配置, 包括自定義的properties(這里的properties和profile外層的效果一樣). 本文采用的就是這個(gè)思路.
   這種方案的好處是, 可以方便的定義默認(rèn)打包環(huán)境.

2. 不同環(huán)境的配置文件分別放在不同的路徑下, 打包配置中用${env}動(dòng)態(tài)執(zhí)行路徑, 然后打包時(shí)帶上參數(shù): -Denv=環(huán)境名稱(chēng), 即動(dòng)態(tài)手動(dòng)指定環(huán)境名, 定位到對(duì)應(yīng)路徑下的配置文件. 這種方案看似簡(jiǎn)單好實(shí)施, 但有個(gè)缺陷就是不方便執(zhí)行默認(rèn)打包環(huán)境.

最后, 再次重復(fù)一個(gè)坑點(diǎn):
下圖中兩種property效果完全不同的, 上面的我完全不知道有什么鳥(niǎo)用, 下面的才是關(guān)鍵.

properties