kaos.core.csi.registration
Class RegistrationImpl

java.lang.Object
  extended by kaos.core.csi.registration.RegistrationImpl
All Implemented Interfaces:
DirectoryRegistration, DomainHierarchyConfiguration, DomainRegistration, GroupRegistration, Registration, SpatialRegistration, DirectoryEventNotifier

public class RegistrationImpl
extends java.lang.Object
implements Registration

This class implements the Registration interface, which efines the operations to register and deregister entities and entity hosting environments in the KAoS Directory Service and operations to modify the registration information. It also defines operations to register entitites in KAoS Domains and to maintain domain hierarchy. $Revision: 1.42 $


Method Summary
 void addChildToDomain(DomainDescription domain, DomainDescription childDomain)
          Add the childDomain as a child of the specified domain.
 void addEventListener(DirectoryEventListener listener)
           
 ModificationType addGroupLeader(java.lang.String actorId, java.lang.String groupURI)
          Adds the specified actor as a leader of the given group.
 void addRemoteEventListener(Locator l)
           
 KAoSAgentDescription createKAoSAgentDescription(java.lang.String guid, java.lang.String nickname, java.util.List<java.lang.String> domainNames, java.util.List<AgentCapability> agentCapabilities, java.lang.String transportName, JasBean agentInitInfo)
          Create an instance of the KAoSAgentDescription as simpler method createKAoSAgentDescription but additionally specifies agent capabilities
 KAoSAgentDescription createKAoSAgentDescription(java.lang.String guid, java.lang.String nickname, java.util.List<java.lang.String> domainNames, java.lang.String transportName, JasBean agentInitInfo)
          Create an instance of the KAoSAgentDescription using the given parameters.
 void deregisterEntity(AgentDescription entityDescription)
          Deregister the entity described by the given AgentDescription from the KAoS Directory Service.
 KAoSEntityDescription deregisterEntityFromDomain(DomainDescription domain, KAoSEntityDescription entityDesc)
          Deregister the entity described by the given KAoSEntityDescription from the specified domain.
 void deregisterEntityHostingEnv(EntityHostEnvDescription eheDescription)
          Deregister the entity hosting environment described by the given EntityHostEnvDescription from the KAoS Directory Service.
 void deregisterObjectWithSpatialProperties(java.lang.String objectID)
          Deregister object identified by the given objectID and its spatial properties in the SpatialReasoner.
 AgentConfiguration getAgentConfiguration()
           
 AgentConfiguration getAgentConfiguration(java.lang.String configFile)
           
static Registration getInstance()
           
static Registration getInstance(java.lang.String transportName)
           
protected  void logMessage(java.lang.String msg, java.lang.Exception e, int logLevel)
           
protected  void logMessage(java.lang.String msg, int logLevel)
           
