Department of Computer Science

COMP212 - 2025 - CA Assignment 2

Distributed Communications

Java RMI

Assessment Information

1 Overall marking scheme

The coursework for COMP212 consists of two assignments contributing altogether 30% of the final mark. The contribution of the individual assignments is as follows:

Assignment 1    15%

Assignment 2    15%

TOTAL            30%

2 Objectives

This assignment requires you to write a Java program implementing client-server communi- cation using Remote Method Invocation (RMI).

3 Explanation of coursework

Imagine you are designing a distributed voting application:  While the server is running, a client can connect to the server and vote for 1 out of 3 choices (by means of the method vote, see below). After voting, the client can request the voting results so far.

3.1 Basic Java RMI communication—50% of the assignment mark

As a first step, you are required to implement client-server communication only. At this stage you can ignore the program logic, but you should show some evidence that your program works and that communication between the client and server actually takes place.

For your convenience, we suggest the following remote object interface (however, feel free to modify it to your needs):

castVote. java:

interface  castVote  extends  java. rmi. Remote  {

public  void  vote  (int  choice)  throws  java. rmi. RemoteException;

public  String  getVotingResults()  throws  java. rmi. RemoteException;

}

You must implement the following classes.

3.1.1 Class castVoteImp.java

This class should implement the castVote interface.

3.1.2 Server side

The server should initiate and register the remote object.

3.1.3 Client side

The client should submit the user choice to the remote server and then print the current vote and voting results on screen.

Hint. Start with downloading the RMI example from CANVAS under the “Assessment Submission/Assignment 2 Description”.  Following the instructions, make sure it works on your computer. Then use that code as a basis for your implementation.

3.2 Program logic—50% of the assignment mark

To get further 30%, you need to implement the remote object, the counting of votes and re- turning voting results, and also implement the client side functionality.  To get the remaining 20%, you need to extend the communication model to make sure that the server will only allow a client to see the current voting results after submitting its own vote.

Hint. Such a functionality can be achieved, for example, by assigning to every client a ticket (a randomly generated integer number).  A client without a ticket will be denied all communication.  A client first requests a ticket from the server and then passes this ticket as an extra parameter to all remote methods.  When the server issues a ticket, it saves the ticket to a data structure (for example, a hash table) so that all remote methods (vote, getVotingResults, etc) will be able to check that the ticket is valid.

You are more than welcome to suggest your own method to control the right order of calls.

4 Deadline and Submission Instructions

● The deadline for submitting this assignment is Thursday, 3rd April 2025,  17:00 UK time.

● Submit

(a)  The Java source code for all your programs and

(b) A README file (plain text) describing how to compile/run your code to repro- duce the various results required by the assignment.

Compress all of the above files into a single ZIP file (the electronic submission system won’t accept any other file formats) and specify the filename as Surname-Name- ID.zip.  The zip should contain all the appropriate  .java and  .class files of the client side and server side in two separate directories, one for the client code and the other for the server code.  Each directory should contain all the necessary files to run the client/server program including the interface file.  Avoid packages and IDE-generated templates in the submitted version, as they typically cause problems with compiling or executing your code:  we should  be able to compile and execute your code using a command prompt and following your instructions in the readme file.  Also, please make the client and server run on the same host (localhost) in order to facilitate the execution of the code on our computers. It is extremely important that you adhere to the required format of submission, otherwise we may encounter difficulties in executing and assessing your program!

● Submission is via the “Assignments” tab of COMP212-202425 course on CANVAS.