FlexUnit: Unit Testing per applicazioni Flash e ActionScript

Quando sviluppiamo un'applicazione, specie di medie o grandi dimensioni, vogliamo ridurre al minimo la possibilità di avere bug nel codice. Inoltre vogliamo evitare che una modifica, intacchi le funzionalità già testate e di cui è stato verificato il corretto funzionamento.

Per ottenere questi risultati è importante prevedere una fase di test durante il processo di sviluppo del software.

Le metodologie tradizionali prevedono la fase di test alla fine del ciclo di sviluppo, quando il software è già realizzato. Le metodologie agili, in particolare eXtreme Programming, prevedono che la fase di test sia realizzata prima dello sviluppo del codice: questa tecnica è chiamata Test Driven Development e, per quanto possa sembrare bizzarra, permette di ridurre significativamente il numero di bug presenti nel nostro codice.

Al di là della metodologia utilizzata, è buona pratica testare le nostre applicazioni ed è ancora meglio se i test possono essere lanciati automaticamente. Esistono molti framework per la creazione e l'esecuzione dei test: il padre di tutti gli ambienti di test è Junit realizzato per Java. Per Flex, invece, abbiamo a disposizione FlexUnit, sviluppato da Adobe come progetto open source.

Miniglossario dello Unit Testing

Prima di iniziare a sviluppare i test per una nostra applicazione, è bene chiarire il significato di alcuni termini.

Termine	Descrizione
Test case	è un insieme di asserzioni che verificano il corretto funzionamento di un'operazione. Consiste nel controllare il corretto output di una funzione o di un metodo, per input noti
Test Suite	è un insieme di test case e viene utilizzata per testare un programma o un insieme di funzionalità. Può contenere, se necessario, opzioni di configurazione del programma da testare, in modo che i test possano essere eseguiti simulando in maniera completa il funzionamento dell'applicazione
Code coverage	è una pratica di testing e indica il grado con cui il codice sorgente della nostra applicazione è coperto dai test

Creare un'applicazione per eseguire i test

FlexUnit è un framework per unit testing per ActionScript 3.0 e Flex e permette di eseguire i test attraverso un test runner grafico.

Per utilizzare FlexUnit, dobbiamo creare un'applicazione dedicata all'esecuzione dei test: l'applicazione deve sfruttare un component di tipo TestRunnerBase per l'esecuzione dei test unitari.

Abbiamo bisogno della libreria FlexUnit.swc, reperibile alla sezione download del sito del progetto. Una volta scaricata la libreria, dobbiamo includerla nel nostro progetto aggiungendola al "library path".

Su Flash Builder 4 l'inserimento della libreria è automatizzato grazie al bottone "FlexUnit Test" che troviamo all'interno del menu di debug, nella barra degli strumenti.

In questo caso utilizziamo però la versione 4.0 del framework per i test, ancora in versione RC nel momento in cui scriviamo, mentre in questo articolo utilizzeremo la 0.9, che invece è stabile. I concetti sono comunque sovrapponibili.

A questo punto, possiamo costruire l'applicazione per l'esecuzione dei test. Tra i "custom components" dobbiamo individuare il component TestRunnerBase e trascinarlo in modo visuale sullo stage, che conterrà dell'applicazione per i test. Bisogna dare un nome all'applicazione di test e lo facciamo scrivendolo nella proprietà id del componente (nel nostro esempio "test_app").

Lanciamo l'applicazione. Apparirà un'interfaccia simile a quella mostrata nella seguente figura:

Il component TestRunnerBase deve essere inizializzato per eseguire un insieme di test. Di seguito è riportato il codice che inizializza l'applicazione per i test.

Allo scatenarsi dell'evento creationComplete onCreationComplete TestSuite TestRunnerBase

Creare un TestCase

Supponiamo di aver creato, nel nostro progetto, una classe semplicissima MathOperation che implementa le quattro operazioni fondamentali della matematica (somma, differenza, moltiplicazione, divisione) e che vogliamo testarne il funzionamento.

