org.ow2.carol.cmi.jndi.context
Class CMIInitialContextFactory

java.lang.Object
  org.ow2.carol.cmi.jndi.context.CMIInitialContextFactory

All Implemented Interfaces:

javax.naming.spi.InitialContextFactory

public final class CMIInitialContextFactory
extends java.lang.Object
implements javax.naming.spi.InitialContextFactory

CMIInitialContext factory.
The following properties must be set in the environment given in parameter:

• "cmi.context.wrapped.protocol"
  Define the protocol of the wrapped context. For example: jrmp, iiop or irmi.
• "cmi.context.provider.urls"
  Define the initial set of provider URLs (it will be updated periodically). For example: rmi://212.13.45.9:1099,212.13.45.9:1103,129.14.13.5:1099. Supported schemes are rmi and iiop.
  The specified protocol must be consistent with the scheme of url,
  ie: jrmp as protocol with rmi as scheme is good but not jrmp with iiop !
• "cmi.context.wrapped.factory"
  Define the InitialContextFactory to use to construct the real context.
• "cmi.mode.server"
  Indicate if the server mode is enabled. The server mode allows performing bindings but need a local registry.

Author:

The new CMI team

See Also:

CMIContext

Constructor Summary

CMIInitialContextFactory()

Method Summary

javax.naming.Context

getInitialContext(java.util.Hashtable<?,?> environment) Create a CMI context.

Methods inherited from class java.lang.Object

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

Constructor Detail

CMIInitialContextFactory

public CMIInitialContextFactory()

Method Detail

getInitialContext

public javax.naming.Context getInitialContext(java.util.Hashtable<?,?> environment)
                                       throws javax.naming.NamingException

Create a CMI context.
Because the JNDI environment is provided in parameter, if the expected properties are not set, a NamingException will be thrown.

Specified by:

getInitialContext in interface javax.naming.spi.InitialContextFactory

Parameters:

environment - The needed properties to create the CMI context.

Returns:

A CMI context

Throws:

javax.naming.NamingException - If cannot create an initial context.