javax.naming.spi
Interface InitialContextFactoryBuilder


public interface InitialContextFactoryBuilder

This interface represents a builder that creates initial context factories.

The JNDI framework allows for different initial context implementations to be specified at runtime. An initial context is created using an initial context factory. A program can install its own builder that creates initial context factories, thereby overriding the default policies used by the framework, by calling NamingManager.setInitialContextFactoryBuilder(). The InitialContextFactoryBuilder interface must be implemented by such a builder.

Since:
1.3
See Also:
InitialContextFactory sample code for javax.naming.spi.InitialContextFactory definition code for javax.naming.spi.InitialContextFactory , 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) , NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder) sample code for javax.naming.spi.NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder) definition code for javax.naming.spi.NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder) , NamingManager.hasInitialContextFactoryBuilder() sample code for javax.naming.spi.NamingManager.hasInitialContextFactoryBuilder() definition code for javax.naming.spi.NamingManager.hasInitialContextFactoryBuilder() , 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
 InitialContextFactory sample code for javax.naming.spi.InitialContextFactory definition code for javax.naming.spi.InitialContextFactory createInitialContextFactory sample code for javax.naming.spi.InitialContextFactoryBuilder.createInitialContextFactory(java.util.Hashtable) definition code for javax.naming.spi.InitialContextFactoryBuilder.createInitialContextFactory(java.util.Hashtable) (Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable <?,?> environment)
          Creates an initial context factory using the specified environment.
 

Method Detail

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

InitialContextFactory sample code for javax.naming.spi.InitialContextFactory definition code for javax.naming.spi.InitialContextFactory  createInitialContextFactory(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 factory using the specified 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 - Environment used in creating an initial context implementation. Can be null.
Returns:
A non-null initial context factory.
Throws:
NamingException sample code for javax.naming.NamingException definition code for javax.naming.NamingException - If an initial context factory could not be created.