remote-resources:process

Full name:

org.apache.maven.plugins:maven-remote-resources-plugin:1.5:process

Description:

Pull down resourceBundles containing remote resources and process the resources contained inside. When that is done the resources are injected into the current (in-memory) Maven project, making them available to the process-resources phase.

Resources that end in ".vm" are treated as velocity templates. For those, the ".vm" is stripped off for the final artifact name and it's fed through velocity to have properties expanded, conditions processed, etc...

Resources that don't end in ".vm" are copied "as is".

Attributes:

  • Requires a Maven project to be executed.
  • The goal is thread-safe and supports parallel builds.
  • Binds by default to the lifecycle phase: generate-resources.

Required Parameters

Name Type Since Description
resourceBundles List - The resource bundles that will be retrieved and processed, expressed with groupId:artifactId:version[:type[:classifier]] format.

Optional Parameters

Name Type Since Description
appendedResourcesDirectory File - The directory containing extra information appended to the generated resources.
Default value is: ${basedir}/src/main/appended-resources.
attachToMain boolean 1.5 Attaches the resources to the main build of the project as a resource directory.
Default value is: true.
User property is: attachToMain.
attachToTest boolean 1.5 Attaches the resources to the test build of the project as a resource directory.
Default value is: true.
User property is: attachToTest.
attached boolean 1.0-beta-1 Deprecated. Please use attachToMain and attachToTest instead.
Default value is: true.
encoding String - The character encoding scheme to be applied when filtering resources.
Default value is: ${project.build.sourceEncoding}.
User property is: encoding.
excludeArtifactIds String 1.0 Comma separated list of Artifact names too exclude.
User property is: excludeArtifactIds.
excludeGroupIds String 1.0 Comma separated list of GroupId Names to exclude.
User property is: excludeGroupIds.
excludeScope String 1.0 Scope to exclude. An Empty string indicates no scopes (default).
User property is: excludeScope.
excludeTransitive boolean 1.0 If we should exclude transitive dependencies
Default value is: false.
User property is: excludeTransitive.
filterDelimiters List 1.1

In cases where a local resource overrides one from a remote resource bundle, that resource should be filtered if the resource set specifies it. In those cases, this parameter defines the list of delimiters for filterable expressions. These delimiters are specified in the form 'beginToken*endToken'. If no '*' is given, the delimiter is assumed to be the same for start and end.

So, the default filtering delimiters might be specified as:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>
Since the '@' delimiter is the same on both ends, we don't need to specify '@*@' (though we can).
includeArtifactIds String 1.0 Comma separated list of Artifact names to include.
User property is: includeArtifactIds.
includeGroupIds String 1.0 Comma separated list of GroupIds to include.
User property is: includeGroupIds.
includeProjectProperties boolean 1.2 Whether to include properties defined in the project when filtering resources.
Default value is: false.
includeScope String 1.0 Scope to include. An Empty string indicates all scopes (default is "runtime").
Default value is: runtime.
User property is: includeScope.
outputDirectory File - The directory where processed resources will be placed for packaging.
Default value is: ${project.build.directory}/maven-shared-archive-resources.
properties Map - Additional properties to be passed to velocity. Several properties are automatically added:
project - the current MavenProject
projects - the list of dependency projects
projectTimespan - the timespan of the current project (requires inceptionYear in pom)
locator - the ResourceManager that can be used to retrieve additional resources
See the javadoc for MavenProject for information about the properties on the MavenProject.
resolveScopes String[] 1.5 When resolving project dependencies, specify the scopes to include. The default is the same as "includeScope" if there are no exclude scopes set. Otherwise, it defaults to "test" to grab all the dependencies so the exclude filters can filter out what is not needed.
runOnlyAtExecutionRoot boolean 1.1 If true, only generate resources in the directory of the root project in a multimodule build. Dependencies from all modules will be aggregated before resource-generation takes place.
Default value is: false.
skip boolean 1.0-alpha-5 Skip remote-resource processing
Default value is: false.
User property is: remoteresources.skip.
supplementalModelArtifacts List 1.1 List of artifacts that are added to the search path when looking for supplementalModels, expressed with groupId:artifactId:version[:type[:classifier]] format.
supplementalModels String[] 1.0-alpha-5 Supplemental model data. Useful when processing artifacts with incomplete POM metadata. By default, this Mojo looks for supplemental model data in the file "${appendedResourcesDirectory}/supplemental-models.xml".
useDefaultFilterDelimiters boolean 1.1 (no description)
Default value is: true.

Parameter Details

