com.redstarhackers.naming.client
Class InitialContextHelper

java.lang.Object
  com.redstarhackers.naming.client.InitialContextHelper

public class InitialContextHelper

extends java.lang.Object

InitialContextHelper takes care of loading/creating an InitialContext that is based on the standard java.naming properties and any additional properties defined in the application configuration (via the rsh-config package's Configurations interface). This class will also cache the created InitialContext to save on binding and creation costs.

Version:

$Revision: 1250 $

Author:

$Author: kostya $

Constructor Summary

InitialContextHelper()

Method Summary

void	clearInitialContext()
void	clearInitialContext(java.lang.String appName)
void	clearInitialContext(java.lang.String appName, java.lang.String name)
javax.naming.InitialContext	getInitialContext() Retrieves an InitialContext that is initialized only through the standard sources of configuration for java.naming.
javax.naming.InitialContext	getInitialContext(java.lang.String appName) Retrieves an InitialContext that is initialized through the standard sources of configuration for java.naming plus any "default" settings in the app's configuration (where appName describes the configuration as specified in rsh-config).
javax.naming.InitialContext	getInitialContext(java.lang.String appName, java.lang.String name) Retrieves an InitialContext that is initialized through the standard sources of configuration for java.naming plus any settings in the app's configuration (where appName describes the configuration as specified in rsh-config).
static InitialContextHelper	getInstance() Retrieve the singleton instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

InitialContextHelper

public InitialContextHelper()

Method Detail

getInstance

public static InitialContextHelper getInstance()

Retrieve the singleton instance. This method calls the singleton initializer if the singleton is not initialized. The initializer is synchronized and thread safe.

Returns:

the singleton instance.

getInitialContext

public javax.naming.InitialContext getInitialContext()

Retrieves an InitialContext that is initialized only through the standard sources of configuration for java.naming.

Returns:

the InitialContext.

See Also:

java.naming.InitialContext

getInitialContext

public javax.naming.InitialContext getInitialContext(java.lang.String appName)

Retrieves an InitialContext that is initialized through the standard sources of configuration for java.naming plus any "default" settings in the app's configuration (where appName describes the configuration as specified in rsh-config).

Returns:

the InitialContext.

See Also:

java.naming.InitialContext

getInitialContext

public javax.naming.InitialContext getInitialContext(java.lang.String appName,
                                                     java.lang.String name)

Retrieves an InitialContext that is initialized through the standard sources of configuration for java.naming plus any settings in the app's configuration (where appName describes the configuration as specified in rsh-config). The settings in the app are found via "[name].java.naming.*".

Returns:

the InitialContext.

See Also:

java.naming.InitialContext

clearInitialContext

public void clearInitialContext()

clearInitialContext

public void clearInitialContext(java.lang.String appName)

clearInitialContext

public void clearInitialContext(java.lang.String appName,
                                java.lang.String name)