JavaTM 2 Platform Std. Ed. v1.4.2
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 ,
NamingManager.getInitialContext(java.util.Hashtable) ,
NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder) ,
NamingManager.hasInitialContextFactoryBuilder() ,
InitialContext ,
InitialDirContext
createInitialContextFactory
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 - Environment used in creating an initial
context implementation. Can be null.
- Returns:
- A non-null initial context factory.
- Throws:
NamingException - If an initial context factory could not be created.
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|