javax.naming.spi
Interface InitialContextFactory


public 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. An 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.

Since:
1.3
See Also:
InitialContextFactoryBuilder sample code for javax.naming.spi.InitialContextFactoryBuilder definition code for javax.naming.spi.InitialContextFactoryBuilder , NamingManager.getInitialContext(java.util.Hashtable) sample code for javax.naming.spi.NamingManager.getInitialContext(java.util.Hashtable) definition code for javax.naming.spi.NamingManager.getInitialContext(java.util.Hashtable) , InitialContext sample code for javax.naming.InitialContext definition code for javax.naming.InitialContext , InitialDirContext sample code for javax.naming.directory.InitialDirContext definition code for javax.naming.directory.InitialDirContext

Method Summary
 Context sample code for javax.naming.Context definition code for javax.naming.Context getInitialContext sample code for javax.naming.spi.InitialContextFactory.getInitialContext(java.util.Hashtable) definition code for javax.naming.spi.InitialContextFactory.getInitialContext(java.util.Hashtable) (Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable <?,?> environment)
          Creates an Initial Context for beginning name resolution.
 

Method Detail

getInitialContext sample code for javax.naming.spi.InitialContextFactory.getInitialContext(java.util.Hashtable<?, ?>) definition code for javax.naming.spi.InitialContextFactory.getInitialContext(java.util.Hashtable<?, ?>)

Context sample code for javax.naming.Context definition code for javax.naming.Context  getInitialContext(Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable <?,?> environment)
                          throws NamingException sample code for javax.naming.NamingException definition code for javax.naming.NamingException 
Creates an Initial Context for beginning name resolution. Special requirements of this context are supplied using environment.

The environment parameter is owned by the caller. The implementation will not modify the object or keep a reference to it, although it may keep a reference to a clone or copy.

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 sample code for javax.naming.NamingException definition code for javax.naming.NamingException - If cannot create an initial context.