Ejemplo de conjuntos: PlayList

La clase PlayList administra un conjunto de objetos Song. Dispone de métodos públicos con funcionalidad para añadir una canción a la lista de reproducción (el método addSong() ) y ordenar las canciones de la lista (el método sortList() ). Además, la clase incluye una propiedad de descriptor de acceso de solo lectura, songList , que proporciona acceso al conjunto de canciones de la lista de reproducción. Internamente, la clase PlayList hace un seguimiento de sus canciones mediante una variable privada de tipo Array:

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

Además de la variable _songs de tipo Array utilizada por la clase PlayList para hacer un seguimiento de su lista de canciones, otras dos variables privadas hacen un seguimiento de si la lista debe ser ordenada ( _needToSort ) y por qué propiedad está ordenada la lista de canciones en un momento dado ( _currentSort ).

Al igual que ocurre con los objetos, declarar una instancia de Array es solo la mitad del trabajo de crear un objeto Array. Antes de acceder a las propiedades o métodos de una instancia de Array, hay que crear una instancia en el constructor de la clase PlayList.

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

La primera línea del constructor crea una instancia de la variable _songs lista para usar. Además, se llama al método sortList() para establecer la propiedad por la que se va a ordenar inicialmente.

Cuando un usuario introduce una nueva canción en la aplicación, el código del formulario de entrada de datos llama al método addSong() de la clase PlayList.

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

En addSong() , se llama al método push() del conjunto _songs , para añadir el objeto Song que se pasó a addSong() como un elemento nuevo del conjunto. Con el método push() se añade el nuevo elemento al final del conjunto, independientemente de la ordenación que se haya aplicado previamente. Esto significa que tras llamar al método push() , es probable que la lista de canciones ya no esté ordenada correctamente, por lo que se establece la variable _needToSort en true . En teoría, el método sortList() podría llamarse inmediatamente, lo que eliminaría la necesidad de controlar si la lista está ordenada o no en un momento determinado. No obstante, en la práctica no es necesario ordenar la lista de canciones hasta inmediatamente antes de recuperarla. Al aplazar la operación de ordenación, la aplicación no realiza una ordenación innecesaria si, por ejemplo, se añaden varias canciones a la lista antes de recuperarla.

Como las instancias de Song administradas por la lista de reproducción son objetos complejos, es posible que los usuarios de la aplicación deseen ordenar la lista de reproducción según distintas propiedades, como el título de la canción o el año de publicación. En la aplicación PlayList, la tarea de ordenación de la lista de canciones tiene tres partes: identificación de la propiedad con la que se debe ordenar la lista, indicación de las opciones de ordenación que se deben utilizar al ordenar con dicha propiedad y la ejecución de la operación real de ordenación.

    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; 
    }

Además de utilizar un conjunto para mantener la lista de canciones de la clase PlayList, en este ejemplo también se utilizan conjuntos en la clase Song para administrar la lista de géneros a los que pertenece una canción determinada. Considérese este fragmento de la definición de la clase 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(";"); 
}

Al crear una nueva instancia de Song, se define el parámetro genres que se utiliza para especificar el género (o los géneros) al que pertenece la canción como una instancia de Array. Esto hace que sea cómodo agrupar varios géneros en una sola variable que se puede pasar al constructor. No obstante, internamente la clase Song mantiene los géneros en la variable privada _genres como una instancia de tipo String de valores separados por signos de punto y coma. El parámetro Array se convierte en una cadena de valores separados por signos de punto y coma llamando a su método join() con el valor de literal de cadena ";" como delimitador especificado.

Con este mismo símbolo, los descriptores de acceso de genres permiten establecer o recuperar géneros como un conjunto:

    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(";"); 
    }

Los descriptores de acceso set de genres se comportan exactamente igual que el constructor; aceptan un conjunto y llaman al método join() para convertirlo en una cadena de valores separados por signos de punto y coma. El descriptor de acceso get realiza la operación contraria: se llama el método split() de la variable _genres y la cadena se divide en un conjunto de valores utilizando el delimitador especificado (valor de cadena literal ";" , como antes).