Общие объекты

Общие объекты функционируют подобно файлам cookie браузера. Класс SharedObject используется для хранения данных на локальном жестком диске пользователя и вызова этих данных во время того же или последующего сеанса. Приложения имеют доступ только к собственным данным SharedObject и только при их запуске на одном и том же домене. Данные не отправляются на сервер и недоступны для приложений, запускаемых на других доменах, однако доступны для приложений того же домена.

Для создания объекта SharedObject используется метод SharedObject.getLocal() со следующим синтаксисом:

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

В следующем примере описывается процесс создания общего объекта с именем mySO:

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

Таким образом на компьютере клиента создается файл с именем preferences.sol.

Понятие local указывает на местоположение общего объекта. В этом случае Adobe® Flash® Player сохраняет файл SharedObject в локальном начальном каталоге клиента.

При создании общего объекта Flash Player создает новый каталог для приложения и домена в изолированной среде. Также создается файл *.sol, хранящий данные SharedObject. Каталогом по умолчанию является подкаталог начального каталога пользователя. В следующей таблице представлены возможное расположение каталога по умолчанию:

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

Под именем каталога #SharedObjects подразумевается каталог с произвольным именем. Далее следует каталог, имя которого идентично имени хоста, далее — путь к приложению и, наконец, файл *.sol.

Например, при запросе приложения с именем MyApp.swf, находящегося на локальном хосте в подкаталоге с именем /sos, Flash Player сохраняет файл *.sol по следующему пути (для Windows XP):

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

По умолчанию Flash может локально сохранять постоянные объекты SharedObject размером до 100 Кб в каждом домене. Это значение может изменяться пользователем. При попытке сохранения приложением данных в общем объекте, увеличивающим его до размера более 100 Кб, Flash Player отображает диалоговое окно «Локальное сохранение», в котором пользователь может разрешить или запретить использование нескольких локальных хранилищ доменом, запращивающим доступ.

Когда создается локальный или удаленный экземпляр SharedObject с помощью метода getLocal() или getRemote() , существует дополнительный параметр с именем secure , который определяет, разрешен ли доступ к общему объекту только для SWF-файлов, доставленных через HTTPS-соединение. Если данный параметр имеет значение true и SWF-файл доставляется через HTTPS, проигрыватель Flash Player создает новый защищенный общий объект или получает ссылку на существующий защищенный общий объект. Данный защищенный общий объект может считываться или записываться только теми SWF-файлами, доставленными по протоколу HTTPS, которые вызывают метод SharedObject.getLocal() с параметром secure, имеющим значение true . Если данный параметр имеет значение false и SWF-файл передается через HTTPS, проигрыватель Flash Player создает новый общий объект или получает ссылку на существующий общий объект.

Этот общий объект может считываться или записываться SWF-файлами, доставленными не через HTTPS-подключение. Если SWF-файл доставляется не через подключение HTTPS и вы пытаетесь установить для данного параметра значение true , то создание нового общего объекта (или доступ к ранее созданному защищенному общему объекту) завершится сбоем, будет выдано сообщение об ошибке, а общий объект получит значение null . Если вы попытаетесь выполнить следующий код не через подключение по протоколу HTTPS, метод SharedObject.getLocal() выдаст ошибку.

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

Независимо от значения данного параметра созданные общие объекты добавляются к общему объему дискового пространства, доступного для домена.

В общих объектах значения хранятся в свойстве data . Отобразить каждое значение в экземпляре SharedObject можно с помощью цикла for..in , как в следующем примере.

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

Для уничтожения SharedObject у клиента используйте метод SharedObject.clear() . Данный метод не удалит каталоги из пути, установленного по умолчанию для общих объектов приложения.

Пример иллюстрирует удаление файла SharedObject с клиентского компьютера:

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

В следующем примере демонстрируется возможность хранения простых объектов, таких как объект Date, в объекте SharedObject SharedObject без ручной сериализации и десериализации этих объектов.

Следующий пример начинается с приветствия пользователя как посетителя, прошедшего первую регистрацию. При нажатии кнопки «Выход» приложение сохраняет текущую дату в общем объекте. При следующем запуске этого приложения или обновлении страницы на экран выводится приветствие с уведомлением о времени выхода из приложения.

Для того, чтобы увидеть приложение в действии, запустите приложение, нажмите кнопку «Выход», после чего обновите страницу. Приложение отобразит дату и время последнего нажатия кнопки «Выход». Сохраненную информацию можно удалить в любое время с помощью кнопки «Удалить локальный общий объект».

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