Esempio di array: PlayList

La classe PlayList consente di gestire una serie di oggetti Song. Essa presenta una serie di metodi pubblici con funzionalità per l'aggiunta di brani all'elenco di riproduzione (metodo addSong() ) e per l'ordinamento dei brani nell'elenco (metodo sortList() ). Inoltre, la classe include una proprietà accessoria di sola lettura, songList , che consente l'accesso alla serie di brani effettivamente presenti nell'elenco di riproduzione. Internamente, la classe PlayList tiene traccia dei brani mediante una variabile privata di Array:

public class PlayList 
{ 
    private var _songs:Array; 
    private var _currentSort:SortProperty = null; 
    private var _needToSort:Boolean = false; 
    ... 
}

Oltre alla variabile di Array _songs , utilizzata dalla classe PlayList per tenere traccia dell'elenco dei brani, vi sono altre due variabili private che segnalano se l'elenco deve essere ordinato o meno ( _needToSort ) e in base a quale proprietà l'elenco viene aggiornato in un dato momento ( _currentSort ).

Come avviene per tutti gli oggetti, la dichiarazione di un'istanza di Array è solo metà del lavoro di creazione di un Array. Prima di accedere alle proprietà o ai metodi di un'istanza di Array, è necessario creare l'istanza nella funzione di costruzione della classe PlayList.

    public function PlayList() 
    { 
        this._songs = new Array(); 
        // Set the initial sorting. 
        this.sortList(SortProperty.TITLE); 
    }

La prima riga della funzione di costruzione crea un'istanza della variabile _songs pronta per essere utilizzata. Inoltre, il metodo sortList() viene chiamato per impostare la proprietà iniziale in base alla quale effettuare l'ordinamento.

Se un utente aggiunge un nuovo brano nell'applicazione, il codice nel modulo di immissione dati chiama il metodo addSong() della classe PlayList.

    /** 
     * Adds a song to the playlist. 
     */ 
    public function addSong(song:Song):void 
    { 
        this._songs.push(song); 
        this._needToSort = true; 
    }

All'interno di addSong() , viene chiamato il metodo push() dell'array _songs e il nuovo oggetto Song trasmesso ad addSong() come nuovo elemento viene inserito nell'array. Con il metodo push() , il nuovo elemento viene aggiunto alla fine dell'array, a prescindere da qualsiasi ordinamento precedentemente applicato. Di conseguenza, dopo la chiamata al metodo push() , è possibile che l'elenco dei brani non sia più ordinato correttamente e che quindi la variabile _needToSort sia impostata su true . In teoria, il metodo sortList() potrebbe essere chiamato immediatamente, per evitare di dover rilevare se l'elenco è stato o meno ordinato nel momento specificato. In pratica, tuttavia, è necessario che l'elenco dei brani sia ordinato solo immediatamente prima del suo recupero. Posticipando l'operazione di ordinamento, l'applicazione non esegue infatti gli ordinamenti non necessari, nel caso, ad esempio, vengano aggiunti vari brani all'elenco prima del suo recupero.

Poiché le istanze di Song gestite dall'elenco di riproduzione sono oggetti complessi, gli utenti dell'applicazione possono ordinare l'elenco in base a varie proprietà, quali titolo del brano o anno di pubblicazione. Nell'applicazione PlayList, l'attività di ordinamento dell'elenco dei brani è suddiviso in tre fasi: identificazione della proprietà in base alla quale l'elenco deve essere ordinato, indicazione delle opzioni di ordinamento da utilizzare ed esecuzione dell'operazione di ordinamento vera e propria.

    public static const TITLE:SortProperty = new SortProperty("title"); 
    public static const ARTIST:SortProperty = new SortProperty("artist"); 
    public static const YEAR:SortProperty = new SortProperty("year");

        // Set the initial sorting. 
        this.sortList(SortProperty.TITLE);

    /** 
     * Sorts the list of songs according to the specified property. 
     */ 
    public function sortList(sortProperty:SortProperty):void 
    { 
        ... 
        var sortOptions:uint; 
        switch (sortProperty) 
        { 
            case SortProperty.TITLE: 
                sortOptions = Array.CASEINSENSITIVE; 
                break; 
            case SortProperty.ARTIST: 
                sortOptions = Array.CASEINSENSITIVE; 
                break; 
            case SortProperty.YEAR: 
                sortOptions = Array.NUMERIC; 
                break; 
        } 
         
        // Perform the actual sorting of the data. 
        this._songs.sortOn(sortProperty.propertyName, sortOptions); 
             
        // Save the current sort property. 
        this._currentSort = sortProperty; 
 
        // Record that the list is sorted. 
        this._needToSort = false; 
    }

Oltre che per la gestione dell'elenco dei brani nella classe PlayList, gli array vengono utilizzati in questo esempio anche nella classe Song per la gestione degli elenchi dei generi da associare ai singoli brani. Considerate il seguente frammento di codice tratto dalla definizione della classe Song:

private var _genres:String; 
 
public function Song(title:String, artist:String, year:uint, filename:String, genres:Array) 
{ 
    ... 
    // Genres are passed in as an array 
    // but stored as a semicolon-separated string. 
    this._genres = genres.join(";"); 
}

Quando create una nuova istanza di Song, il parametro genres utilizzato per specificare il genere (o i generi) a cui il brano appartiene viene definito come un'istanza di Array. Ciò consente di raggruppare facilmente più generi in una singola variabile da inviare alla funzione di costruzione. Tuttavia, internamente, la classe Song conserva i generi nella variabile privata _genres come un'istanza di String separata da punto e virgola. Il parametro Array viene convertito in una stringa separata da punto e virgola mediante chiamata al metodo join() con il valore letterale di stringa ";" come delimitatore specificato.

Grazie allo stesso token, le proprietà accessor genres consentono l'impostazione o il recupero dei generi come un array:

    public function get genres():Array 
    { 
        // Genres are stored as a semicolon-separated String, 
        // so they need to be transformed into an Array to pass them back out. 
        return this._genres.split(";"); 
    } 
    public function set genres(value:Array):void 
    { 
        // Genres are passed in as an array, 
        // but stored as a semicolon-separated string. 
        this._genres = value.join(";"); 
    }

L'accessor genres set si comporta esattamente come la funzione di costruzione, in quanto accetta un Array e chiama il metodo join() per convertirlo in una stringa separata da punto e virgola. L'accessor get esegue l'operazione opposta: viene chiamato il metodo split() della variabile _genres , per suddividere la stringa in una array di valori mediante il delimitatore specificato (il valore letterale di stringa ";" come sopra).