Implementazione del gioco da tavolo MyShelfie.
Il progetto consiste nell’implementazione di un sistema distribuito composto da un singolo server in grado di gestire una partita alla volta e multipli client (uno per giocatore) che possono partecipare ad una sola partita alla volta utilizzando il pattern MVC (Model-View-Controller). La rete è stata gestita con l'utilizzo delle socket e di RMI.
Interazione e gameplay: linea di comando (CLI) e grafica (GUI).
I seguenti diagrammi delle classi rappresentano rispettivamente il modello iniziale sviluppato durante la fase di progettazione e i diagrammi del prodotto finale.
| Libreria/Plugin | Descrizione |
|---|---|
| Maven | Strumento di automazione della compilazione per progetti Java. |
| JavaFx | Libreria grafica per realizzare interfacce utente. |
| JUnit | Framework di unit testing. |
- Set di regole: Regole Complete
- Interfaccia grafica: CLI e GUI
- Connessioni di rete: Socket e RMI
- 2 FA (Funzionalità Avanzate):
- Persistenza: Fare in modo che il server salvi periodicamente lo stato della partita su disco, in modo che l'esecuzione possa riprendere da dove si è interrotta anche a seguito del crash del server stesso. Per riprendere una partita, i giocatori si dovranno ricollegare al server utilizzando gli stessi nickname una volta che questo sia tornato attivo. Si assume che il disco costituisca una memoria totalmente affidabile.
- Resilienza alle disconnessioni: I giocatori disconnessi a seguito della caduta della rete o del crash del client, possono ricollegarsi e continuare la partita. Mentre un giocatore non è collegato, il gioco continua saltando i turni di quel giocatore. Se rimane attivo un solo giocatore, il gioco viene sospeso fino a che non si ricollega almeno un altro giocatore oppure scade un timeout che decreta la vittoria dell'unico giocatore rimasto connesso.
Per poter eseguire il gioco, è necessario posizionarsi nella cartella /deliverables/final/jar e avviare il terminale da questa posizione. Per avviare il server, eseguire il comando:
java -jar '.\My Shelfie-server.jar'
È possibile avviare al più un'istanza del server su una singola macchina.
Per avviare il client, eseguire il comando:
java -jar '.\My Shelfie-client.jar'
Qualora si voglia operare con la modalità a linea di comando (CLI) è necessario aggiungere il parametro "-c" oppure "--cli" durante il lancio dell'applicazione.
Per quanto riguarda la scelta delle connessioni, se il server è correttamente istanziato, al client è chiesto in fase di inizializzazione sia l'indirizzo IP della macchina su cui è ospitato il server sia la porta da utilizzare. Per quanto riguarda la connessione Socket la porta di default attiva sul server è la porta 5000, mentre per quanto riguarda la connessione RMI la porta di default aperta sul server è la porta 1099. Attenzione, è necessario abbinare correttamente la porta inserita alla connessione scelta.
Nella cartella in cui è presente il file "My Shelfie-server.jar" viene periodicamente creato e aggiornato un file di nome "match.data" contenente le informazioni di gioco necessarie per l'implementazione della persistenza; informazioni che poi vengono cancellate assieme al file al termine della partita. All'avvio del gioco, qualora il file non venga trovato o venga spostato, il server ne interpreta l'assenza come assenza di informazioni salvate e inizia una nuova partita.
Per quanto riguarda l'implementazione della resilienza alle disconnessioni, qualora rimanga solamente un giocatore connesso alla partita il gioco viene sospeso indefinitamente fino al momento in cui uno dei giocatori già presenti (ovvero con lo stesso nickname) si riconnette, come da specifica richiesta. Se non rimangono giocatori connessi, il gioco termina: può essere ripreso al riavvio del server combinando l'implementazione della resilienza alle disconnessioni con l'implementazione della persistenza.
È necessario essere in possesso di una versione di JRE (Java Runtime Environment) che supporti Java 19. Nello specifico, i programmi sono stati eseguiti con computer aventi Java(TM) SE Runtime Environment (build 19.0.2+7-44).