Maven Resources Plugin

External

• http://maven.apache.org/plugins/maven-resources-plugin/
• http://maven.apache.org/plugins/maven-resources-plugin/examples/filter.html

Internal

• Maven
• Maven Timestamp Support

Overview

By default, the plugin reads the configuration declared in the <project><build><resources> and <project><build><testResources> sections and automatically executes its "resources:resources" and "resource:testResources" goals at the "process-resources" and "process-test-resources" lifecycle phases, respectively. When copying resources, it uses <project><build><outputDirectory> as destination and when copying test resources, it uses <project><build><testOutputDirectory> as destination.

The plugin can be used to copy resources at any phase, by using the "resources:copy-resrouces" goal, as shown in

Variables can be replaced during when the resource plugin executes. For more details on how to specify variables to be replaced, see Maven Filtering and Property Substitution.

Resources

• http://maven.apache.org/plugins/maven-resources-plugin/examples/resource-directory.html
• http://maven.apache.org/plugins/maven-resources-plugin/examples/include-exclude.html

Variable Substitution in Resource Files

Set "filtering" to true as follows, and all variables will be substituted on copy:

<project>
  ...
  <build>
    ...
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
      </resource>
      ...
    </resources>
    ...
  </build>
  ...
</project>

For more details on how to specify the variables to be replaced, see:

Maven Filtering and Property Substitution

Copy Text Files in target and Final Artifact

  <build>
        ...
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.txt</include>
                </includes>
            </resource>
        </resources>
        ...
  </build>

This will copy all text files found under src/main/java into ./target/classes and make them available in the class path.

If you specify just the <directory>src/main/java</directory> resource under <resources>, this will remove all other implicit resources, including <directory>src/main/resources</directory> so if you were relying on that (for log4j.xml or whatever else) you will need to add it explicitly, as shown in the example below.

  <build>
        ...
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.txt</include>
                </includes>
            </resource>
        </resources>
        ...
  </build>

Java Source Code Filtering

Last time I tried to filter java source code with the following <resources> declaration, it did not work. Clarify why.

    <build>
        <resources>
            <resource>
                <directory>src/main/java/io/novaordis/gld/extensions/jboss/datagrid</directory>
                <includes>
                    <include>JBossDatagrid7Service.java</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>