javax.naming.spi

public Interface InitialContextFactoryBuilder

Imports: java.util.Hashtable, javax.naming.NamingException

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.

Authors: Rosanna Lee, Scott Seligman
Since: 1.3
See Also: InitialContextFactory, NamingManager#getInitialContext, NamingManager#setInitialContextFactoryBuilder, NamingManager#hasInitialContextFactoryBuilder, javax.naming.InitialContext, javax.naming.directory.InitialDirContext

Method Summary

Modifier and Type	Method and Description
public InitialContextFactory	Returns: A non-null initial context factory. createInitialContextFactory(Hashtable<?, ?> Environment used in creating an initial context implementation. Can be null. environment) Creates an initial context factory using the specified environment.

Method Detail

createInitialContextFactory	back to summary
public InitialContextFactory createInitialContextFactory(Hashtable<?, ?> environment) throws 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:Hashtable<?, ?> Environment used in creating an initial context implementation. Can be null. Returns:InitialContextFactory A non-null initial context factory. Exceptions NamingException: If an initial context factory could not be created.

createInitialContextFactory

back to summary

public InitialContextFactory createInitialContextFactory(Hashtable<?, ?> environment) throws 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:Hashtable<?, ?>: Environment used in creating an initial context implementation. Can be null.

Returns:InitialContextFactory

A non-null initial context factory.

Exceptions

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