Oggetti condivisi

Gli oggetti condivisi funzionano come i cookie dei browser. Potete utilizzare la classe SharedObject per memorizzare dati sul disco rigido locale dell'utente e richiamare tali dati durante la stessa sessione o in una sessione successiva. Le applicazioni possono accedere solo ai propri dati SharedObject e solo se sono in esecuzione nello stesso dominio. I dati non vengono inviati al server e non sono accessibili per altre applicazioni in esecuzione in altri domini, ma possono essere resi accessibili per applicazioni dello stesso dominio.

Per creare un oggetto SharedObject , utilizzate il metodo SharedObject.getLocal() . Di seguito viene riportata la relativa sintassi:

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

Nell'esempio seguente viene creato un oggetto condiviso denominato mySO:

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

Nel computer client viene creato un file denominato preferences.sol.

Il termine local si riferisce alla posizione dell'oggetto condiviso. In questo caso, Adobe® Flash® Player memorizza il file SharedObject a livello locale nella directory principale del client.

Quando si crea un oggetto condiviso, Flash Player crea una nuova directory per l'applicazione e il dominio all'interno della propria sandbox. Crea inoltre un file *.sol in cui vengono memorizzati i dati SharedObject. La posizione predefinita di questo file è una sottodirectory della directory principale dell'utente. Nella tabella seguente sono indicate le posizioni predefinite di questa directory:

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

Al di sotto della directory #SharedObjects è presente una directory con un nome casuale. Ancora al di sotto si trovano una directory che corrisponde al nome host, quindi il percorso dell'applicazione e infine il file *.sol.

Ad esempio, se richiedete un'applicazione denominata MyApp.swf sull'host locale, all'interno di una sottodirectory denominata /sos, Flash Player memorizza il file *.sol nella seguente posizione in Windows XP:

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

Per impostazione predefinita, Flash consente di salvare oggetti SharedObject persistenti a livello locale con dimensioni massime di 100 KB per dominio. Questo valore può essere configurato dall'utente. Se l'applicazione tenta di salvare in un oggetto condiviso una quantità di dati che determinerebbe il superamento del limite di 100 KB, Flash Player visualizza la finestra di dialogo Archiviazione locale, che vi permette di autorizzare o negare una capacità di archiviazione locale superiore per il dominio che richiede l'accesso.

Quando si crea un oggetto SharedObject locale o remoto utilizzando getLocal() o getRemote() , è disponibile un parametro opzionale di nome secure che determina se l'accesso a questo oggetto condiviso è limitato ai file SWF inviati attraverso una connessione HTTPS. Se questo parametro viene impostato su true e il file SWF viene inviato tramite HTTPS, Flash Player crea un nuovo oggetto condiviso protetto oppure acquisisce un riferimento a un oggetto condiviso protetto esistente. Questo oggetto condiviso protetto può essere letto o scritto solo da/su file SWF distribuiti tramite HTTPS che chiamano SharedObject.getLocal() con il parametro secure impostato su true . Se questo parametro viene impostato su false e il file SWF viene inviato tramite HTTPS, Flash Player crea un nuovo oggetto condiviso protetto oppure acquisisce un riferimento a un oggetto condiviso esistente.

Questo oggetto condiviso può essere letto o scritto da/su file SWF distribuito tramite connessioni non HTTPS. Se il file SWF viene distribuito tramite una connessione non HTTPS e si tenta di impostare il parametro su true , la creazione del nuovo oggetto condiviso (oppure l'accesso a un oggetto condiviso protetto esistente) non riesce, viene generato un errore e l'oggetto condiviso viene impostato su null . Se tentate di eseguire lo snippet di codice seguente da una connessione non HTTPS, il metodo SharedObject.getLocal() genera un errore:

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

Indipendentemente dal valore di questo parametro, gli oggetti condivisi creati vengono presi in considerazione per il conteggio dello spazio totale su disco concesso al dominio.

Nella proprietà data degli oggetti condivisi vengono memorizzati dei valori. Potete eseguire il loop ciclico all'interno di un'istanza di un oggetto condiviso utilizzando un ciclo for..in , come mostrato nell'esempio seguente:

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

Per eliminare un oggetto SharedObject dal client, utilizzate il metodo SharedObject.clear() . Questa operazione non elimina le directory nel percorso predefinito degli oggetti condivisi dell'applicazione.

Nell'esempio seguente il file SharedObject viene eliminato dal client:

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

L'esempio seguente mostra che potete memorizzare oggetti semplici, ad esempio un oggetto Date, in un oggetto SharedObject senza dover serializzare e deserializzare manualmente tali oggetti.

Inizialmente vi verrà dato il benvenuto come utente che accede per la prima volta. Quando fate clic su Log Out (Disconnetti), l'applicazione memorizza la data corrente in un oggetto condiviso. Quando avviate nuovamente l'applicazione o aggiornate la pagina, il messaggio di benvenuto indicherà la data e l'ora in cui vi siete disconnessi.

Per verificare in concreto il funzionamento dell'applicazione, avviate l'applicazione, fate clic su Log Out e aggiornate la pagina. Verranno visualizzate la data e l'ora in cui avete fatto clic sul pulsante Log Out durante la visita precedente. Potete eliminare le informazioni memorizzate in qualsiasi momento facendo clic sul pulsante Delete LSO (Elimina oggetti condivisi locali).

<?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>