Package | Class | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## 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
AuthenticateRecord | This class is used to hold a record (of security database zone file) from the directory server.
CleanUpThread | CleanUpThread is used to remove from the directory database server invalid dynamic location(s) of the user authenticated with the DirectoryService object.
CustomerRecord | This class is used to hold a record (of user database zone file) from the directory server.
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.
DirectoryStub | This class provides directory service object a communication mechanism to the remote named servers.
DSComm | This class is an inteface to the java native methods talking to the directory server.
Element | Element class provides support for list data structure to interface with the node element.
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.

Package | Class | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES