com.novell.ldap.events.edir
Class EdirEventSource

java.lang.Object
  com.novell.ldap.events.LDAPEventSource
      com.novell.ldap.events.edir.EdirEventSource

public class EdirEventSource

extends LDAPEventSource

This class act as a source for all the Edirectory Events. The class contains method for eventregisteration (registerforEvent() and registerforFilterevent()) and removal of events listening(removeListener()). The events are generated for a generic LDAPListener interface. .

Each of the method specified throws an IllegalArgumentException if the arguments are null.

Nested Class Summary

Nested classes inherited from class com.novell.ldap.events.LDAPEventSource

LDAPEventSource.EventsGenerator

Constructor Summary

EdirEventSource()
Default Constructor for this class.

Method Summary

void	registerforEvent(EdirEventSpecifier[] specifier, LDAPConnection conn, LDAPEventListener alistener) This method is use to register for Edirectory Events by the given Listener.
void	registerforFilterEvent(EdirEventSpecifier[] specifier, LDAPConnection conn, LDAPEventListener alistener) This method is use to register for Edirectory Events by the given Listener.It also specifies a Filter (Search Filter) which are used to filter the events on the server side.The events generated after registration would include this EdirEventSource as the EventSource.
void	removeListener(LDAPEventListener alistener) Removes a listener from receiving Edirectoryevents fired by this class.The listener may have registered more than once with this EdirEventSource, perhaps with different events request arguments.

Methods inherited from class com.novell.ldap.events.LDAPEventSource

createListeningThread, getSleepTime, pollforevents, setSleepTime, stopeventpolling

Methods inherited from class java.lang.Object

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

Constructor Detail

EdirEventSource

public EdirEventSource()
                throws LDAPException

Default Constructor for this class.

Throws:

LDAPException - When intialization fails.

Method Detail

removeListener

public void removeListener(LDAPEventListener alistener)
                    throws LDAPException

Removes a listener from receiving Edirectoryevents fired by this class.The listener may have registered more than once with this EdirEventSource, perhaps with different events request arguments. After this method is invoked, the listener will no longer receive events with this EdirEvent instance as the event source (except for those events already in the process of being dispatched).

Parameters:

alistener - Removes the listener from receiving the events fired by this EdirEventSource.

Throws:

LDAPException - If problem is encountered while removing the listener or the listener is not registered for any event.

registerforEvent

public final void registerforEvent(EdirEventSpecifier[] specifier,
                                   LDAPConnection conn,
                                   LDAPEventListener alistener)
                            throws LDAPException

This method is use to register for Edirectory Events by the given Listener. The events generated after registration would include this EdirEventSource as the EventSource.

Parameters:

specifier - EdirEventSpecifier is used to specify the event type to generate.

conn - LDAPConnection Object used to connect to server.

alistener - The LDAPEventListener for receiving the events.

Throws:

LDAPException - When the LDAP operation fails.

registerforFilterEvent

public final void registerforFilterEvent(EdirEventSpecifier[] specifier,
                                         LDAPConnection conn,
                                         LDAPEventListener alistener)
                                  throws LDAPException

This method is use to register for Edirectory Events by the given Listener.It also specifies a Filter (Search Filter) which are used to filter the events on the server side.The events generated after registration would include this EdirEventSource as the EventSource.

Parameters:

specifier - EdirEventSpecifier is used to specify the event type to generate.

conn - LDAPConnection Object used to connect to server.

alistener - The LDAPEventListener for receiving the events.

Throws:

LDAPException - When the LDAP operation fails.