APIdia Launch Partner
Top Description Methods
javax.naming.spi

public Interface InitialContextFactory

Known Direct Implementers
com.sun.jndi.ldap.LdapCtxFactory
Imports
java.util.Hashtable, javax.naming.*

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.

Authors
Rosanna Lee, Scott Seligman
Since
1.3
See Also
InitialContextFactoryBuilder, NamingManager#getInitialContext, javax.naming.InitialContext, javax.naming.directory.InitialDirContext

Method Summary

Modifier and TypeMethod and Description
public Context

Returns:

A non-null initial context object that implements the Context interface.
getInitialContext
(Hashtable<?, ?>
The possibly null environment specifying information to be used in the creation of the initial context.
environment
)

Creates an Initial Context for beginning name resolution.

Method Detail

getInitialContextback to summary
public Context getInitialContext(Hashtable<?, ?> environment) throws 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:Hashtable<?, ?>

The possibly null environment specifying information to be used in the creation of the initial context.

Returns:Context

A non-null initial context object that implements the Context interface.

Exceptions
NamingException:
If cannot create an initial context.