為了優化需要，我需要看一下我的maven專案（一個java服務）在打包的時候是如何把專案打包成一個tar.gz包的，gz包裡的各個檔案又是哪來的。
也就是說，我需要知道maven是怎麼把專案從這樣：

變成這樣的：

我的工程是有一個父模組三個子模組的java服務，用maven管理相關的依賴。
mvn package命令打成的gz包有app、bin、conf、lib四個資料夾：

• bin裡面有一堆指令碼，啟動、停止之類的。我最想弄明白的其實就是這裡面的指令碼是怎麼生成的，現在遇到的優化專案就需要調整這裡面的啟動指令碼。
• conf裡是一堆配置檔案。
• lib裡是所有相關的jar包。

探尋過程

一，pom檔案

在父模組的pom檔案裡，我找到了maven的打包外掛：

<plugin>
	<groupId>com.dangdang</groupId>
	<artifactId>dd-assembly-plugin</artifactId>
	<version>2.0.1</version>
</plugin>
 

在子模組tms-bms-bootstrap的pom檔案裡，我找到了使用父模組打包外掛的程式碼：

<plugin>
    <groupId>com.dangdang</groupId>
    <artifactId>dd-assembly-plugin</artifactId>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>assembly</goal>
            </goals>
        </execution>
    </executions>
</plugin>
 

二，maven打包外掛

在我本地的maven倉庫中，根據pom檔案裡配置的groupId、artifactId和version組成的路徑：com\dangdang\dd-assembly-plugin\2.0.1找到了dd-assembly-plugin-2.0.1.jar。
dd-assembly-plugin-2.0.1.jar是maven的打包外掛，和maven自己的打包外掛名字不一樣，因為這個屬於公司框架，是在那基礎上改過的，這個jar包的結構是這樣的：

三，打包外掛的配置檔案

在assemblies目錄下有dd-frame-assemby.xml（不一定非要叫這麼個名字），是打包的描述檔案，這個檔案描述了在打包的時候maven會怎樣操作，是maven打包外掛的關鍵配置，這個檔案的內容如下：

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 
                        http://maven.apache.org/xsd/assembly-1.1.2.xsd" >
    <id>assembly</id>
    <formats>
        <format>tar.gz</format>
    </formats>
    <includeBaseDirectory>true</includeBaseDirectory>
    <fileSets>
        <fileSet>
            <directory>classpath:assemblies/bin/properties/jmx_config</directory>
            <outputDirectory>bin/properties/jmx_config</outputDirectory>
            <includes>
                <include>jmxremote.password</include>
            </includes>
            <fileMode>0600</fileMode>
        </fileSet>
        <fileSet>
            <directory>classpath:assemblies/bin</directory>
            <outputDirectory>bin</outputDirectory>
            <fileMode>0755</fileMode>
        </fileSet>
        <fileSet>
            <directory>classpath:assemblies/app</directory>
            <outputDirectory>app</outputDirectory>
            <fileMode>0644</fileMode>
        </fileSet>
        <fileSet>
            <directory>classpath:assemblies/conf</directory>
            <outputDirectory>conf</outputDirectory>
            <fileMode>0644</fileMode>
        </fileSet>
        <fileSet>
            <directory>src/main/resources/conf</directory>
            <includes>
                <include>*.properties</include>
                <include>*/*.properties</include>
                <include>logback.xml</include>
            </includes>
            <excludes>
                <exclude>*.private.properties</exclude>
                <exclude>*/*.private.properties</exclude>
            </excludes>
            <outputDirectory>conf</outputDirectory>
            <fileMode>0644</fileMode>
        </fileSet>
    </fileSets>
    
    <dependencySets>
        <!-- copy all dd-frame and third party jars to lib folder. -->
        <dependencySet>
            <outputDirectory>lib</outputDirectory>
            <excludes>
                <exclude>com.dangdang:*</exclude>
                <exclude>com.dang:*</exclude>
            </excludes>
        </dependencySet>
        <dependencySet>
            <outputDirectory>lib</outputDirectory>
            <includes>
                <include>com.dangdang:apimonitor</include>
                <include>com.dangdang:ddschedule</include>
                <include>com.dangdang:dd-assembly-plugin</include>
                <include>com.dangdang:dd-common</include>
                <include>com.dangdang:dd-container</include>
                <include>com.dangdang:dd-soa</include>
                <include>com.dangdang:dd-job</include>
                <include>com.dangdang:dd-job-tbschedule</include>
                <include>com.dangdang:dd-rdb</include>
                <include>com.dangdang:dd-reg</include>
                <include>com.dangdang:dd-log</include>
                <include>com.dangdang:dd-web</include>
                <include>com.dangdang:dd-test</include>
                <include>com.dangdang:dd-package</include>
                <include>com.dangdang:elastic-job-core</include>
                <include>com.dangdang:elastic-job-spring</include>
            </includes>
            <fileMode>0644</fileMode>
        </dependencySet>
        
        <!-- copy all dangdang jars to app folder. -->
        <dependencySet>
            <outputDirectory>app</outputDirectory>
            <includes>
                <include>com.dangdang:*</include>
                <include>com.dang:*</include>
            </includes>
            <excludes>
                <exclude>com.dangdang:apimonitor</exclude>
                <exclude>com.dangdang:ddschedule</exclude>
                <exclude>com.dangdang:dd-assembly-plugin</exclude>
                <exclude>com.dangdang:dd-common</exclude>
                <exclude>com.dangdang:dd-container</exclude>
                <exclude>com.dangdang:dd-soa</exclude>
                <exclude>com.dangdang:dd-job</exclude>
                <exclude>com.dangdang:dd-job-tbschedule</exclude>
                <exclude>com.dangdang:dd-rdb</exclude>
                <exclude>com.dangdang:dd-reg</exclude>
                <exclude>com.dangdang:dd-log</exclude>
                <exclude>com.dangdang:dd-web</exclude>
                <exclude>com.dangdang:dd-test</exclude>
                <exclude>com.dangdang:dd-package</exclude>
                <exclude>com.dangdang:elastic-job-core</exclude>
                <exclude>com.dangdang:elastic-job-spring</exclude>
            </excludes>
            <fileMode>0644</fileMode>
        </dependencySet>
        
        <!-- 
            Copy all dangdang jar's '*.properties' and profiles's '*.properties' to conf folder, exclude '*.private.properties'.
        -->
        <dependencySet>
            <includes>
                <include>com.dangdang:*</include>
                <include>com.dang:*</include>
            </includes>
            <excludes>
                <exclude>com.dangdang:apimonitor</exclude>
                <exclude>com.dangdang:ddschedule</exclude>
                <exclude>com.dangdang:dd-assembly-plugin</exclude>
                <exclude>com.dangdang:dd-common</exclude>
                <exclude>com.dangdang:dd-container</exclude>
                <exclude>com.dangdang:dd-soa</exclude>
                <exclude>com.dangdang:dd-job</exclude>
                <exclude>com.dangdang:dd-job-tbschedule</exclude>
                <exclude>com.dangdang:dd-rdb</exclude>
                <exclude>com.dangdang:dd-reg</exclude>
                <exclude>com.dangdang:dd-log</exclude>
                <exclude>com.dangdang:dd-web</exclude>
                <exclude>com.dangdang:dd-test</exclude>
                <exclude>com.dangdang:dd-package</exclude>
                <exclude>com.dangdang:elastic-job-core</exclude>
                <exclude>com.dangdang:elastic-job-spring</exclude>
            </excludes>
            <unpack>true</unpack>
            <unpackOptions>
                <includes>
                    <include>conf/*.properties</include>
                    <include>conf/*/*.properties</include>
                    <include>conf/logback.xml</include>
                    <include>conf/includedLogbackConfig.xml</include>
                </includes>
                <excludes>
                    <exclude>conf/*.private.properties</exclude>
                    <exclude>conf/*/*.private.properties</exclude>
                </excludes>
            </unpackOptions>
            <fileMode>0644</fileMode>
        </dependencySet>
        <!-- 
            If app jar does not have includedLogbackConfig.xml, copy default includedLogbackConfig.xml to conf folder. For ddframe package only.
        -->
        <dependencySet>
            <includes>
                <include>com.dangdang:dd-log</include>
            </includes>
            <unpack>true</unpack>
            <unpackOptions>
                <includes>
                    <include>includedLogbackConfig.xml</include>
                </includes>
            </unpackOptions>
            <fileMode>0644</fileMode>
            <outputDirectory>conf/</outputDirectory>
        </dependencySet>
    </dependencySets>
