Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
air.net 

ServiceMonitor  - AS3

Пакетair.net
Классpublic dynamic class ServiceMonitor
НаследованиеServiceMonitor Inheritance EventDispatcher Inheritance Object
Подклассы SocketMonitor, URLMonitor

Версии среды выполнения: AIR 1.0

Класс ServiceMonitor внедряет среду для мониторинга состояния и доступности сетевых служб. Класс ServiceMonitor выступает в качестве базового для других мониторов служб.

Этот класс включен в файл aircore.swc. Adobe® Flash™ Builder™ загружает этот класс автоматически при создании проекта для Adobe® AIR™. Adobe® Flex™ SDK также включает файл aircore.swc, который необходимо добавлять при компиляции приложения с использованием Flex SDK.

В Adobe® Flash® CS3 Professional этот класс содержится в файле ServiceMonitorShim.swc. Чтобы использовать классы пакета air.net, необходимо сначала перетащить компонент ServiceMonitorShim из панели «Компоненты» в библиотеку, затем добавить следующую инструкцию import в свой код ActionScript 3.0:

import air.net.*;

Чтобы использовать пакет air.net в Adobe® Flash® Professional (CS4 и более поздних версий), выполните следующие действия.

  1. Выберите меню «Файл» > «Параметры публикации».
  2. В панели Flash нажмите кнопку «Параметры» для ActionScript 3.0. Выберите «Путь к библиотеке».
  3. Нажмите кнопку «Перейти к файлу SWC». Найдите файл Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc в папке установки Adobe Flash Professional.
  4. Нажмите кнопку «ОК».
  5. Вставьте следующую инструкцию import в код ActionScript 3.0: import air.net.*;



Общедоступные свойства
 СвойствоОпределено
      available : Boolean
Показывает, считается ли служба «доступной» в данный момент. Значение false является начальным значением до тех пор, пока либо проверка состояния приведет к присвоению свойству значения true, либо свойство будет инициализировано со значением true явным образом. Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает автономным источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.
ServiceMonitor
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      lastStatusUpdate : Date
[только для чтения] Время последнего обновления состояния.
ServiceMonitor
      pollInterval : Number
Интервал опроса сервера в миллисекундах.
ServiceMonitor
      running : Boolean
[только для чтения] Показывает, запущен ли монитор.
ServiceMonitor
Общедоступные методы
 МетодОпределено
  
    ServiceMonitor()
Создает объект ServiceMonitor.
ServiceMonitor
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
    makeJavascriptSubclass(constructorFunction:Object):void
[статические] Добавляет общедоступные методы ServiceMonitor в прототип функции конструктора JavaScript.
ServiceMonitor
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
    start():void
Запускает монитор служб.
ServiceMonitor
  
    stop():void
Останавливает мониторинг службы.
ServiceMonitor
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
    toString():String
[переопределить] Возвращает строковое представление заданного объекта.
ServiceMonitor
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
Защищенные методы
 МетодОпределено
  
    checkStatus():void
Проверяет состояние службы.
ServiceMonitor
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  
    status
Указывает на изменение состояния службы.ServiceMonitor
Сведения о свойстве
    

available

свойство
available:Boolean

Версии среды выполнения: AIR 1.0

Показывает, считается ли служба «доступной» в данный момент.

Значение false является начальным значением до тех пор, пока либо проверка состояния приведет к присвоению свойству значения true, либо свойство будет инициализировано со значением true явным образом.

Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает автономным источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.



Реализация
    public function get available():Boolean
    public function set available(value:Boolean):void
    

lastStatusUpdate

свойство 
lastStatusUpdate:Date  [только для чтения]

Версии среды выполнения: AIR 1.0

Время последнего обновления состояния.



Реализация
    public function get lastStatusUpdate():Date
    

pollInterval

свойство 
pollInterval:Number

Версии среды выполнения: AIR 1.0

Интервал опроса сервера в миллисекундах.

Если он равен нулю, опрос сервера выполняется не периодически, а лишь после вызова метода start() и при изменении состояния сети.

Объект ServiceMonitor отправляет событие status только при изменении состояния службы, а не в каждом интервале опроса. Этот объект также отправляет событие status в результате изменений сетевой связности (независимо от интервала опроса).

Значением по умолчанию является 0.



Реализация
    public function get pollInterval():Number
    public function set pollInterval(value:Number):void
    

running

свойство 
running:Boolean  [только для чтения]

Версии среды выполнения: AIR 1.0

Показывает, запущен ли монитор.



Реализация
    public function get running():Boolean
