Plugin Documentation

Goals available for this plugin:

GoalDescription
properties:decryptallInspect project and system properties for any keys ending with endsWith. Any matching properties are assumed to be encrypted. They are decrypted and stored as project properties minus the endsWith suffix. For example, the value for the property "dba.password.encrypted" will be decrypted and stored as "dba.password"
properties:encryptGenerate encrypted values for the specified system or project properties.
properties:get-gav-propertyFind a GAV specific property value using GroupId+ArtifactId+Version. The logic goes from most specific to least specific. If there is a value for the full GAV, that value is used. Otherwise, a value for GroupId + ArtifactId, or finally just GroupId. If no value is found, the defaultValue is used. A new project property with .gav appended is set if a value is found.
properties:parse-version-propertiesParse version number properties into [major].[minor].[incremental].[qualifier] and [trimmed]. The version parsing logic is crudely simple. It splits the version string into tokens using both "." and "-" as delimiters. It assumes the first token is "major", the second token is "minor" the third token is "incremental" and any tokens after that are "qualifier". "SNAPSHOT" is always omitted from qualifier. [trimmed] is the full version minus "-SNAPSHOT"
properties:read-project-propertiesThe read-project-properties goal reads property files and stores the properties as project properties. It serves as an alternate to specifying properties in pom.xml.
Properties files handled by this plugin, have their property values resolved using Spring's expression parser. This means anything you can do with Spring property values you can do with property values handled by this plugin. For example, nested properties are supported: eg foo=${a.${b}.c}
properties:set-system-propertiesSets system properties.
properties:translate-propertiesTranslate the indicated properties into classpath friendly form. eg Transform org.kuali.rice into org/kuali/rice A new project property with ".path" added as a suffix gets set with the transformed value
properties:write-active-profile-propertiesWrites properties of all active profiles to a file.
properties:write-project-propertiesWrite project properties to a file.

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven2.0
JDK1.6
MemoryNo minimum requirement.
Disk SpaceNo minimum requirement.

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.kuali.maven.plugins</groupId>
          <artifactId>properties-maven-plugin</artifactId>
          <version>1.4.3</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.kuali.maven.plugins</groupId>
        <artifactId>properties-maven-plugin</artifactId>
        <version>1.4.3</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"