JNDI API Tutorial and Reference

JNDI enables programs written in the Java programming language to access naming and directory services?a vital element of the complex distributed computing environment for today's enterprise systems. A platform-independent interface, JNDI allows Java applications to work with standard and proprietary services from a variety of vendors?including the Lightweight Directory Access Protocol (LDAP), Novell Directory Service (NDS), Microsoft Active Directory, and the Solaris? Operating Environment Network Information Service (NIS)?so that enterprises need not lock into a single-vendor solution.

Specific topics covered include:

• Accessing the LDAP via JNDI
• Using the directory as an object repository
• Configuring a JNDI client
• Handling event notifications from the directory
• Creating a federation of naming systems
• Building a JNDI service provider

All developers using the Java programming language to write applications or subsystems that access naming and directory services will find this book an indispensable resource.

Table of contents

List of Figures

List of Tables

Preface

Tutorial

Getting Started

Lesson 1 Naming and Directory Concepts

Lesson 2 JNDI Overview

Lesson 3 Examples

Lesson 4 Common Problems (and Their Solutions)

The Basics

Lesson 5 Preparations

Lesson 6 Naming Operations

Lesson 7 Directory Operations

Beyond the Basics

Lesson 8 What's in a Name?

Lesson 9 Environment Properties

Lesson 10 Event Notification

Lesson 11 URLs

Lesson 12 Federation

Lesson 13 Miscellaneous

Java Objects in the Directory

Lesson 14 Storing Objects in the Directory

Lesson 15 State Factories

Lesson 16 Reading Objects from the Directory

Lesson 17 Object Factories

Lesson 18 Representation in the Directory

Tips for LDAP Users

Lesson 19 Comparison of the LDAP and JNDI Models

Lesson 20 Security

Lesson 21 Miscellaneous

Lesson 22 Searches

Lesson 23 Referrals

Lesson 24 Schema

Lesson 25 Controls and Extensions

Lesson 26 Frequently Asked Questions

Building a Service Provider

Lesson 27 The Big Picture

Lesson 28 The Ground Rules

Lesson 29 The Essential Components

Lesson 30 Adding Directory Support

Lesson 31 Adding URL Support

Lesson 32 Adding Federation Support

Lesson 33 Miscellaneous

Class Libraries Reference

Package Overviews

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

Alphabetical Reference of Classes

Attribute

AttributeInUseException

AttributeModificationException

Attributes

AuthenticationException

AuthenticationNotSupportedException

BasicAttribute

BasicAttributes

BinaryRefAddr

Binding

CannotProceedException

CommunicationException

CompositeName

CompoundName

ConfigurationException

Context

ContextNotEmptyException

Control

ControlFactory

DirContext

DirectoryManager

DirObjectFactory

DirStateFactory

DirStateFactory.Result

EventContext

EventDirContext

ExtendedRequest

ExtendedResponse

HasControls

InitialContext

InitialContextFactory

InitialContextFactoryBuilder

InitialDirContext

InitialLdapContext

InsufficientResourcesException

InterruptedNamingException

InvalidAttributeIdentifierException

InvalidAttributesException

InvalidAttributeValueException

InvalidNameException

InvalidSearchControlsException

InvalidSearchFilterException

LdapContext

LdapReferralException

LimitExceededException

LinkException

LinkLoopException

LinkRef

MalformedLinkException

ModificationItem

Name

NameAlreadyBoundException

NameClassPair

NameNotFoundException

NameParser

NamespaceChangeListener

NamingEnumeration

NamingEvent

NamingException

NamingExceptionEvent

NamingListener

NamingManager

NamingSecurityException

NoInitialContextException

NoPermissionException

NoSuchAttributeException

NotContextException

ObjectChangeListener

ObjectFactory

ObjectFactoryBuilder

OperationNotSupportedException

PartialResultException

RefAddr

Reference

Referenceable

ReferralException

Resolver

ResolveResult

SchemaViolationException

SearchControls

SearchResult

ServiceUnavailableException

SizeLimitExceededException

StateFactory

StringRefAddr

TimeLimitExceededException

UnsolicitedNotification

UnsolicitedNotificationEvent

UnsolicitedNotificationListener

Appendix: LDAP Schemas

Index