ESAME DI FONDAMENTI DI INFORMATICA T-2 del 6/2/2019 Proff. E. Denti R. Calegari G. Zannoni Tempo: 4 ore

Transcript

1 ESAME DI FONDAMENTI DI INFORMATICA T-2 del 6/2/2019 Prff. E. Denti R. Calegari G. Zannni Temp: 4 re NOME PROGETTO ECLIPSE: CgnmeNme-matricla (es. RssiMari ) NOME CARTELLA PROGETTO: CgnmeNme-matricla (es. RssiMari ) NOME ZIP DA CONSEGNARE: CgnmeNme-matricla.zip (es. RssiMari zip) NB: l archivi ZIP da cnsegnare deve cntenere l inter prgett Eclipse Si vule sviluppare una semplice app per gicare a Tris (dett anche TicTacTe, v. figura a lat). DESCRIZIONE DEL DOMINIO DEL PROBLEMA Tris si gica su una scacchiera 3x3 fra due gicatri, che utilizzan due simbli distinti (di nrma X e O) per marcare le prprie msse. I gicatri si alternan: vince il prim che riesce a prre tre sui simbli in sequenza (rizzntale, verticale diagnale). Se nessun ci riesce, nn ci sn vincitri e il gic finisce in parità. ENTITÀ COINVOLTE Si desidera che gni partita sia identificata in md univc dal timestamp (in frmat ISO) reativ all istante di inizi della partita stessa. A gni partita è assciata la lista delle cnfigurazini di scacchiera che la descrivn, a partire dalla scacchiera vuta iniziale fin alla cnfigurazine finale in cui un vince (csa che può avvenire anche prima che tutte le nve caselle sian state usate), il gic termina in parità. Ogni mssa genera quindi una nuva cnfigurazine della scacchiera, che viene aggiunta in cda alla lista. ALGORITMO DI GIOCO Dp gni mssa ccrre verifica l eventuale vincita da parte di un gicatre cntrlland la presenza di tre simbli uguali in riga, clnna diagnale. Parte 1 (punti: 19) Dati (namespace tris.mdel) (punti: 17) Il mdell dei dati deve essere rganizzat secnd il diagramma UML di seguit riprtat:

