Mercurys is a side-project I've been working on in between my studies. It's essentially a console-based chat application that uses a simple Socket connection to transmit and receive data.
- Uses a custom encryption-decryption algorithm [developed by myself]
- Uses multi-threading to simultaneously read and write messages
- Users can send and receive files
- Works on a LAN connection [as of yet]
It's quite simple to get the server/client connection up and running:
The first step is to download the project and open it in any IDE.
For hosting the server:
- Compile and run the MercurysServer.java file
[project-mercurys/src/com/mercurys/MercurysServer.java] - Enter the device LAN IP address and the server name [it can be anything] when prompted
- The server has now been initialised, and it will wait for a client to request a connection
- Once a client socket has connected to the IP entered in step 3, the program should display a confirmatory message
For connecting to the server:
- Compile and run the MercurysClient.java file
[project-mercurys/src/com/mercurys/MercurysClient.java] - Enter the IP address of the host server along with the client's username
- Once the connection is successful, the program should display a confirmatory message
Now the 2 devices have been successfully connected, and they can send and receive text messages and media files while the connection is active.
To send a message
Simply type the message and press enter.
To send a file
To send any media file, ensure that the file is present locally on the device. The, go to the console and use the following format to send the file:
/<file type> <absolute file path>
The absolute file path should look like this on different operating systems:
- On Windows -
C:\Pictures\Nature\SummerLeaves.jpg - On Linux -
/home/xyz/Documents/Sustainability_Report.pdf - On macOS -
/Users/xyz/Documents/ProjectDeadlineNotice.pdf
Note: Currently, the accepted file types are:
image-> for image filespdf-> for pdf files
The console will display a confirmatory message that the file has been sent if the transfer is successful, and it should display the path of the file downloaded for the user on the opposite end.
If the connection is to be closed, both the users must enter -x- to stop the program.
Apart from serving as a productive way of taking breaks, Mercurys helps me keep in touch with Java during my otherwise non-programming related studies. I use this as a way to explore OOP concepts such as encapsulation and inheritance, while also trying to to effectively implement them in real world scenarios.
I have many new features and upgrades planned for this project, including:
- Enabling WAN connections
- Upgrading to multi-client chatting
- Adding a GUI and making this a proper chat application