static void main(java.lang.String[] args)
           
 void modifyEntityProperties(java.lang.String entityGUID, java.util.List properties)
          Modify properties of the entity identified by the given entityGUID.
 void modifyEntitySpatialProperties(java.lang.String entityGUID, Location3D objectLocation, Orientation3D objectOrientation, Block3D objectOccupiedSpace)
          Modify given spatial properties of the entity identified by the given entityGUID in the KAoS Directory Service *AND* the SpatialReasoner.
 void modifyObjectSpatialProperties(java.lang.String objectID, Location3D objectLocation, Orientation3D objectOrientation, Block3D objectOccupiedSpace)
          Modify spatial properties of the object identified by the given objectID in the SpatialReasoner.
 void registerDomain(java.lang.String domainName)
          Register domain with the given name in the KAoS Directory Service.
 void registerDomain(java.lang.String domainName, java.lang.String modality)
          Register domain with the given name in the KAoS Directory Service.
 void registerEntity(AgentDescription entityDescription, boolean guarded, boolean replace)
          Register the entity described by the given AgentDescription in the KAoS Directory Service.
 void registerEntityHostingEnv(EntityHostEnvDescription eheDescription, boolean guarded, boolean replace)
          Register the entity hosting environment described by the given EntityHostEnvDescription in the KAoS Directory Service.
 KAoSEntityDescription registerEntityInDomain(DomainDescription domain, KAoSEntityDescription entityDesc)
          Register the entity described by the given KAoSEntityDescription in the specified domain.
 void registerEntityWithProperties(AgentDescription entityDescription, java.util.List properties, boolean guarded, boolean replace)
          Register the entity described as simpler method registerEntity but also register properties of this agent
 void registerEntityWithSpatialProperties(AgentDescription entityDescription, Location3D objectLocation, Orientation3D objectOrientation, Block3D objectOccupiedSpace, boolean guarded, boolean replace)
          Register the entity as the simpler method registerEntity but also its spatial properties in the KAoS Directory Service *AND* the SpatialReasoner.
 void registerObjectWithSpatialProperties(java.lang.String objectID, java.util.Set objectOntologyTypes, Location3D objectLocation, Orientation3D objectOrientation, Block3D objectOccupiedSpace)
          Register object identified by the given objectID and its spatial properties in the SpatialReasoner.
 void registerObjectWithSpatialProperties(java.lang.String objectID, java.util.Set objectOntologyTypes, Orientation3D objectOrientation, java.util.Vector<Location3D> boundingPoints)
          Register object identified by the given objectID and its spatial properties in the SpatialReasoner.
 void removeChildFromDomain(DomainDescription domain, DomainDescription childDomain)
          Add the childDomain as a child of the specified domain.
 void removeEventListener(DirectoryEventListener listener)
           
 ModificationType removeGroupLeader(java.lang.String actorId, java.lang.String groupURI)
          Remove the specified actor as a leader of the given group.
 void removeRemoteEventListener(Locator l)
           
 void setParentForDomain(DomainDescription domain, DomainDescription parentDomain)
          Set as a the parent the given parentDomain for the specified domain.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static Registration getInstance(java.lang.String transportName)
                                throws java.lang.Exception
Throws:
java.lang.Exception

getInstance

public static Registration getInstance()
                                throws java.lang.Exception
Throws:
java.lang.Exception

registerDomain

public void registerDomain(java.lang.String domainName,
                           java.lang.String modality)
                    throws DirectoryFailure,
                           AlreadyRegisteredException
Description copied from interface: DirectoryRegistration
Register domain with the given name in the KAoS Directory Service.

Specified by:
registerDomain in interface DirectoryRegistration
Parameters:
domainName - String containing the name of domain to register.
modality - String containing the default policy authorization result if no policies apply [PolicyConcepts.PosAuthorizationPolicy()=laissez-faire or PolicyConcepts.NegAuthorizationPolicy()=tyrannical].
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
AlreadyRegisteredException - if the registering domain has been already registered in the DS

registerDomain

public void registerDomain(java.lang.String domainName)
                    throws DirectoryFailure,
                           AlreadyRegisteredException
Description copied from interface: DirectoryRegistration
Register domain with the given name in the KAoS Directory Service.

Specified by:
registerDomain in interface DirectoryRegistration
Specified by:
registerDomain in interface DomainRegistration
Parameters:
domainName - String containing the name of domain to register.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
AlreadyRegisteredException - if the registering domain has been already registered in the DS

registerEntity

public void registerEntity(AgentDescription entityDescription,
                           boolean guarded,
                           boolean replace)
                    throws DirectoryFailure,
                           AlreadyRegisteredException,
                           GuardInstantiationException
Description copied from interface: DirectoryRegistration
Register the entity described by the given AgentDescription in the KAoS Directory Service.

Specified by:
registerEntity in interface DirectoryRegistration
Parameters:
entityDescription - AgentDescription is the JAS AgentDescription, whose subclasses describe the various types of entities to be registered in KAoS: agents, guards, domains, containers. Those entities are subjects to policies or potential subjects to policies, or the entities are using KAoS for messaging.
guarded - boolean indicating the guarded/unguarded status for agents and containers. If the entity is to be guarded, the implementation of this method will instantiate a guard, or check if a guard already exists and proceed with the registration via the guard.
replace - boolean indicating whether to replace existing AgentDescription.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
AlreadyRegisteredException - if the registering entity has been already registered in the DS (if the replace = false and there is already registration for the specified AgentDescription).
GuardInstantiationException

registerEntityWithSpatialProperties

public void registerEntityWithSpatialProperties(AgentDescription entityDescription,
                                                Location3D objectLocation,
                                                Orientation3D objectOrientation,
                                                Block3D objectOccupiedSpace,
                                                boolean guarded,
                                                boolean replace)
                                         throws DirectoryFailure,
                                                AlreadyRegisteredException,
                                                GuardInstantiationException
Description copied from interface: SpatialRegistration
Register the entity as the simpler method registerEntity but also its spatial properties in the KAoS Directory Service *AND* the SpatialReasoner.

Specified by:
registerEntityWithSpatialProperties in interface SpatialRegistration
objectLocation - Location3D containing the X,Y,Z coordinates of the registering entity.
objectOrientation - Orientation3D containing the X,Y,Z radius of the registering entity.
objectOccupiedSpace - Block3D containing corner locations determining the occupied space of the registering entity.
Throws:
DirectoryFailure
AlreadyRegisteredException
GuardInstantiationException

registerObjectWithSpatialProperties

public void registerObjectWithSpatialProperties(java.lang.String objectID,
                                                java.util.Set objectOntologyTypes,
                                                Location3D objectLocation,
                                                Orientation3D objectOrientation,
                                                Block3D objectOccupiedSpace)
                                         throws DirectoryFailure,
                                                AlreadyRegisteredException
Description copied from interface: SpatialRegistration
Register object identified by the given objectID and its spatial properties in the SpatialReasoner. Important: Note that the object is *not* registered in the KAoS DirectoryService, only in the SpatialReasoner. If you want to register a given object in the KAoS Directory service, use method registerEntityWithSpatialProperties(), which will do both, register in the KAoS DS and the SpatialReasoner.

Specified by:
registerObjectWithSpatialProperties in interface SpatialRegistration
Parameters:
objectID - String uniquely identifying registering object in the SpatialReasoner.
objectOntologyTypes - Set containing Strings describing the ontological types of the registering object in the SpatialReasoner.
objectLocation - Location3D containing the X,Y,Z coordinates of the registering object.
objectOrientation - Orientation3D containing the X,Y,Z radius of the registering object.
objectOccupiedSpace - Block3D containing corner locations determining the occupied space of the registering object.
Throws:
DirectoryFailure - if the connection to the SpatialReasoner cannot be established.
AlreadyRegisteredException - if the registering object has been already registered in the SpatialReasoner.

registerObjectWithSpatialProperties

public void registerObjectWithSpatialProperties(java.lang.String objectID,
                                                java.util.Set objectOntologyTypes,
                                                Orientation3D objectOrientation,
                                                java.util.Vector<Location3D> boundingPoints)
                                         throws DirectoryFailure,
                                                AlreadyRegisteredException
Description copied from interface: SpatialRegistration
Register object identified by the given objectID and its spatial properties in the SpatialReasoner. Important: Note that the object is *not* registered in the KAoS DirectoryService, only in the SpatialReasoner. If you want to register a given object in the KAoS Directory service, use method registerEntityWithSpatialProperties(), which will do both, register in the KAoS DS and the SpatialReasoner.

Specified by:
registerObjectWithSpatialProperties in interface SpatialRegistration
Parameters:
objectID - String uniquely identifying registering object in the SpatialReasoner.
objectOrientation - Orientation3D containing the X,Y,Z radius of the registering object.
boundingPoints - An ordered List of points used to define the objects boundary. Location should then be defined as the average of the points. Occupied Space should be the max and min of the points along each axis.
Throws:
DirectoryFailure - if the connection to the SpatialReasoner cannot be established.
AlreadyRegisteredException - if the registering object has been already registered in the SpatialReasoner.

deregisterObjectWithSpatialProperties

public void deregisterObjectWithSpatialProperties(java.lang.String objectID)
                                           throws DirectoryFailure,
                                                  NotRegisteredException
Description copied from interface: SpatialRegistration
Deregister object identified by the given objectID and its spatial properties in the SpatialReasoner. Important: Note that the object is *not* deregistered from the KAoS DirectoryService, only from the SpatialReasoner.