Di seguito è riportato il codice della classe MathOperation

Per scrivere lo unit test della classe MathOperation TestCase MathOperationTest i metodi per il test MathOperationTest test TestSuite

Per il momento, decidiamo di scrivere il test solo per il metodo add() MathOperationTest

package
{
  import flexunit.framework.TestCase;
  
  public class MathOperationTest extends TestCase
  {
    public function testAdd():void {
      var math:MathOperation = new MathOperation();
      
      assertEquals(4, math.add(1, 3));
      assertEquals(10, math.add(7, 3));
    }
  }
}

Il test vero e proprio del metodo add() assertEquals()

Le asserzioni più importanti

Aggiungere un TestCase ad una TestSuite

Dopo aver sviluppato il TestCase, dobbiamo aggiungerlo alla TestSuite per eseguirlo. Dobbiamo aggiungere, nel corpo del metodo createSuite(), l'istruzione

Il corpo del metodo createSuite()

private function createSuite():TestSuite {
  var suite:TestSuite = new TestSuite();
  suite.addTestSuite(MathOperationTest);
  return suite;
}

In questo modo, la suite che viene creata si preoccupa di eseguire i test della classe MathOperationTest

Esecuzione dei test

Per eseguire i test ci basta lanciare l'applicazione che abbiamo inizialmente creato. Il risultato sarà simile a quello mostrato nella figura seguente.

Il test è, al momento, costituito da due asserzioni che vengono eseguite con successo: il test è quindi superato. Nel caso in cui durante l'esecuzione di un'asserzione si verifichi un errore, il risultato dei test sarà simile alla seguente figura

Nel report dei test è presente anche un dettaglio del risultato dell'esecuzione, mostrato nella figura, in cui si nota che il valore atteso (5) è diverso dal valore calcolato (6) e per questo motivo il test è fallito.

Completiamo, a questo punto, la classe MathOperationTest aggiungendo i test per gli altri metodi. Riportiamo qui una possibile implementazione della classe MathOperationTest con due asserzioni per ogni test.

I metodi setUp e tearDown

Finora, per ogni test, abbiamo istanziato un oggetto math di tipo MathOperation, necessario per l'esecuzione dei metodi. Per evitare la ripetizione di questa istruzione è possibile implementare il metodo setUp() della classe TestCase:

• il metodo setUp()
• il metodo tearDown()

I metodi setUp() e tearDown() sono rispettivamente utilizzati per allocare e deallocare le risorse necessarie all'esecuzione dei test case.

Possiamo, quindi, ristrutturare il codice dei test spostando la creazione dell'oggetto MathOperation nel metodo setUp(), nella cui dichiarazione dobbiamo specificare che si sta effettuando un override.

Conclusioni

Testare le applicazioni con un framework per lo unit testing può apparire una pratica onerosa in termini di tempo: un ulteriore lavoro durante il ciclo di sviluppo del software. In realtà, superato lo sforzo iniziale, risulta particolarmente utile testare gran parte dell'applicazione lanciando un singolo comando e poter stabilire immediatamente se una modifica ha danneggiato o meno il funzionamento dell'applicazione.

Ti consigliamo anche

Flash

Un progetto Flex/PHP con Flash Builder

Eclipse

Un progetto Flex/Java EE con Eclipse

Flash

Creare l'effetto Time Machine di Leopard in Actionscript 3.0

Flash

Sviluppare un'applicazione per iPhone con Flash Builder

Asserzione	Descrizione
assertEquals	controlla che il valore resistuito dal metodo sia uguale al valore atteso (simile all'operatore ==
assertStrictlyEquals	controlla che il valore resistuito dal metodo sia uguale al valore atteso e dello stesso tipo (simile all'operatore ===
assertTrue	controlla che la condizione sia true
assertFalse	controlla che la condizione sia false
assertNull	controlla che il risultato del metodo sia null