org.apache.maven.shared.filtering

Class PropertyUtils

java.lang.Object

org.apache.maven.shared.filtering.PropertyUtils

public final class PropertyUtils
extends java.lang.Object

Version:

$Id: PropertyUtils.java 744583 2009-02-14 23:27:29Z bentmann $

Author:

Kenney Westerhof, William Ferguson

Method Summary

Modifier and Type	Method and Description
static java.util.Properties	loadPropertyFile(java.io.File propfile, boolean fail, boolean useSystemProps) Reads a property file, resolving all internal variables.
static java.util.Properties	loadPropertyFile(java.io.File propFile, java.util.Properties baseProps) Reads a property file, resolving all internal variables, using the supplied base properties.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

loadPropertyFile

public static java.util.Properties loadPropertyFile(java.io.File propFile,
                                                    java.util.Properties baseProps)
                                             throws java.io.IOException

Reads a property file, resolving all internal variables, using the supplied base properties.

The properties are resolved iteratively, so if the value of property A refers to property B, then after resolution the value of property B will contain the value of property B.

Parameters:

propFile - The property file to load.

baseProps - Properties containing the initial values to subsitute into the properties file.

Returns:

Properties object containing the properties in the file with their values fully resolved.

Throws:

java.io.IOException - if profile does not exist, or cannot be read.

loadPropertyFile

public static java.util.Properties loadPropertyFile(java.io.File propfile,
                                                    boolean fail,
                                                    boolean useSystemProps)
                                             throws java.io.IOException

Reads a property file, resolving all internal variables.

Parameters:

propfile - The property file to load

fail - wheter to throw an exception when the file cannot be loaded or to return null

useSystemProps - wheter to incorporate System.getProperties settings into the returned Properties object.

Returns:

the loaded and fully resolved Properties object

Throws:

java.io.IOException - if profile does not exist, or cannot be read.