Skip to content
TURING - disTribUted collaboRative edItiNG
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
.settings
doc
src/main/java/it/azraelsec
.classpath
.project
LICENSE
README.md
Report TURING - RCL lab.pdf
TURING.iml
pom.xml

README.md

TURING

TURING (aka disTribUted collaboRative edItiNG) is a tool for the distributed collaborative documents editing which offers a small set of services.

Compilation

  • Run mvn package in the main folder
  • Will be produced two JAR package in the target folder:
    • TURING-Client.jar
    • TURING-Server.jar

Environment and Dependencies

Execution

  • Run java -jar target/TURING-Server.jar to execute the TURING Server
  • Run java -jar target/TURING-Client.jar to execute the TURING Client

Connection Options

Both TURING Client and Server can be executed with default parameters or with custom ones.

The involved variables are:

  • Client
    • TCP_PORT - TCP port used for commands/responses transmission
    • UDP_PORT - UDP port used for multicast chat messages transmission
    • RMI_PORT - TCP port used for RMI method call execution
    • DATA_DIR - Directory to store on editing documents in
    • SERVER_ADDRESS - Server IPv4 address
  • Server
    • TCP_PORT
    • RMI_PORT
    • DATA_DIR - Directory which hosts the server-side documents and the serialized databases (users and documents)

Command Line

All these variable are available via command line, and it's possible to see their correct use just running:

  • java -jar TURING-Client.jar -h
  • java -jar TURING-Server.jar -h

Configuration File

It's possible to use a JSON configuration file to avoid to pass all the connection parameters through the command line. The constant variable names used into this are the same written above. To pass the configuration file name to the program you need to use the CONFIG_FILE command line's argument.

IMPORTANT: Command line arguments overwrite the configuration file ones!

This is an example config file:

{
    "TCP_PORT": 1596,
    "DATA_DIR": "/var/tmp/IdontKnow",   
}

Documentation

It's possible to find a PDF report which points out the main technical details of the project and the Javadoc HTML.

Both of those are attached to this repository under the "doc" directory.

You can’t perform that action at this time.