org.apache.webbeans.config
Class PropertyLoader

java.lang.Object
  extended by org.apache.webbeans.config.PropertyLoader

public class PropertyLoader
extends Object

Utility class to load configuration properties via a list of artibrary property files by a well defined order.

User configurations should start with 'configuration.ordinal' greather than 100.


Field Summary
static int CONFIGURATION_ORDINAL_DEFAULT_VALUE
           
static String CONFIGURATION_ORDINAL_PROPERTY_NAME
           
 
Constructor Summary
PropertyLoader()
           
 
Method Summary
static Properties getProperties(String propertyFileName)
          Look for all property files with the given name (e.g.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CONFIGURATION_ORDINAL_DEFAULT_VALUE

public static final int CONFIGURATION_ORDINAL_DEFAULT_VALUE
See Also:
Constant Field Values

CONFIGURATION_ORDINAL_PROPERTY_NAME

public static final String CONFIGURATION_ORDINAL_PROPERTY_NAME
See Also:
Constant Field Values
Constructor Detail

PropertyLoader

public PropertyLoader()
Method Detail

getProperties

public static Properties getProperties(String propertyFileName)

Look for all property files with the given name (e.g. 'myconfig.properties') in the classpath. Then load all properties files and sort them by their ascending configuration order and apply them in this order.

The idea is to be able to 'override' properties by just providing a new properties file with the same name but a higher 'configuration.ordinal' than the old one.

If a property file defines no 'configuration.ordinal' property than a default value of CONFIGURATION_ORDINAL_DEFAULT_VALUE is assumed. Any sensitive default which is provided by the system parsing for the configuration should have a 'configuration.ordinal' value lower than 10. In most cases a value of 1

If 2 property files have the same ordinal 'configuraiton.order' the outcome is not really defined. The Properties file which got found first will be processed first and thus get overwritten by the one found later.

Parameters:
propertyFileName - the name of the properties file
Returns:
the final property values


Copyright © 2008-2011 The Apache Software Foundation. All Rights Reserved.