Сведения о конструкторе
    

ServiceMonitor

()Конструктор
public function ServiceMonitor()

Версии среды выполнения: AIR 1.0

Создает объект ServiceMonitor.

Этот класс, как правило, является подклассом для отслеживания конкретных типов служб.

После создания объекта ServiceMonitor (или объекта подкласса) вызовите метод start(), чтобы начать мониторинг состояния службы.

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

Сведения о методе

    checkStatus

()метод
protected function checkStatus():void

Версии среды выполнения: AIR 1.0

Проверяет состояние службы.

Метод переопределения подкласса для проверки состояния службы.

Как правило, этот метод инициирует сетевую операцию, завершение или ошибка которой приводят к выбору значения свойства available.

Код JavaScript может специализировать этот метод путем определения метода checkStatus() в специализирующем объекте.

    makeJavascriptSubclass

()метод 
public static function makeJavascriptSubclass(constructorFunction:Object):void

Версии среды выполнения: AIR 1.0

Добавляет общедоступные методы ServiceMonitor в прототип функции конструктора JavaScript.

Добавляет функции в прототип функции конструктора JavaScript, которые направляют общедоступные функции ServiceMonitor в объект ServiceMonitor. Это приближает обычный подкласс JavaScript к базовому классу ActionScript.

Класс JavaScript, который специализирует ServiceMonitor, выглядит следующим образом:

     // JavaScript Constructor function
     function MyHTTPMonitor(url, method)
     {
         // "that" variable makes "this" available in closures below
         var that = this;
         // Required initialization of the service monitor, returns the actual ServiceMonitor object.
         this.monitor = this.initServiceMonitor();
         // Initializes URLStream and event handlers.
         this._urlStream = new air.URLStream();
         this._urlRequest = new air.URLRequest(url);
         if (method)
         {
             this._urlRequest.method = method;
         }
         else
         {
             this._urlRequest.method = "GET";
         }
         function onStatus(event) {
             that.monitor.available = Number(event.status) == 200;
             that._urlStream.close();
         }
         function onError(event)
         {
             that.monitor.available = false;
             that._urlStream.close();
         }
         this._urlStream.addEventListener(air.HTTPStatusEvent.HTTP_RESPONSE_STATUS, onStatus);
         this._urlStream.addEventListener(air.SecurityErrorEvent.SECURITY_ERROR, onError);
         this._urlStream.addEventListener(air.IOErrorEvent.IO_ERROR, onError);
     }
     
     // Augment JavaScript prototype with public methods from ServiceMonitor
     air.ServiceMonitor.makeJavascriptSubclass(MyHTTPMonitor);
     
     // Implement specializer functions, just as you would when subclassing a JavaScript class
     MyHTTPMonitor.prototype.checkStatus = function()
     {
         air.trace('OVERRIDDEN checkStatus!', this);
         this._urlStream.load(this._urlRequest);
     }
     

Чтобы воспользоваться классом JavaScript, выполните следующие действия.

     var httpMon = new MyHTTPMonitor('http://www.adobe.com')
     

Обязательно загрузите файлы AIRAliases.js и aircore.swf с тегами script.

Параметры

constructorFunction:Object — Свойство prototype объекта JavaScript. Например, если объект JavaScript, используемый в качестве специализирующего, назван MyHTTPMonitor, укажите в качестве значения этого параметра MyHTTPMonitor.prototype.

    start

()метод 
public function start():void

Версии среды выполнения: AIR 1.0

Запускает монитор служб.

    stop

()метод 
public function stop():void

Версии среды выполнения: AIR 1.0

Останавливает мониторинг службы.

    toString

()метод 
override public function toString():String

Версии среды выполнения: AIR 1.0

Возвращает строковое представление заданного объекта.

Примечание. Методы класса Object динамически создаются в прототипе Object. Чтобы переопределить этот метод в подклассе Object, не используйте ключевое слово override. Например, в подклассе Object вместо переопределения базового класса применяется function toString():String.

Возвращает
String — Строковое представление объекта.
Сведения о событии
    

status

Событие
Тип объекта события: flash.events.StatusEvent
свойство StatusEvent.type = flash.events.StatusEvent.STATUS

Версии среды выполнения: AIR 1.0

Указывает на изменение состояния службы.

Свойство code принимает значение Service.available или Service.unavailable, но лучше всего проверить значение свойства ServiceMonitor.available.

Задает значение свойства type для объекта события status.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
codeОписание состояния объекта.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
levelКатегория сообщения, например, status, warning или error.
targetОбъект, сообщающий свое состояние.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.