| Пакет | air.net |
| Класс | public dynamic class ServiceMonitor |
| Наследование | ServiceMonitor EventDispatcher Object |
| Подклассы | SocketMonitor, URLMonitor |
| Версии среды выполнения: | AIR 1.0 |
Этот класс включен в файл 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 и более поздних версий), выполните следующие действия.
- Выберите меню «Файл» > «Параметры публикации».
- В панели Flash нажмите кнопку «Параметры» для ActionScript 3.0. Выберите «Путь к библиотеке».
- Нажмите кнопку «Перейти к файлу SWC». Найдите файл Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc в папке установки Adobe Flash Professional.
- Нажмите кнопку «ОК».
- Вставьте следующую инструкцию
importв код ActionScript 3.0:import air.net.*;
| Свойство | Определено | ||
|---|---|---|---|
| available : Boolean
Показывает, считается ли служба «доступной» в данный момент. Значение false является начальным значением до тех пор, пока либо проверка состояния приведет к присвоению свойству значения true, либо свойство будет инициализировано со значением true явным образом. Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает автономным источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.
| ServiceMonitor | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| lastStatusUpdate : Date [только для чтения]
Время последнего обновления состояния. | ServiceMonitor | ||
| pollInterval : Number
Интервал опроса сервера в миллисекундах. | ServiceMonitor | ||
| running : Boolean [только для чтения]
Показывает, запущен ли монитор. | ServiceMonitor | ||
| Метод | Определено | ||
|---|---|---|---|
Создает объект ServiceMonitor. | ServiceMonitor | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
![]() |
Посылает событие в поток событий. | EventDispatcher | |
![]() |
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
[статические]
Добавляет общедоступные методы ServiceMonitor в прототип функции конструктора JavaScript. | ServiceMonitor | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
Запускает монитор служб. | ServiceMonitor | ||
Останавливает мониторинг службы. | ServiceMonitor | ||
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строковое представление заданного объекта. | ServiceMonitor | ||
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Проверяет состояние службы. | ServiceMonitor | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Указывает на изменение состояния службы. | ServiceMonitor | |||
available | свойство |
available:Boolean| Версии среды выполнения: | AIR 1.0 |
Показывает, считается ли служба «доступной» в данный момент.
Значение false является начальным значением до тех пор, пока либо проверка состояния приведет к присвоению свойству значения true, либо свойство будет инициализировано со значением true явным образом.
Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает автономным источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.
Реализация
public function get available():Boolean public function set available(value:Boolean):void lastStatusUpdate | свойство |
pollInterval | свойство |
pollInterval:Number| Версии среды выполнения: | AIR 1.0 |
Интервал опроса сервера в миллисекундах.
Если он равен нулю, опрос сервера выполняется не периодически, а лишь после вызова метода start() и при изменении состояния сети.
Объект ServiceMonitor отправляет событие status только при изменении состояния службы, а не в каждом интервале опроса. Этот объект также отправляет событие status в результате изменений сетевой связности (независимо от интервала опроса).
Значением по умолчанию является 0.
Реализация
public function get pollInterval():Number public function set pollInterval(value:Number):void running | свойство |
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 | () | метод |
stop | () | метод |
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.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
code | Описание состояния объекта. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
level | Категория сообщения, например, status, warning или error. |
target | Объект, сообщающий свое состояние. |
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства