er.extensions
Class ERXConfigurationManager

java.lang.Object
  er.extensions.ERXConfigurationManager

public class ERXConfigurationManager

extends Object

Configuration Manager handles rapid turnaround for system configuration as well as swizzling of the EOModel connection dictionaries.

Placing configuration parameters

You can provide the system configuration by the following ways:
Note: This is the standard way for WebObjects 5.x applications.

• Properties file under the Resources group of the application and framework project. It's a Properties file and Project Wonder's standard project templates include it. (The templates won't be available on some platforms at this moment.)
• WebObjects.properties under the user home directory; same format to Properties.
  Note that the user home directory depends on the user who launch the application. They may change between the developent and deployment time.
• Command line arguments
  For example: -WOCachingEnabled false -com.webobjects.pid $$
  Don't forget to put a dash "-" before the key.

Loading order of the configuration parameters

When the application launches, configuration parameters will be loaded by the following order. ERXConfigurationManager trys to reload them by the exactly same order when one of those configuration files changes.

1. Properties in frameworks that the application links to
2. Properties in the application
3. WebObjects.properties under the home directory
4. Command line arguments

If there is a conflicting parameter between the files and arguments, the latter one overrides the earlier one.

Note that the order between frameworks does not seems to be specified. You should not put conflicting parameters between framework Properties files. On the other hand, the application Properties should be always loaded after all framework Properties are loaded. You can safely override parameters on the frameworks from the applications Properties.

Changing the connection dictionary

To do this for Oracle you can either specify on a per model basis or on a global basis.

 Global:
 		dbConnectServerGLOBAL = myDatabaseServer
 		dbConnectUserGLOBAL = me
 		dbConnectPasswordGLOBAL = secret
 Per Model for say model ER:
 		ER.DBServer = myDatabaseServer
 		ER.DBUser = me
 		ER.DBPassword = secret
 
 Openbase: same, with DBDatabase and DBHostname
 
 JDBC: same with urlGlobal, or db.url
 
 

Prototypes can be swapped globally or per model either by hydrating an archived prototype entity for a file or from another entity.

Field Summary

protected String	_hostName holds the host name
static String	ConfigurationDidChangeNotification Notification posted when the configuration is updated.
protected String	documentRoot Path to the web server's document root.
static ERXLogger	log logging support
static int	MacOSXOperatingSystem
static int	SolarisOperatingSystem
static int	UnknownOperatingSystem
static int	WindowsOperatingSystem

Method Summary

String[]	commandLineArguments() Returns the command line arguments.
void	configureRapidTurnAround() Sets up the system for rapid turnaround mode.
static ERXConfigurationManager	defaultManager() Returns the single instance of this class
String	documentRoot()
String	hostName() Gets the default host name for the current local host.
void	initialize() Initializes the configuration manager.
boolean	isDeployedAsServlet() Checks if the application is deployed as a servlet.
void	loadOptionalConfigurationFiles() This will overlay the current system config files.
void	modelAddedHandler(NSNotification n) Called when a model is loaded.
int	operatingSystem()
void	resetConnectionDictionaryInModel(EOModel aModel) Resets the connection dictionary to the specified values that are in the defaults.
void	setCommandLineArguments(String[] newCommandLineArguments) Sets the command line arguments.
void	updateSystemProperties(NSNotification n) Updates the configuration from the current configuration and posts ConfigurationDidChangeNotification.

Methods inherited from class java.lang.Object

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

Field Detail

log

public static final ERXLogger log

logging support

ConfigurationDidChangeNotification

public static final String ConfigurationDidChangeNotification

Notification posted when the configuration is updated. The Java system properties is the part of the configuration.

See Also:

Constant Field Values

WindowsOperatingSystem

public static final int WindowsOperatingSystem

See Also:

Constant Field Values

MacOSXOperatingSystem

public static final int MacOSXOperatingSystem

See Also:

Constant Field Values

SolarisOperatingSystem

public static final int SolarisOperatingSystem

See Also:

Constant Field Values

UnknownOperatingSystem

public static final int UnknownOperatingSystem

See Also:

Constant Field Values

documentRoot

protected String documentRoot

Path to the web server's document root. This implementation tries first to resolve the application.name()+ "DocumentRoot" property value, then the ERXDocumentRoot property before getting the DocumentRoot key in your WebServerConfig.plist in the JavaWebObjects bundle.

_hostName

protected String _hostName

holds the host name

Method Detail

defaultManager

public static ERXConfigurationManager defaultManager()

Returns the single instance of this class

Returns:

the configuration manager

commandLineArguments

public String[] commandLineArguments()

Returns the command line arguments. ERXApplication.main(java.lang.String[], java.lang.Class) sets this value.

Returns:

the command line arguments as a String[]

See Also:

setCommandLineArguments(java.lang.String[])

setCommandLineArguments

public void setCommandLineArguments(String[] newCommandLineArguments)

Sets the command line arguments. ERXApplication.main(java.lang.String[], java.lang.Class) will call this method when the application starts up.

See Also:

commandLineArguments()

initialize

public void initialize()

Initializes the configuration manager. The framework principal ERXExtensions calls this method when the ERExtensions framework is loaded.

configureRapidTurnAround

public void configureRapidTurnAround()

Sets up the system for rapid turnaround mode. It will watch the changes on Properties files in application and framework bundles and WebObjects.properties under the home directory. Rapid turnaround mode will only be enabled if there are such files available and system has WOCaching disabled.

loadOptionalConfigurationFiles

public void loadOptionalConfigurationFiles()

This will overlay the current system config files. It will then re-load the command line args.

updateSystemProperties

public void updateSystemProperties(NSNotification n)

Updates the configuration from the current configuration and posts ConfigurationDidChangeNotification. It also calls ERXLogger.configureLogging(java.util.Properties) to reconfigure the logging system.

The configuration files: Properties and WebObjects.properties files are reloaded to the Java system properties by the same order to the when the system starts up. Then the command line arguments will be applied to the properties again so that the configuration will be consistent during the application lifespan.

This method is called when rapid turnaround is enabled and one of the configuration files changes.

Parameters:

n - NSNotification object for the event

modelAddedHandler

public void modelAddedHandler(NSNotification n)

Called when a model is loaded. This will reset the connection dictionary and insert the correct EOPrototypes if those are used

Parameters:

n - notification posted when a model is loaded. The object is the model.

resetConnectionDictionaryInModel

public void resetConnectionDictionaryInModel(EOModel aModel)

Resets the connection dictionary to the specified values that are in the defaults. This method will look for defaults in the form .DBServer .DBUser .DBPassword .URL (for JDBC) if the serverName and username both exists, we overwrite the connection dict (password is optional). Otherwise we fall back to what's in the model. Likewise default values can be specified of the form: dbConnectUserGLOBAL dbConnectPasswordGLOBAL dbConnectURLGLOBAL

Parameters:

aModel - to be reset

operatingSystem

public int operatingSystem()

documentRoot

public String documentRoot()

hostName

public String hostName()

Gets the default host name for the current local host.

Returns:

host name or UnknownHost if the host is unknown.

isDeployedAsServlet

public boolean isDeployedAsServlet()

Checks if the application is deployed as a servlet.

The current implementation only checks if the application is linked against JavaWOJSPServlet.framework.

Returns:

true if the application is deployed as a servlet