LoadProperties

Description

Load a file's contents as Apache Ant properties. This is equivalent to <property file|resource="..."/> except that it supports nested <filterchain> elements. Also if the file is missing, the build is halted with an error, rather than a warning being printed.

Note: the default value of this task's prefixValues attribute is different from the default value of the same attribute in the <property> task.

Parameters

Attribute Description Required
srcFile source file One of these or a nested resource
resource the resource name of the property file
encoding encoding to use when loading the file No
classpath the classpath to use when looking up a resource. No
classpathref the classpath to use when looking up a resource, given as reference to a <path> defined elsewhere.. No
prefix Prefix to apply to loaded properties; a "." is appended to the prefix if not specified. Since Ant 1.8.1 No
prefixValues Whether to apply the prefix when expanding the right hand side of the properties. Since Ant 1.8.2 No (default=true)

Parameters specified as nested elements

any resource or single element resource collection

The specified resource will be used as src. Since Ant 1.7

FilterChain

classpath

for use with the resource attribute.

Examples

    <loadproperties srcFile="file.properties"/>
or
    <loadproperties>
      <file file="file.properties"/>
    </loadproperties>
Load contents of file.properties as Ant properties.
    <loadproperties srcFile="file.properties">
      <filterchain>
        <linecontains>
          <contains value="import."/>
        </linecontains>
      </filterchain>
    </loadproperties>
Read the lines that contain the string "import." from the file "file.properties" and load them as Ant properties.
    <loadproperties>
      <gzipresource>
        <url url="http://example.org/url.properties.gz"/>
      </gzipresource>
    </loadproperties>
Load contents of http://example.org/url.properties.gz, uncompress it on the fly and load the contents as Ant properties.