Пакет | 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