javax.naming.spi
Interface InitialContextFactoryBuilder

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

See Also:

InitialContextFactory, NamingManager.getInitialContext(java.util.Hashtable), NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder), NamingManager.hasInitialContextFactoryBuilder(), InitialContext, InitialDirContext

Method Summary

InitialContextFactory

createInitialContextFactory(java.util.Hashtable environment) Creates an initial context factory using the specified environment.

Method Detail

createInitialContextFactory

public InitialContextFactory createInitialContextFactory(java.util.Hashtable environment)
                                                  throws NamingException

Creates an initial context factory using the specified environment.

Parameters:

environment - Environment used in creating an intial context implementation. Can be null.

Returns:

A non-null initial context factory.

Throws:

NamingException - If an initial context factory could not be created.