Objetos compartidos

Los objetos compartidos funcionan como las cookies del navegador. Puede utilizar la clase SharedObject para almacenar datos en el disco duro local del usuario y llamar a los datos durante la misma sesión o en una posterior. Las aplicaciones pueden acceder únicamente a sus propios datos SharedObject y solo si se están ejecutando en el mismo dominio. Los datos no se envían al servidor y no se puede acceder a ellos mediante otras aplicaciones que se ejecuten en otros dominios, pero sí pueden acceder a ellos las aplicaciones del mismo dominio.

Para crear un objeto SharedObject , utilice el método SharedObject.getLocal() , que tiene la siguiente sintaxis:

SharedObject.getLocal("objectName" [, pathname]): SharedObject

El siguiente ejemplo crea un objeto compartido denominado mySO:

public var mySO:SharedObject; 
mySO = SharedObject.getLocal("preferences");

Con ello se crea un archivo en equipo del cliente llamado preferences.sol.

El término local hace referencia a la ubicación del objeto compartido. En este caso, Adobe® Flash® Player almacena el archivo SharedObject localmente en el directorio de inicio del cliente.

Cuando se crea un objeto compartido, Flash Player crea un nuevo directorio para la aplicación y el dominio dentro de su entorno limitado. También crea un archivo *.sol que almacena los datos de SharedObject. La ubicación predeterminada de este archivo es un subdirectorio del directorio de inicio del usuario. La siguiente tabla muestra las ubicaciones predeterminadas de este directorio:

c:/Documents and Settings/username/Application Data/Macromedia/Flash Player/#SharedObjects

c:/Users/username/AppData/Roaming/Macromedia/Flash Player/#SharedObjects

/Users/username/Library/Preferences/Macromedia/Flash Player/#SharedObjects/web_domain/path_to_application/application_name/object_name.sol

/home/username/.macromedia/Flash_Player/#SharedObjects/web_domain/path_to_application/application_name/object_name.sol

Bajo el directorio #SharedObjects existe un directorio nombrado al azar. Debajo hay un directorio que coincide con el nombre de host y, a continuación, la ruta a la aplicación y finalmente el archivo *.sol.

Por ejemplo, si solicita una aplicación denominada MyApp.swf en el host local, y en un subdirectorio llamado /sos, Flash Player almacena el archivo *.sol en la siguiente ubicación en Windows XP:

c:/Documents and Settings/fred/Application Data/Macromedia/Flash Player/#SharedObjects/KROKWXRK/#localhost/sos/MyApp.swf/data.sol

De forma predeterminada, Flash puede guardar objetos SharedObject persistentes localmente de hasta 100 KB por dominio. Este valor puede configurarlo el usuario. Si la aplicación intenta guardar datos en un objeto compartido que podrían hacerlo superior a 100 KB, Flash Player muestra el cuadro de diálogo Almacenamiento local, que permite al usuario permitir o rechazar más almacenamiento local para el dominio que está solicitando acceso.

Cuando se crea una instancia de SharedObject local o remota mediante getLocal() o getRemote() , hay un parámetro opcional denominado secure que determina si el acceso a este objeto compartido queda restringido a los archivos SWF enviados a través de una conexión HTTPS. Si el valor de este parámetro es true y el archivo SWF se envía a través de HTTPS, Flash Player crea un nuevo objeto compartido seguro u obtiene una referencia a un objeto compartido seguro existente. Solo pueden leer o escribir en este objeto compartido seguro los archivos SWF enviados a través de HTTPS que llamen a SharedObject.getLocal() con el parámetro secure establecido en true . Si el valor de este parámetro es false y el archivo SWF se envía a través de HTTPS, Flash Player crea un nuevo objeto compartido u obtiene una referencia a un objeto compartido existente.

Los archivos SWF enviados mediante conexiones no HTTPS pueden leer o escribir en este objeto compartido. Si un archivo SWF se ha enviado a través de una conexión no HTTPS y se intenta establecer este parámetro en true , no se podrá crear un nuevo objeto compartido (o acceder a un objeto compartido seguro creado anteriormente), se emitirá un error y el objeto compartido se establecerá en null . Si se intenta ejecutar el siguiente fragmento de código desde una conexión no HTTPS, el método SharedObject.getLocal() emitirá un error:

try 
{ 
    var so:SharedObject = SharedObject.getLocal("contactManager", null, true); 
} 
catch (error:Error) 
{ 
    trace("Unable to create SharedObject."); 
}

Independientemente del valor de este parámetro, los objetos compartidos creados aumentan el espacio en disco total permitido en el dominio.

Los valores se almacenan en los objetos compartidos dentro de la propiedad data. Puede repetir indefinidamente todos los valores de una instancia de objeto compartido utilizando un bucle for..in , tal y como se muestra en el siguiente ejemplo:

var so:SharedObject = SharedObject.getLocal("test"); 
so.data.hello = "world"; 
so.data.foo = "bar"; 
so.data.timezone = new Date().timezoneOffset; 
for (var i:String in so.data) 
{ 
    trace(i + ":\t" + so.data[i]); 
}

Para eliminar un elemento SharedObject en el cliente, utilice el método SharedObject.clear() . Con esta operación no se eliminan los directorios en la ruta predeterminada para los objetos compartidos de la aplicación.

En el siguiente ejemplo se elimina el archivo SharedObject del cliente:

public function destroySharedObject():void { 
    mySO.clear(); 
}

El siguiente ejemplo muestra cómo se almacenan objetos sencillos, como un objeto Date, en un objeto SharedObject sin tener que serializarlos ni deserializarlos manualmente.

El ejemplo siguiente comienza dándole la bienvenida como visitante. Al hacer clic en Log Out (Cerrar sesión), la aplicación almacena la fecha actual en un objeto compartido. La próxima vez que inicie esta aplicación o actualice la página, la aplicación le dará la bienvenida con un recordatorio de la hora en que cerró la sesión.

Para ver la aplicación en funcionamiento, haga clic en Log Out y después actualice la página. La aplicación muestra la fecha y la hora en la que hizo clic en el botón Log Out en su visita anterior. En cualquier momento, puede eliminar la información almacenada haciendo clic en el botón Delete LSO.

<?xml version="1.0"?> 
<!-- lsos/WelcomeMessage.mxml --> 
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" initialize="initApp()"> 
  <mx:Script><![CDATA[ 
  public var mySO:SharedObject; 
  [Bindable] 
  public var welcomeMessage:String; 
 
  public function initApp():void { 
     mySO = SharedObject.getLocal("mydata"); 
     if (mySO.data.visitDate==null) { 
        welcomeMessage = "Hello first-timer!" 
     } else { 
        welcomeMessage = "Welcome back. You last visited on " + 
           getVisitDate(); 
     } 
  } 
 
  private function getVisitDate():Date { 
     return mySO.data.visitDate; 
  } 
 
  private function storeDate():void { 
     mySO.data.visitDate = new Date(); 
     mySO.flush(); 
  } 
  
  private function deleteLSO():void { 
     // Deletes the SharedObject from the client machine. 
     // Next time they log in, they will be a 'first-timer'. 
     mySO.clear(); 
  } 
  
  ]]></mx:Script> 
  <mx:Label id="label1" text="{welcomeMessage}"/> 
  <mx:Button label="Log Out" click="storeDate()"/> 
  <mx:Button label="Delete LSO" click="deleteLSO()"/> 
</mx:Application>