javax.naming.spi (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package javax.naming.spi

Provides the means for dynamically plugging in support for accessing naming and directory services through the `javax.naming` and related packages.

See:
Description

Interface Summary
DirObjectFactory | This interface represents a factory for creating an object given an object and attributes about the object.
DirStateFactory | This interface represents a factory for obtaining the state of an object and corresponding attributes for binding.
InitialContextFactory | This interface represents a factory that creates an initial context.
InitialContextFactoryBuilder | This interface represents a builder that creates initial context factories.
ObjectFactory | This interface represents a factory for creating an object.
ObjectFactoryBuilder | This interface represents a builder that creates object factories.
Resolver | This interface represents an "intermediate context" for name resolution.
StateFactory | This interface represents a factory for obtaining the state of an object for binding.

Class Summary
DirectoryManager | This class contains methods for supporting `DirContext` implementations.
DirStateFactory.Result | An object/attributes pair for returning the result of DirStateFactory.getStateToBind().
NamingManager | This class contains methods for creating context objects and objects referred to by location information in the naming or directory service.
ResolveResult | This class represents the result of resolution of a name.

## Package javax.naming.spi Description

Provides the means for dynamically plugging in support for accessing naming and directory services through the `javax.naming` and related packages.

This package defines the service provider interface (SPI) of the Java Naming and Directory InterfaceTM (JNDI). JNDI provides naming and directory functionality to applications written in the Java programming language. It is designed to be independent of any specific naming or directory service implementation. Thus a variety of services--new, emerging, and already deployed ones--can be accessed in a common way.

The JNDI SPI provides the means for creating JNDI service providers, through which JNDI applications access different naming and directory services.

#### Plug-in Architecture

The service provider package allows different implementations to be plugged in dynamically. These different implementations include those for the initial context, and implementations for contexts that can be reached from the initial context.

#### Java Object Support

The service provider package provides support for implementors of the `javax.naming.Context.lookup()` method and related methods to return Java objects that are natural and intuitive for the Java programmer. For example, when looking up a printer name from the directory, it is natural for you to expect to get back a printer object on which to operate.

#### Multiple Naming Systems (Federation)

JNDI operations allow applications to supply names that span multiple naming systems. So in the process of completing an operation, one service provider might need to interact with another service provider, for example, to pass on the operation to be continued in the next naming system. The service provider package provides support for different providers to cooperate to complete JNDI operations.

## Package Specification

The following documents can be found at the Java technology web site:

- JNDI SPI Document (Postscript)
- JNDI SPI Document (PDF)

## Related Documentation

For a tutorial, examples, and overview, please see:

- The JNDI Tutorial
- Examples
- Executive Summary (Postscript)
- Executive Summary (PDF)

Since:
  1.3

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.