maven資源文件的相關配置

構建Maven項目的時候，如果沒有進行特殊的配置，Maven會按照標準的目錄結構查找和處理各種類型文件。

 

src/main/java和src/test/java 

這兩個目錄中的所有*.java文件會分別在comile和test-comiple階段被編譯，編譯結果分別放到了target/classes和targe/test-classes目錄中，但是這兩個目錄中的其他文件都會被忽略掉。

 

src/main/resouces和src/test/resources

這兩個目錄中的文件也會分別被複制到target/classes和target/test-classes目錄中。

 

target/classes

打包插件默認會把這個目錄中的所有內容打入到jar包或者war包中。

 

 

Maven項目的標準目錄結構

• src
  • main
    • java         源文件 
    • resources    資源文件
    • filters   資源過濾文件
    • config   配置文件
    • scripts   腳本文件
    • webapp   web應用文件
  • test
    • java    測試源文件
    • resources    測試資源文件
    • filters    測試資源過濾文件
  • it       集成測試
  • assembly    assembly descriptors
  • site    Site
• target
  • generated-sources
  • classes
  • generated-test-sources
  • test-classes
  • xxx.jar
• pom.xml
• LICENSE.txt
• NOTICE.txt
• README.txt

 

資源文件的配置

資源文件是Java代碼中要使用的文件。代碼在執行的時候會到指定位置去查找這些文件。前面已經說了Maven默認的處理方式，但是有時候我們需要進行自定義的配置。

有時候有些配置文件通常與.java文件一起放在src/main/java目錄（如mybatis或hibernate的表映射文件）。有的時候還希望把其他目錄中的資源也複製到classes目錄中。這些情況下就需要在Pom.xml文件中修改配置了。

可以有兩種方法：

• 一是在<build>元素下添加<resources>進行配置。
• 另一種是在<build>的<plugins>子元素中配置maven-resources-plugin等處理資源文件的插件。

 

配置resouces節點

  <build>
    .......
      <resources>
        <resource>
            <directory>src/main/resources</directory>
            <excludes>
                <exclude>**/*.properties</exclude>
                <exclude>**/*.xml</exclude>
             </excludes>
            <filtering>false</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
    ......
</build>

 

配置資源處理插件

       <plugin>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.5</version>
            <executions>
                <execution>
                    <id>copy-xmls</id>
                    <phase>process-sources</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${basedir}/target/classes</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${basedir}/src/main/java</directory>
                                <includes>
                                    <include>**/*.xml</include>
                                </includes>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>

 

另一個插件也能完成相同的功能

        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>1.8</version>
            <executions>
                <execution>
                    <id>add-resource</id>
                    <phase>generate-resources</phase>
                    <goals>
                        <goal>add-resource</goal>
                    </goals>
                    <configuration>
                        <resources>
                            <resource>
                                <directory>src/main/java</directory>
                                <includes>
                                    <include>**/*.xml</include>
                                </includes>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin> 

 

 

打包時文件相關的配置

打包時target/classes目錄中的資源文件會和class字節碼一起被打進jar包或war包中。有時候默認的情況不能完全滿足需求，如target/classes目錄中的一些文件不希望打入jar包中，就需要額外配置maven-jar-plugin插件。

　　　　　　　<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>2.4</version>
                <configuration>
                    <excludes>
                        <exclude>*.properties</exclude>
                    </excludes>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <mainClass>xxxxxx.ConsoleLauncher</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>