This assignment consists of three projects:
- Records Management { Models, Server, Utility }
- Web Service { Wrapper { Server, Client }, Server Deployable, Client Executable }
The deisgn follows a pseudo MVC style layout since the main data storage elements will be re-used for the future assignments; this concept was extended to the RegionalServer implmentation which has now been moved into the base project since all ofthe manipulation of the RecordsMap and Server-Server UDP communication is common but may require more functionality. This means the controllers are simple wrapper that only contain the web service implementation and test code.
All of the models defined are sthe exact same from CORBA implementation
| Class | Description |
|---|---|
| Feild | Indicats the possible feild names which can be edited |
| Region | Enum to handle the prefixing, name and port for any region |
| ProjectIdentifier | Contains all the formatting of a project ID |
| Project | Contains a ProjectIdentifier and other information to define a project |
| RecordType | Enum to help with ID formatting and identification |
| RecordIdentifier | Contains all the formatting and management for an ID |
| Record | Contains the RecordIdentifier and all the required feilds to record a human |
| ManagerRecord | Specialization for a managers record with all information |
| EmployeeRecord | Specialization for an employee record with all information |
| RecordsMap | Hashmap of linked list of records with access control |
Just a little file and console logging utilty to make this easier
Nothing has changed from the RMI implementation with zero code duplication
This package handles all the implementation details for the server for the UDP server-server communication. The servers use a stripped down custom protocol I developped at work; its and operation code and data segment seperated by a CRLF inspired by HTTP.
| Class | Description |
|---|---|
| OperationCode | Various operation performed between the servers |
| Message | Custom format of a message with translation to Datagram packet |
| RegionalServer | This is the RMI implementation of the interface on the server side and access all the specialized modules |
| RequestListener | UDP server to receive requests from other servers with a listener for callback to answer them |
| RecordUuidTracker | This component talks to the other servers to determine the next available ID; used when creating new records. |
| RecordTransferAgent | Manages all the stages required for transfering a record. |
Together these are used to define the implement the simple "Send and Wait" protocol providing an at least once execution of requests.
Main UDP server which waits for incomming messages from the other servers. Defines a callback interface to obtain the data for the responses from an owner of a RecordsMap. This only handles UDP communication. The interface is implemented by RegionalServer.
This component tracks the "next ID to use" for Employees or Managers; when creating a new record it initiates communication with the other servers to agree upon the next ID to use.
Thid object is responsible for transfering a record to a remote server. It ensures the record does not exist, attempts the transfer and validates the completion of the transfer.
this is the main Server object which was two main roles:
- Control a
RecordsMapto garauntees data consistency with many concurrent clients/requests - Perform communication with the other servers. Mostly done using the objects above; only
getRecordCount()is implemented in this class.
The main web application simply starts three RegionalServer one for each region { Canada, United-States, and the United-Kingdom } and dispatches all incomming requests to the correct location based on the Human Resource Manager's ID.
This project has the web client implemntation, which is generated with a small wrapper for login validation and logging. The main executable contains the control logic to allows a Human Resource Manager to accessthe system and to provide the information required to perform the various operations.
- Create manager record
- Create employee record
- Edit an existing record
- Transfer record to remote location
- Display total number of records