Package cnrg.itx.ds

Provides classes and interfaces for the directory "lookup"services.

See:
          Description

Class Summary
ArrayRecords This class is used to hold returned record entries from the directory database
CustomLocation This class represents a list of locations with user-specified time interval.
CustomLocationRecord This class is used to hold customLocationID-customLocation pair retrieved from the directory server.
Digits This class provides an abstraction to digits
DirectoryService This class provides clients an interface to communicate with the directory server.
DSComm This class is an inteface to the java native methods talking to the directory server.
Location This class provides a abstraction of where the application or system is located.
LocationList This class represents a list of locations.
Password This class provides an encapsulation to store user's password information.
UserID This class provides an abstraction to identify a user uniquely
UserProperty This class stores information on userID, extension, roaming location (if any), and custom message.
 

Exception Summary
AccessDeniedException This class represents an access-denied exception thrown by the directory service.
AuthenticationException This class represents an authentication exception thrown by the directory service.
DirectoryServiceException This base class represents an exception thrown by the directory service.
RecordAlreadyExistsException This class represents a record-already-exists exception thrown by the directory service.
RecordNotFoundException This class represents a record-not-found exception thrown by the directory service.
 

Package cnrg.itx.ds Description

Provides classes and interfaces for the directory "lookup"services. The client-server framework allows a user on his/her ITX application, which contain directory service component, to transparently find other users in the ITX network by query through the directory server. The directory service layer is completely hidden from the ITX application layer, so that only the signaling layer is responsible for interfacing with the directory service. Alternatively, ITX application layer can directly use the functionality of the directory service by getting its handle through the signaling component.

The main interface to use the directory service is cnrg.itx.ds.DirectoryService. To use the directory service component, the user needs to authenticate himself/herself by calling the DirectoryService.declareIdentity method. Upon authentication successful, the user can lookup his/her user information (e.g. extension number, access level, custom message, etc.), manipulate his/her locations information (e.g. default and customized location), change his/her password, lookup all registered users in the ITX network, and reach them by their extension number or userID.

Administrator using the directory service is provided with a management interface to add or remove a user from the ITX network.

Currently the directory service uses BIND as its database, if it is desired to use another database, the programmer should inherit the DSComm class and override the included methods.