</assembly>

對這個檔案的部分內容說明如下：

• <formats>表示打包後的檔案格式，現在寫的tar.gz就表示打包後會生成一個xxx.tar.gz的壓縮包，還可以設定為war什麼的。
• <fileSets>表示要生成的包下有什麼目錄，目錄裡有哪些檔案，多個目錄可以用多個<fileSet>標籤來表示。
• <fileSets>標籤下的<directory>表示從哪個目錄獲取檔案，classpath:xxxx表示從打包外掛的jar包中獲取檔案，比如20行的<directory>classpath:assemblies/bin</directory>（打包後的bin目錄下的指令碼就來自這裡，我的目的達到了），而35行的<directory>src/main/resources/conf</directory>代表從專案路徑中獲取檔案。
• <fileSet>標籤下的<includes>代表了那些檔案要被打包，<excludes>標籤功能相反，代表哪些檔案在打包時將被忽略。
• <fileSet>標籤下的<outputDirectory>代表了將要生成的包下的目錄名字，比如打包後生成tar.gz包裡有bin目錄，就是用這個標籤設定的。
• <fileSet>標籤下的<fileMode>可能是目錄許可權，我不太確定。
• <dependencySets>標籤代表了專案的maven依賴的jar包的處理方式，以及這些jar包將要被放到目標的那個目錄下，多個目錄可以用多個<dependencySet>標籤來表示。
• <dependencySet>下的<outputDirectory>功能和<fileSet>下的同名標籤功能相同，指定了目標路徑。
• <dependencySet>下的<includes>功能和<fileSet>下的同名標籤功能相同，指定了哪些jar包將被放入目標目錄。
• <dependencySet>下的<excludes>功能和<fileSet>下的同名標籤功能相同，指定了哪些jar包將被忽略。

maven打包外掛的這個配置檔案其實實現了更多的功能，使用者可以自行配置，我只研究到這裡，大概就可以知道maven打包的時候都是按照什麼規則進行的。