2 SEMANTICA: a) L enumerativ BardValue (frnit) definisce i tre stati pssibili per gni singla cella della scacchiera (EMPTY, X, O): a gni valre simblic è assciata la stringa crrispndente (per EMPTY si usa l spazi ), recuperabile sia tramite l accessr get sia tramite tstring. Il metd di utilità ther restituisce invece l altr simbl rispett all attuale (vviamente è indefinit nel cas il simbl crrente sia EMPTY), mentre il metd static getallvalues restituisce la stringa ci tre valri pssibili cncatenati (ssia, XO ). b) l interfaccia Bard (frnita) descrive la scacchiera, intesa cme matrice 3x3 di BardValue: per cnvenzine, righe e clnne sn numerate da 0 a 2, mentre le due diagnali sn numerate da 0 a 1. I metdi: getrw, getclumn e getdiagnal cnsentn di recuperare rispettivamente la singla riga, clnna diagnale di indice pari all argment ricevut, restituend la stringa crrispndente al cntenut (ad esempi, XXO, O O, etc.): lancian IllegalArgumentExceptin se l indice è furi range (ssia se nn è cmpres nell intervall 0-2 per getrw, getclumn e 0-1 per getdiagnal); analgamente winningrw, winningclumn e winningdiagnal verifican rispettivamente se la riga, clnna diagnale specificata (tramite il slit indice nel range , cme spra) sia vincente, ssia cntenga tre simbli uguali; winning verifica se la scacchiera nel su cmpless sia vincente, ssia se in essa vi sia almen una riga, clnna, diagnale vincente; distancefrm calcla la distanza fra la scacchiera crrente e quella frnita cme argment, intendendsi cn ciò il numer di celle diverse fra le due cnfigurazini di scacchiera (vedi esempi illustrati di seguit); adjacent verifica se la scacchiera crrente sia adiacente a quella frnita cme argment, intendendsi cn ciò che abbia distanza 1 da essa e inltre che il numer di X e di O presenti nella scacchiera frnita cme argment sia quasi identic (più precisamente, che il numer di X differisca al più di 1 dal numer di O): ciò serve a evitare scacchiere illegali in cui l stess gicatre faccia due msse cnsecutive tstring deve restituire una stringa adatta a visualizzare la scacchiera su cnsle, quindi cn tre simbli per riga separati fra lr da tabulazini e andand a cap dp le prime due righe (ma nn dp l ultima!). Per prtabilità fra le piattafrme, il simbl di a cap nn dev essere cablat cme \n ma dev essere espress tramite System.lineSeparatr. c) la classe MyBard (da realizzare) implementa Bard cme da specifica, cn le seguenti ulteriri precisazini: devn essere previsti due cstruttri, un cn argment matrice 3x3 di caratteri, l altr cn argment stringa di 9 caratteri cnsecutivi da intendersi letti dall alt al bass e da sinistra a destra, senza separatri di alcun tip: entrambi i cstruttri lancian IllegalArgumentExceptin se l argment nn ha la giusta dimensine qualche carattere è divers dai tre ammessi (quelli assciati ai valri di BardValue) devn essere implementate anche equals e hashcde: in particlare, per hashcde è sufficiente quella standard generata autmaticamente da Eclipse (menù Surce Generate hashcde and equals) mentre equals deve cnsiderare uguali due scacchiere a distanza zer una dall altra; d) l interfaccia Match (frnita) descrive la partita intesa cme sequenza di cnfigurazini di scacchiera. Metdi: getcurrentstate restituisce l stat attuale della scacchiera (che esiste sempre, perché la partita inizia cn una scacchiera vuta, ssia cn tutte le celle in stat EMPTY) getstate restituisce l stat i-esim della scacchiera: se l indice è furi range, ssia supera quell dell ultim stat dispnibile (quell crrente), viene lanciata IllegalArgumentExceptin

3 gethistry restituisce la lista di tutti gli stati, dalla scacchiera vuta iniziale fin all stat finale add aggiunge sequenza di cnfigurazini una nuva scacchiera, che diviene l stat crrente, purché il nuv stat sia adiacente a quell precedente: altrimenti, lancia IllegalArgumentExceptin tstring deve restituire una stringa adatta a visualizzare su cnsle l intera partita, intesa cme sequenza delle relative scacchiere separate fra lr da System.lineSeparatr (nn dp l ultima); anche qui il simbl di a cap nn dev essere cablat cme \n ma dev essere espress tramite System.lineSeparatr. e) la classe MyMatch (da realizzare) implementa Match cme da specifica, cn le seguenti ulteriri precisazini: devn essere previsti due cstruttri, un cn argment l identificativ univc LcalDateTime specificat, l altr senza argmenti (che utilizza girn e ra crrenti). Entrambi devn inizializzare la lista delle cnfigurazini cn la scacchiera iniziale vuta (ssia, cn tutte le celle nell stat EMPTY) devn essere frnite due implementazini standard di equals e hashcde che si suggerisce di far generare autmaticamente da Eclipse (menù Surce Generate hashcde and equals) Persistenza (namespace tris.persistence) (punti: 2) Obiettiv di quest cmpnente è stampare su file una partita, secnd il diagramma UML di seguit riprtat. SEMANTICA: a) l interfaccia MatchPrinter (frnita) dichiara il sl metd print che stampa un Match sul PrinterWriter frnit. b) la classe MyMatchPrinter (da realizzare) implementa tale metd, assicurand che dp gni stampa il buffer di uscita venga pprtunamente svutat. Parte 2 (punti: 11) Cntrller (namespace tris.cntrller) Il cntrller articlat in interfaccia e implementazine è frnit già prnt: il su stat intern mantiene l stat della partita cn annessi e cnnessi (gicatre attuale, etc.) nnché il printer da usare per le stampe. Cnseguentemente, i sui metdi fann da pnte fra quelli del mdel e quelli del printer. In particlare: strestatus aggiunge alla partita crrente il nuv stat di scacchiera ricevut cme argment (stt frma di stringa di 9 caratteri), verificand al cntemp se ess sia vincente (restituisce a tal fine un blean) winningstatus verifica se la partita crrente è vinta getcurrentplayer restituisce la stringa crrispndente al gicatre crrente ( X O )

