[CICLO 18] Storia 1

[Jocchan]

Storia: bugfix e refactoring



Punti cardine da tenere a mente durante i lavori:

* Mai fare a gara a chi finisce il task per primo, meglio procedere con calma, altrimenti perderemo molto più tempo in seguito
* Evitiamo di complicarci la vita, esiste di certo una soluzione più semplice di quella che abbiamo pensato di implementare
* MAI aggiungere elementi non richiesti esplicitamente dai task: se mai serviranno, se ne parlerà nelle prossime storie
* Comunichiamo il più possibile, se qualcosa nelle specifiche non è chiaro discutiamone tutti i dettagli fino ad eliminare ogni dubbio, anche il più insignificante
* Postare sempre la test list PRIMA di mettere mano al codice

[Jocchan]

18.1.1: 71104 completato
Scrivere la classe LogWriter che scrive l'elenco delle Action eseguite divise per turno e l'ultimo stato del GridController.

18.1.2: cdimauro:2 giorni
Scrivere la classe LogReader per leggere il file di Log e memorizzarlo in una struttura dati in memoria

18.1.3:
Scrivere la classe LogPlayer per eseguire le Action memorizzate nel log letto da LogReader

18.1.4: Ufo13:
Refactoring di BigGem

18.1.5:
Refactoring degli State

18.1.6:
Refactoring di Grid

[71104]

ok, allora proviamo con l'1
esamino il codice, stendo una test list, e do la stima dei giorni

[71104]

ho capito perché nessuno si prenota: del task 1 non si capisce niente ed è propedeutico ai successivi 2, e tutti hanno paura per le loro ditine a fare gli ultimi 3 senza aver prima fatto i primi 3

come deve apparire in definitiva un log scritto da questa LogWrite? esempio pratico di log? "l'ultimo stato del GridController" significa che alla fine subito prima di chiudere un log devo metterci lo stato del GridController?

[71104]

tutto chiaro, ho sentito VICIUS su MSN che mi ha spiegato quello che non capivo

[Bonfo]

Altra chiave di lettura del task che ti propongo.

Cerca di capire cosa deve essere obbligatoriamente presente nel log per poter riprodurre lo stato del gioco.

[71104]

premessa: questo task è una rogna perché richiede che il file sia scritto in modo che rileggendolo il programma possa ricreare lo stato del programma; a scriverlo come testo leggibile da un umano non ci vuole niente, ma a scriverlo in binario è un casino perché tocca per esempio scrivere anche il nome della classe finale di una certa Action in modo tale che rileggendolo il programma possa istanziare il giusto tipo di Action.

MFC dispone di un sistema di serializzazione che risolve questo problema in maniera eccellente, mi devo riguardare bene come funziona e fare come fa lui. per intanto ciò che verrà scritto nel log sarà semplicemente una stringa costruita dalla Action, la quale conterrà, oltre al nome della classe, ulteriori dati utili specifici per ogni tipo di Action; per ora però è solo una stringa, a renderli dati binari e rileggibili dal programma ci penserò dopo


refactoring pre-task:

- trasformare DroppableAction in una classe (è inutile che sia un'interfaccia)
- aggiungere a DroppableAction un metodo pubblico getLogText che ritorni in forma di oggetto String una sua descrizione (da implementare in maniera specifica in ciascuna Action)


test per la classe LogWriter:

- testare che LogWriter crei un file il cui nome viene passato al costruttore
- testare un metodo LogWriter.logAction(Action) che scriva nel log il testo ottenuto in un dato momento da Action.getLogText
- testare che il metodo scriva un marker nel file se quando viene chiamato il tempo corrente è maggiore di almeno 50 ms rispetto all'ultimo tempo registrato (50 ms è la durata di un turno, modificabile da GameConfig)


test di integrazione con Grid:

- testare che forEachDroppable chiami DroppableAction.logAction

[Bonfo]

Originariamente inviato da 71104

a renderli dati binari e rileggibili dal programma ci penserò dopo

Mi sa che non è un problema tuo, ma del task dopo

[71104]

infatti leggerli (col sistema di serializzazione MFC-like) è un problema del task dopo, ma voglio comunque analizzare il da farsi così se non altro aiuto chi lo fa; e poi renderli binari è comunque compito mio ^^

[cdimauro]

Prendo il 2: 2 giorni dopo il completamento del task 1.

Alberto, ma come formato non puoi usare un semplice file di testo?

NomeAzione [Parametri]

Con [Parametri] chiaramente opzionale (ed eventualmente separati da spazi, se ce n'è più d'uno.).

Ecco la test list:
- accertarsi che la lista sia vuota all'inizio;
- accertarsi che l'azione sia letta sia fra quelle contemplate;
- accertarsi che dopo aver introdotto un elemento, la lista non sia vuota;
- accertarsi che dopo aver inserito 2 elementi, il secondo sia consecutivo al primo;
- accertarsi che l'ultimo elemento letto dal file sia uno stato (quello di GridController).


Per quanto riguarda le rifattorizzazioni di BigGem e Grid, io direi di considerare questo thread alla stregua di un cantiere aperto in cui buttare giù tutte le informazioni su come procedere.

Dovremmo cominciare col definire l'interfaccia comune a tutti i tipi di oggetti che deve gestire Grid, e che ne possono cambiare lo stato (e cambiare stato a loro volta). Che ne dite?

[fek]

Chi si occupa di 3, 4, 5, 6?

[Ufo13]

Originariamente inviato da fek

Chi si occupa di 3, 4, 5, 6?

Io continuo con il 4

[cdimauro]

Eventualmente al 3 potrei pensarci anch'io, dopo aver sviluppato il 2.

Per gli altri task, come dicevo, direi di parlarne in questo thread e di lavorarci un po' tutti.

[Bonfo]

Originariamente inviato da cdimauro

Per gli altri task, come dicevo, direi di parlarne in questo thread e di lavorarci un po' tutti.

Quoto

[Jocchan]

Per favore, mi aggiornate sullo stato dei task?

[Ufo13]

Io sto procedendo con il refactoring

[cdimauro]

Io aspetto che Alberto finisca il suo task.

[71104]

ok, ci sono quasi, manca solo l'integrazione con Grid...

cdimauro, poi ti spiego qui sul forum i dettagli per rileggere il log (è binario)

[Bonfo]

Siccome sono disponibile, non full-time, ma a sufficenza per concludere qualcosa, volevo dare una mano con i refactoring degli ultimi 3 task.

Mentro attendo che qualcuno che ci sta già lavorando sopra mi dia qualche dritta (Ufo?? ) provo a dare un occhio a come è messa la situazione

[fek]

Alberto a che punto siamo con il primo refactoring?