Chapter 15 Using the JNDI Service Provider

This chapter explains JNDI and shows you how to use Netscape's LDAP Service Provider for JNDI.

• "How JNDI Works"
• "Installing the Service Provider"
• "JNDI Environment Properties"
• "Working with Controls"

• javax.naming for naming operations (access entries)
• javax.naming.directory for directory operations (access attributes)
• javax.naming.event for requesting event notification
• javax.naming.ldap for LDAP-specific features.

• adding the service provider to the CLASSPATH
• specifying the Netscape LDAP Service Provider as the JNDI context in your code.
• (Optional) adding the JNDI object schema to the Directory.

• ldapsp.jar, the Netscape LDAP Service Provider for JNDI
• ldapjdk.jar, the Netscape Directory SDK for Java 4.0 (required by the LDAP Service Provider)
• jndi.jar, the Java Naming and Directory Interface version 1.2.

Hashtable env = new Hashtable();

env.put(Context.INITIAL_CONTEXT_FACTORY, 
"com.netscape.jndi.ldap.LdapContextFactory");

/* Insert any additional "env.put(... ...)" statements

DirContext ctx = new InitialDirContext(env);

1. Stop the server
2. In the <server-root>/slapd-<id>/config/ directory, replace the java-object-schema.conf file with the one provided in the Netscape Directory SDK for Java.
3. Restart the server

1. Stop the server.
2. Copy the java-object-schema.conf file that is included with the Netscape Directory SDK for Java to the <server-root>/slapd-<id>/config directory.
3. Edit <server-root>/slapd-<id>/config/ns-schema.conf to include the following line:
   include <server-root>/slapd-<id>/config/java-object-schema.conf
4. Restart the server.

Netscape's LDAP Service Provider is implemented on top of the Directory SDK which means that any controls that are available in the SDK are also available through JNDI. These controls use the same API as the Directory SDK, except that they begin with "Ldap" instead of "LDAP." For instance, the SDK control LDAPSortControl is available as LdapSortControl in the Netscape LDAP Service Provider for JNDI.

import java.util.Hashtable;

import javax.naming.*;

import javax.naming.directory.*;

import javax.naming.ldap.*;

import com.netscape.jndi.ldap.controls.*;

public class SortReverseOrder {

   public static void main (String[] args) {

      Hashtable env = new Hashtable(5, 0.75f); 

      /** Specify the initial context implementation to use.*/ 

      env.put(Context.INITIAL_CONTEXT_FACTORY, 

      "com.netscape.jndi.ldap.LdapContextFactory"); 

      /* Specify host and port to use for directory service */ 

      env.put(Context.PROVIDER_URL, "ldap://localhost:389"); 

      LdapContext ctx = null; 

      try { 

         /* get a handle to an Initial DirContext */ 

         ctx = new InitialLdapContext(env, null); 

         /* specify search constraints to search subtree */ 

         SearchControls cons = new SearchControls(); 

         cons.setSearchScope(SearchControls.SUBTREE_SCOPE); 

         cons.setReturningAttributes(new String[] { "sn" }); 

         // specify sort control 

         ctx.setRequestControls( 

         new Control[] {new LdapSortControl( 

            new LdapSortKey[]{ 

               new LdapSortKey("sn", true, null)},Control.CRITICAL)}); 

         /* search for all entries of type "person" */ 

         NamingEnumeration results = ctx.search("o=mcom.com",

                                    "(objectclass=person)", cons); 

         /* for each entry print out name + all attrs and values */ 

         while (results != null && results.hasMore()) { 

            SearchResult si = (SearchResult)results.next(); 

            Attributes attrs = si.getAttributes(); 

         /* print each attribute */ 

         for (NamingEnumeration ae = attrs.getAll(); 

               ae.hasMoreElements();) { 

            Attribute attr = (Attribute)ae.next(); 

            String attrId = attr.getID(); 

            /* print each value */ 

            for (NamingEnumeration vals = attr.getAll();

               vals.hasMore(); 

               System.out.println(attrId + ": " + vals.next()));} 

               System.out.println(); 

            } 

         } 

         catch (NamingException e) { 

            System.err.println("Search example failed."); 

            e.printStackTrace(); 

         }

      finally {

         // cleanup 

         if (ctx != null) { 

            try { ctx.close(); } catch (Exception e) {} 

         } 

      } 

   } 

}