4 getnextplayer cambia il gicatre crrente (da X a O, da O a X ) e restituisce la stringa crrispndente print stampa su file la partita crrente (che si suppne terminata) L interfaccia Cntrller ffre altresì il metd static alert per far cmparire una finestre di dialg utile a segnalare errri all utente (in questa applicazine, sl nel cas in cui la stampa su file fallisca per qualche mtiv). GUI (namespace tris.ui) (punti: 11) L interfaccia grafica dev essere simile (nn necessariamente identica) a quella stt illustrata. La classe TrisApp (frnita) cntiene cme sempre il main di partenza dell applicazine. La classe TrisPane (pure frnita) definisce il pannell cn gli elementi grafici principali (Fig.1), vver: al tp, l etichetta cn l indicazine del gicatre crrente (ssia, se tcca a X a O) a sinistra la griglia-scacchiera, stt frma di istanza della classe TrisGrid a destra, la textarea su cui far cmparire via via l stat della partita in bass, il pulsante Stampa (inizialmente disabilitat, si abilita sl quand la partita termina) La classe TrisGrid (da realizzare) deve implementare la griglia e l algritm di gic, interfacciandsi pprtunamente cn TrisPane. Più esattamente: il cstruttre riceve da TrisPane tutti gli elementi su cui deve pter perare e allca una griglia 3x3 di Buttn, impstati cn fnt Curier New grassett 20 punti e inizializzati vuti (ssia cl test crrispndente all stat BardValue.EMPTY) (Fig. 1). SUGGERIMENTO: utilizzare un GridPane, ricrdand però che il metd add/4 prevede, in md alquant cntr-intuitiv, prima l indice di clnna, pi quell di riga. La pressine di un dei 9 bttni della griglia deve causare l invcazine di un pprtun metd di gestine eventi, per cmdità denminat handle(buttn) il metd tstring frnisce la rappresentazine stringa dell stat attuale della griglia-scacchiera, nel frmat di stringa a 9 caratteri cnsecutivi (adatt per il cstruttre di Bard) quand il gicatre crrente preme un dei 9 pulsanti della griglia-scacchiera di gic, handle: impsta nel bttne premut il simbl del gicatre crrente (X O) disabilita il bttne stess, in md che nn sia più cliccabile (cella già ccupata) aggiunge alla partita crrente, tramite il Cntrller (metd strestatus), la nuva cnfigurazine di scacchiera appena determinatasi, verificand cntempraneamente se qualcun abbia vint; appende sulla textarea una nuva riga crrispndente alla nuva situazine della partita (Figg. 2,3,4): tale riga deve includere la cnfigurazine della scacchiera in frma cmpatta (9 caratteri) e l indicazine se il gic cntinua la partita è vinta (es. cntinua / vittria, partita patta analg); se l stat csì ttenut nn è finale (vincente patta) impne, tramite il Cntrller, di cambiare gicatre (metd getnextplayer) e adegua la visualizzazine del gicatre nella label (Figg. 1,2,3,..);

5 se, invece, l stat csì ttenut è vincente partita patta agisce di cnseguenza (invcand un metd di gestine ausiliari che per cmdità chiamerem endgame) e nell rdine: disabilita tutti i bttni della griglia-scacchiera (perché la partita è finita) abilita il pulsante Stampa (Fig. 4 5) assciandl al su gestre eventi, csì che, se premut, ess effettui la stampa della partita (tramite Cntrller.print) e subit dp ri-disabiliti il pulsante Stampa stess (Fig. 6). Figura 1 Figura 2 Figura 3 Figura 4 Figura 5 Figura 6