Prova Finale Ingegneria del Software 2019
Gruppo AM19
-
10536115 Daniele Chiappalupi (@daniCh8)
daniele.chiappalupi@mail.polimi.it -
10520490 Stefano Formicola (@ste7en)
stefano.formicola@mail.polimi.it -
10583425 Elena Iannucci (@eleiannu)
elena.iannucci@mail.polimi.it
| Functionality | State |
|---|---|
| Basic rules | ✅ |
| Complete rules | ✅ |
| Socket | ✅ |
| RMI | ✅ |
| GUI | ✅ |
| CLI | ✅ |
| Multiple games | ✅ |
| Persistence | ✅ |
| Domination or Towers modes | ❌ |
| Terminator | ❌ |
How to run
Running the Server
From the directory deliverables/JARS, you can run the application server with the command-line command
java -jar Server-AM19.jar [--socket=<socket-port-number>]
[--rmi=<rmi-port-number>]
[--waiting-room-timeout=<waiting-room-timeout-in-seconds>]
[--operation-timeout=<operation-timeout-in-seconds>]
If a configuration.json file exists in the same directory, CLI arguments will be overridden and the file will be used to setup the server.
The structure of the JSON configuration file is as the following example:
{
"socketPortNumber" : 3334,
"rmiPortNumber" : 4444,
"waitingRoomTimeout" : 30,
"operationTimeout" : 60
}
This is also the config file that will be used in case no arguments (or less then expected) will be passed to the program.
Multiple games
The server can handle multiple games. In order to start more than one game, more than five users are needed to login and every waitingRoomTimeout seconds a new game is started.
Persistence
At the end of every turn the server saves its state in Adrenaline_saved_state.bin and, if this file exists, the server will ask if a previous state has to be loaded or not.
Otherwise, the command --run-saved-state will restore the server regardless of the other parameters.
Running the Client - CLI
From the same directory of the server, you can run the CLI version of the client with the command-line command
java -jar Adrenaline-CLI-AM19.jar [ < --socket | --rmi >
< serverAddress>
< serverPort> ]
If no arguments are provided, at the startup a command-line prompt will ask the user for the connection type, server IP address and server port.
Running the Client - GUI
From the same directory of the server, you can run the GUI version of the client with the command-line command
java --module-path ./lib --add-modules javafx.controls -jar Adrenaline-GUI-AM19.jar
but JavaFX library folder is required in the same directory. Otherwise you can specify an absolute path to the --module-path argument instead of ./lib.