The JNDI Tutorial

Getting Started
The Basics
Beyond the Basics
Java Objects and the Directory
Tips for LDAP Users
Building a Service Provider

Getting Started
Naming and Directory Concepts
Naming Concepts
Directory Concepts
Directory-Enabled Java Applications
Glossary
JNDI Overview
Naming Package
Directory Package
Event Package
LDAP Package
Service Provider Package
Examples
Naming Example
Directory Example
Common Problems (and Their Solutions)
Compilation Problems
Runtime Problems
Web Browser Problems
The Basics
Preparations
Required Software
Contents of the Directory
Packages and Classpath
Naming Exceptions
The Initial Context
Names
Naming Operations
Looking Up an Object
Listing a Context
Adding, Replacing, and Removing a Binding
Renaming an Object
Creating and Destroying a Context
Directory Operations
Attribute Names
Reading Attributes
Modifying Attributes
Searching the Directory
Basic Search
Search Filters
Search Controls
Search Scope
Count Limit
Time Limit
Hybrid Naming and Directory Operations
Beyond the Basics
What's in a Name?
String Names versus Structured Names
Composite Names
Compound Names
Name Parsers
Handling Special Characters
Dynamic Name Composition
Environment Properties
Overview
Specifying Environment Properties
A Context's Environment
Customizing a Service Provider
Event Notification
Event Listeners
Listener Registration
Naming Events
LDAP Unsolicited Notifications
URLs
URLs as Names to the Initial Context
URLs as Names Returned by Enumerations
URLs as References for Federation
URLs as Data for Configuration
Federation
Naming System Boundaries
The Current Naming System
The Next Naming System
Miscellaneous
Class Loading
Link Reference
Naming Policies
Threads and Synchronization
Security
Java Objects and the Directory

Storing Objects in the Directory
Serializable Objects
Referenceable Objects and References
Objects with Attributes
Remote Objects
CORBA Objects
State Factories
Writing a State Factory
Interaction Between State Factories and Service Providers
Examples
Reading Objects from the Directory
Lookups
Lists
Searches
Object Factories
Writing an Object Factory
Other Uses
Interaction Between Object Factories and Service Providers
Examples
Representation in the Directory
LDAP Directories
File System

Tips for LDAP Users

Comparison of the LDAP and JNDI Models
X.500 Overview
LDAP v2
LDAP v3
JNDI Mapping
LDAP Operations and JNDI Mapping
LDAP Status Codes and JNDI Exceptions
Security
LDAP Authentication
Authentication Mechanisms
Anonymous Authentication
Simple Authentication
SASL Authentication
Digest-MD5 Authentication
CRAM-MD5 Authentication
Callbacks for SASL Mechanisms
GSS-API/Kerberos v5 Authentication
Using Arbitrary SASL Mechanisms
SSL and Custom Sockets
Miscellaneous
Protocol Versions
Attributes
Dereferencing Aliases
Renaming Objects
Storing Objects
LDAP & LDAPS URLs
Searches
Context Search Methods
Other Context Methods
The LDAP "Compare" Operation
Search Results
Batch Size
Referrals
Referrals in the LDAP
Referrals in the JNDI
Ignoring Referrals
Automatically Following Referrals
Manually Following Referrals
Creating and Updating Referrals
Schema
Overview
Schema in the JNDI
Object Class Definitions
Attribute Type Definitions
Attribute Syntax Definitions
Attribute Matching Rule Definitions
Two Practical Examples
Controls and Extensions
Controls
Request Controls
Context Request Controls
Connection Request Controls
Response Controls
"Extended" Operations
The Start TLS Extension
Connections
Connection Creation
Connection Closure
Connection Pooling
Connection Pooling Configuration
Frequently Asked Questions
Contexts
Attributes
Searches
Names

Building a Service Provider

The Big Picture
Essential Components
Optional Components
Advanced Features
The Ground Rules
Parameters and Return Values
Environment Properties
Names
Threads and Synchronization
Security Considerations
The Essential Components
Implementing a Context Implementation
Names
Lookup Methods
List Methods
Update Methods
Name Parser
More Names
Miscellaneous
Building in Extensibility
Implementing an Initial Context Factory
Adding Directory Support
Attribute Retrieval
Attribute Updates
Hybrid Naming and Directory Operations
Searches
Schema
Building in Extensibility
Adding URL Support
URL Context Factory
URL Context Implementation
Supporting Subinterfaces
Making the Implementation Available
Relationship to the Initial Context
Relationship to References
Adding Federation Support
Naming System Boundaries
The Current Naming System
The Next Naming System
Resolving through Subinterfaces
Creating a Federation
Miscellaneous
Packaging
Adding Referral Support
Adding Link Reference Support
Adding Event Notification Support
Adding Support for Controls and Extensions

Another Java Books
Another Programming Language
Download