Specified by:
deregisterObjectWithSpatialProperties in interface SpatialRegistration
Parameters:
objectID - String uniquely identifying registering object in the SpatialReasoner.
Throws:
DirectoryFailure - if the connection to the SpatialReasoner cannot be established.
NotRegisteredException - if the registering object has not been registered in the SpatialReasoner.

registerEntityWithProperties

public void registerEntityWithProperties(AgentDescription entityDescription,
                                         java.util.List properties,
                                         boolean guarded,
                                         boolean replace)
                                  throws DirectoryFailure,
                                         AlreadyRegisteredException,
                                         GuardInstantiationException
Description copied from interface: DirectoryRegistration
Register the entity described as simpler method registerEntity but also register properties of this agent

Specified by:
registerEntityWithProperties in interface DirectoryRegistration
properties - List of Property objects further describing the registering entity.
Throws:
DirectoryFailure
AlreadyRegisteredException
GuardInstantiationException

registerEntityHostingEnv

public void registerEntityHostingEnv(EntityHostEnvDescription eheDescription,
                                     boolean guarded,
                                     boolean replace)
                              throws DirectoryFailure,
                                     AlreadyRegisteredException,
                                     GuardInstantiationException
Description copied from interface: DomainRegistration
Register the entity hosting environment described by the given EntityHostEnvDescription in the KAoS Directory Service.

Specified by:
registerEntityHostingEnv in interface DomainRegistration
Parameters:
eheDescription - EntityHostEnvDescription describes the hosting environment for agents and guards.
guarded - boolean indicating the guarded/unguarded status for the environment. If the hosted environemnt is to be guarded, the implementation of this method will instantiate a guard, or check if a guard already exists and proceed with the registration via the guard.
replace - boolean indicating whether to replace existing EntityHostEnvDescription.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
AlreadyRegisteredException - if the registering hosting environment has been already registered in the DS (if the replace = false and there is already registration for the specified EntityHostEnvDescription).
GuardInstantiationException

modifyEntityProperties

public void modifyEntityProperties(java.lang.String entityGUID,
                                   java.util.List properties)
                            throws DirectoryFailure,
                                   NotRegisteredException,
                                   ModificationException
Description copied from interface: DirectoryRegistration
Modify properties of the entity identified by the given entityGUID.

Specified by:
modifyEntityProperties in interface DirectoryRegistration
Parameters:
entityGUID - String containing the entity GUID.
properties - List of Properties to be modified. Each Property contains the name, value, value description, modification type (add/remove/set, etc), modification result. Refer to the Property and ModificationResult interfaces for detailed description.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the entity whose properties are to be modified has not been registered in the DS.
ModificationException - if one or more property update failed.

modifyEntitySpatialProperties

public void modifyEntitySpatialProperties(java.lang.String entityGUID,
                                          Location3D objectLocation,
                                          Orientation3D objectOrientation,
                                          Block3D objectOccupiedSpace)
                                   throws DirectoryFailure,
                                          NotRegisteredException,
                                          ModificationException
Description copied from interface: SpatialRegistration
Modify given spatial properties of the entity identified by the given entityGUID in the KAoS Directory Service *AND* the SpatialReasoner.

Specified by:
modifyEntitySpatialProperties in interface SpatialRegistration
Parameters:
entityGUID - String containing the entity GUID.
objectLocation - modified Location3D containing the X,Y,Z coordinates of the entity.
objectOrientation - modified Orientation3D containing the X,Y,Z radius of the entity.
objectOccupiedSpace - modified Block3D containing corner locations determining the occupied space of the entity.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the entity whose properties are to be modified has not been registered in the DS.
ModificationException - if one or more property update failed.

modifyObjectSpatialProperties

public void modifyObjectSpatialProperties(java.lang.String objectID,
                                          Location3D objectLocation,
                                          Orientation3D objectOrientation,
                                          Block3D objectOccupiedSpace)
                                   throws DirectoryFailure,
                                          NotRegisteredException
Description copied from interface: SpatialRegistration
Modify spatial properties of the object identified by the given objectID in the SpatialReasoner. Important: Note that the properties are *not* modified in the KAoS DirectoryService, only in the SpatialReasoner. If you want to modify properties of a given object in the KAoS Directory service, use method modifyEntitySpatialProperties(), which will do both, modify in the KAoS DS and the SpatialReasoner.