appendedResourcesDirectory:

The directory containing extra information appended to the generated resources.
  • Type: java.io.File
  • Required: No
  • Default: ${basedir}/src/main/appended-resources

attachToMain:

Attaches the resources to the main build of the project as a resource directory.
  • Type: boolean
  • Since: 1.5
  • Required: No
  • User Property: attachToMain
  • Default: true

attachToTest:

Attaches the resources to the test build of the project as a resource directory.
  • Type: boolean
  • Since: 1.5
  • Required: No
  • User Property: attachToTest
  • Default: true

attached:

Deprecated. Please use attachToMain and attachToTest instead.
Attaches the resources to the project as a resource directory.
  • Type: boolean
  • Since: 1.0-beta-1
  • Required: No
  • Default: true

encoding:

The character encoding scheme to be applied when filtering resources.
  • Type: java.lang.String
  • Required: No
  • User Property: encoding
  • Default: ${project.build.sourceEncoding}

excludeArtifactIds:

Comma separated list of Artifact names too exclude.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: excludeArtifactIds

excludeGroupIds:

Comma separated list of GroupId Names to exclude.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: excludeGroupIds

excludeScope:

Scope to exclude. An Empty string indicates no scopes (default).
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: excludeScope

excludeTransitive:

If we should exclude transitive dependencies
  • Type: boolean
  • Since: 1.0
  • Required: No
  • User Property: excludeTransitive
  • Default: false

filterDelimiters:

In cases where a local resource overrides one from a remote resource bundle, that resource should be filtered if the resource set specifies it. In those cases, this parameter defines the list of delimiters for filterable expressions. These delimiters are specified in the form 'beginToken*endToken'. If no '*' is given, the delimiter is assumed to be the same for start and end.

So, the default filtering delimiters might be specified as:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>
Since the '@' delimiter is the same on both ends, we don't need to specify '@*@' (though we can).
  • Type: java.util.List
  • Since: 1.1
  • Required: No

includeArtifactIds:

Comma separated list of Artifact names to include.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: includeArtifactIds

includeGroupIds:

Comma separated list of GroupIds to include.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: includeGroupIds

includeProjectProperties:

Whether to include properties defined in the project when filtering resources.
  • Type: boolean
  • Since: 1.2
  • Required: No
  • Default: false

includeScope:

Scope to include. An Empty string indicates all scopes (default is "runtime").
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: includeScope
  • Default: runtime

outputDirectory:

The directory where processed resources will be placed for packaging.
  • Type: java.io.File
  • Required: No
  • Default: ${project.build.directory}/maven-shared-archive-resources

properties:

Additional properties to be passed to velocity. Several properties are automatically added:
project - the current MavenProject
projects - the list of dependency projects
projectTimespan - the timespan of the current project (requires inceptionYear in pom)
locator - the ResourceManager that can be used to retrieve additional resources
See the javadoc for MavenProject for information about the properties on the MavenProject.
  • Type: java.util.Map
  • Required: No

resolveScopes:

When resolving project dependencies, specify the scopes to include. The default is the same as "includeScope" if there are no exclude scopes set. Otherwise, it defaults to "test" to grab all the dependencies so the exclude filters can filter out what is not needed.
  • Type: java.lang.String[]
  • Since: 1.5
  • Required: No

resourceBundles:

The resource bundles that will be retrieved and processed, expressed with groupId:artifactId:version[:type[:classifier]] format.
  • Type: java.util.List
  • Required: Yes

runOnlyAtExecutionRoot:

If true, only generate resources in the directory of the root project in a multimodule build. Dependencies from all modules will be aggregated before resource-generation takes place.
  • Type: boolean
  • Since: 1.1
  • Required: No
  • Default: false

skip:

Skip remote-resource processing
  • Type: boolean
  • Since: 1.0-alpha-5
  • Required: No
  • User Property: remoteresources.skip
  • Default: false

supplementalModelArtifacts:

List of artifacts that are added to the search path when looking for supplementalModels, expressed with groupId:artifactId:version[:type[:classifier]] format.
  • Type: java.util.List
  • Since: 1.1
  • Required: No

supplementalModels:

Supplemental model data. Useful when processing artifacts with incomplete POM metadata. By default, this Mojo looks for supplemental model data in the file "${appendedResourcesDirectory}/supplemental-models.xml".
  • Type: java.lang.String[]
  • Since: 1.0-alpha-5
  • Required: No

useDefaultFilterDelimiters:

(no description)
  • Type: boolean
  • Since: 1.1
  • Required: No
  • Default: true