javax.naming.spi
Interface InitialContextFactory

public abstract interface InitialContextFactory

This interface represents a factory that creates an initial context.

The JNDI framework allows for different initial context implementations to be specified at runtime. The initial context is created using an initial context factory. Each initial context factory must implement the InitialContextFactory interface, which provides a method for creating instances of initial context that implement the Context interface. In addition, the factory class must be public and must have a public constructor that accepts no arguments.

See Also:

InitialContextFactoryBuilder, NamingManager.getInitialContext(java.util.Hashtable), InitialContext, InitialDirContext

Method Summary

Context

getInitialContext(java.util.Hashtable environment) Creates an Initial Context for beginning name resolution.

Method Detail

getInitialContext

public Context getInitialContext(java.util.Hashtable environment)
                          throws NamingException

Creates an Initial Context for beginning name resolution. Optional environment that specify special requirements of this context are supplied using 'environment'. An example of an item in the environment could be user identity information.

Parameters:

environment - The possibly null environment specifying information to be used in the creation of the initial context.

Returns:

A non-null initial context object that implements the Context interface.

Throws:

NamingException - If cannot create an initial context.