Specified by:
modifyObjectSpatialProperties in interface SpatialRegistration
Parameters:
objectID - String uniquely identifying object, whose spatial properties will be modified in the SpatialReasoner.
objectLocation - modified Location3D containing the X,Y,Z coordinates of the entity.
objectOrientation - modified Orientation3D containing the X,Y,Z radius of the entity.
objectOccupiedSpace - modified Block3D containing corner locations determining the occupied space of the entity.
Throws:
DirectoryFailure - if the connection to the SpatialReasoner cannot be established.
NotRegisteredException - if the object, whose properties are to be modified has not been registered in the SpatialReasoner.

deregisterEntity

public void deregisterEntity(AgentDescription entityDescription)
                      throws DirectoryFailure,
                             NotRegisteredException
Description copied from interface: DirectoryRegistration
Deregister the entity described by the given AgentDescription from the KAoS Directory Service.

Specified by:
deregisterEntity in interface DirectoryRegistration
Parameters:
entityDescription - AgentDescription of the entity to be deregistered.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the entity to be deregistered has not been registered in the DS.

deregisterEntityHostingEnv

public void deregisterEntityHostingEnv(EntityHostEnvDescription eheDescription)
                                throws DirectoryFailure,
                                       NotRegisteredException
Description copied from interface: DomainRegistration
Deregister the entity hosting environment described by the given EntityHostEnvDescription from the KAoS Directory Service.

Specified by:
deregisterEntityHostingEnv in interface DomainRegistration
Parameters:
eheDescription - EntityHostEnvDescription of the entity hosting environment to be deregistered.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the entity to be deregistered has not been registered in the DS.

getAgentConfiguration

public AgentConfiguration getAgentConfiguration()
Specified by:
getAgentConfiguration in interface Registration

getAgentConfiguration

public AgentConfiguration getAgentConfiguration(java.lang.String configFile)
Specified by:
getAgentConfiguration in interface Registration

createKAoSAgentDescription

public KAoSAgentDescription createKAoSAgentDescription(java.lang.String guid,
                                                       java.lang.String nickname,
                                                       java.util.List<java.lang.String> domainNames,
                                                       java.lang.String transportName,
                                                       JasBean agentInitInfo)
Description copied from interface: DirectoryRegistration
Create an instance of the KAoSAgentDescription using the given parameters.

Specified by:
createKAoSAgentDescription in interface DirectoryRegistration
Parameters:
guid - String containing the globally unique identifier for the agent, or null. If null is passed, then the Agent Naming Service will create the identifier.
nickname - String containing agent's nickname.
domainNames - Vector containing the names of the domains the agent will become a member of.
transportName - String specifying the name of the transport the agent wants to use, or null. If null is specified, then the Locators will be empty.

createKAoSAgentDescription

public KAoSAgentDescription createKAoSAgentDescription(java.lang.String guid,
                                                       java.lang.String nickname,
                                                       java.util.List<java.lang.String> domainNames,
                                                       java.util.List<AgentCapability> agentCapabilities,
                                                       java.lang.String transportName,
                                                       JasBean agentInitInfo)
Description copied from interface: DirectoryRegistration
Create an instance of the KAoSAgentDescription as simpler method createKAoSAgentDescription but additionally specifies agent capabilities

Specified by:
createKAoSAgentDescription in interface DirectoryRegistration

registerEntityInDomain

public KAoSEntityDescription registerEntityInDomain(DomainDescription domain,
                                                    KAoSEntityDescription entityDesc)
                                             throws DirectoryFailure
Description copied from interface: DomainRegistration
Register the entity described by the given KAoSEntityDescription in the specified domain.

Specified by:
registerEntityInDomain in interface DomainRegistration
Parameters:
domain - DomainDescription describing the domain, in which to register the given entity.
entityDesc - KAoSEntityDescription describes the entity to be registered in the given domain.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.

deregisterEntityFromDomain

public KAoSEntityDescription deregisterEntityFromDomain(DomainDescription domain,
                                                        KAoSEntityDescription entityDesc)
                                                 throws DirectoryFailure,
                                                        NotRegisteredException
