iaik.x509.net.ldap

Class Handler

java.lang.Object

java.net.URLStreamHandler

iaik.x509.net.ldap.Handler

public class Handler
extends java.net.URLStreamHandler

A protocol handler for the LDAP protocol. Used by the URL class to resolve ldap://... style URLs.

For using this Handler it has to be registered within the java.net URL framework. Regsitration can be performed in three different ways:

1. Use the java.protocol.handler.pkgs system property:

           System.getProperties().put("java.protocol.handler.pkgs", "iaik.x509.net");
           

2. Register the LdapURLStreamHandlerFactory for this handler:

           URL.setURLStreamHandlerFactory(new LdapURLStreamHandlerFactory());
           

3. If you are using JDK 1.2 or later you can specify the handler dynamically when creating an URL object, e.g.:

           URL u = new URL(null, "ldap://...", new iaik.x509.net.ldap.Handler());
           

   In this case the handler will be used for the one particular URL object only. Thus you may have to create all your ldap URLs in this way. Also note that you do not need to create a new Handler object each time, you can use the same for all URLs.

See Also:

LdapURLConnection, LdapURLStreamHandlerFactory

Constructor Summary

Constructors

Constructor and Description
Handler() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected int	getDefaultPort() Returns the default port (389) for LDAP urls.
protected java.net.URLConnection	openConnection(java.net.URL url) Creates an LdapURLConnection object to be used for connecting to the ldap server specified by the given URL argument.

Methods inherited from class java.net.URLStreamHandler

equals, getHostAddress, hashCode, hostsEqual, openConnection, parseURL, sameFile, setURL, setURL, toExternalForm

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Handler

public Handler()

Default constructor. Creates a new LDAP Handler object.

Method Detail

openConnection

protected java.net.URLConnection openConnection(java.net.URL url)
                                         throws java.io.IOException

Creates an LdapURLConnection object to be used for connecting to the ldap server specified by the given URL argument. This method is used by the java.net URL framework and typically will not be called immediately by an application.

Specified by:

openConnection in class java.net.URLStreamHandler

Parameters:

url - the URL to which to connect to

Returns:

an LdapURLConnection object for the given URL.

Throws:

java.io.IOException - if an I/O error occurs while creating the LdapURLConnection

getDefaultPort

protected int getDefaultPort()

Returns the default port (389) for LDAP urls.

Overrides:

getDefaultPort in class java.net.URLStreamHandler

Returns:

389