Description copied from interface: DomainRegistration
Deregister the entity described by the given KAoSEntityDescription from the specified domain.

Specified by:
deregisterEntityFromDomain in interface DomainRegistration
Parameters:
domain - DomainDescription describing the domain, from which to deregister the given entity.
entityDesc - KAoSEntityDescription describes the entity to be deregistered from the given domain.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the deregistering entity has not been registered in the the given domain.

setParentForDomain

public void setParentForDomain(DomainDescription domain,
                               DomainDescription parentDomain)
                        throws DirectoryFailure,
                               HasParentException
Description copied from interface: DomainHierarchyConfiguration
Set as a the parent the given parentDomain for the specified domain.

Specified by:
setParentForDomain in interface DomainHierarchyConfiguration
Parameters:
domain - DomainDescription describes the domain, whose parent is to be updated.
parentDomain - DomainDescription describes the parent domain.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
HasParentException - if the specified domain has already a parent.

addChildToDomain

public void addChildToDomain(DomainDescription domain,
                             DomainDescription childDomain)
                      throws DirectoryFailure,
                             HasParentException
Description copied from interface: DomainHierarchyConfiguration
Add the childDomain as a child of the specified domain.

Specified by:
addChildToDomain in interface DomainHierarchyConfiguration
Parameters:
domain - DomainDescription describes the domain, to which the childDomain will be added.
childDomain - DomainDescription describes the child domain.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
HasParentException - if the specified child domain has already a parent.

removeChildFromDomain

public void removeChildFromDomain(DomainDescription domain,
                                  DomainDescription childDomain)
                           throws DirectoryFailure,
                                  NotRegisteredException
Description copied from interface: DomainHierarchyConfiguration
Add the childDomain as a child of the specified domain.

Specified by:
removeChildFromDomain in interface DomainHierarchyConfiguration
Parameters:
domain - DomainDescription describes the domain, from which to remove the child domain.
childDomain - DomainDescription describes the child domain to be removed.
Throws:
DirectoryFailure - if the connection to the DS cannot be established.
NotRegisteredException - if the specified domain does not have the specified child domain as a child.

addGroupLeader

public ModificationType addGroupLeader(java.lang.String actorId,
                                       java.lang.String groupURI)
                                throws NotRegisteredException,
                                       DirectoryFailure,
                                       ModificationException
Description copied from interface: GroupRegistration
Adds the specified actor as a leader of the given group. Sets values in the ontology service for both the Group.hasLeader and Actor.isLeaderOf properties.

Specified by:
addGroupLeader in interface GroupRegistration
Parameters:
actorId - - unique identifier of the Actor (Agent) individual to be set as the leader
Returns:
Throws:
NotRegisteredException
DirectoryFailure
ModificationException

removeGroupLeader

public ModificationType removeGroupLeader(java.lang.String actorId,
                                          java.lang.String groupURI)
                                   throws NotRegisteredException,
                                          DirectoryFailure,
                                          ModificationException
Description copied from interface: GroupRegistration
Remove the specified actor as a leader of the given group. Clears values in the ontology service for both the Group.hasLeader and Actor.isLeaderOf properties.

Specified by:
removeGroupLeader in interface GroupRegistration
Parameters:
actorId - - unique identifier of the Actor (Agent) individual to be removed as the leader
Returns:
Throws:
NotRegisteredException
DirectoryFailure
ModificationException

logMessage

protected void logMessage(java.lang.String msg,
                          int logLevel)

logMessage

protected void logMessage(java.lang.String msg,
                          java.lang.Exception e,
                          int logLevel)

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception
Throws:
java.lang.Exception

addEventListener

public void addEventListener(DirectoryEventListener listener)
                      throws DirectoryFailure
Specified by:
addEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

addRemoteEventListener

public void addRemoteEventListener(Locator l)
                            throws DirectoryFailure
Specified by:
addRemoteEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

removeEventListener

public void removeEventListener(DirectoryEventListener listener)
                         throws DirectoryFailure
Specified by:
removeEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

removeRemoteEventListener

public void removeRemoteEventListener(Locator l)
                               throws DirectoryFailure
Specified by:
removeRemoteEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure