Главная / Action Script 3
(Только AIR)
Пакетair.net
Классpublic class URLMonitor
НаследованиеURLMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object

Версия продукта: AIR 1.0

Класс URLMonitor следит за доступностью службы, основанной на протоколе HTTP или HTTPS.

Чтобы использовать этот класс в коде JavaScript, загрузите файл ServiceMonitor.swf, как описано ниже:

<script src="ServiceMonitor.swf" type="application/x-shockwave-flash">



Общедоступные свойства
 СвойствоОпределено
  acceptableStatusCodes : Array
Числовые коды состояния, отражающие положительный результат.
URLMonitor
 Inheritedavailable : Boolean
Показывает, считается ли служба "доступной" в данный момент. Начальным значением является false до тех пор, пока проверка состояния не приведет к присвоению свойству значения true, либо свойство не будет инициализировано со значением true явным образом. Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает независимым источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.
ServiceMonitor
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedlastStatusUpdate : Date
[только для чтения] Время последнего обновления состояния.
ServiceMonitor
 InheritedpollInterval : Number
Интервал опроса сервера в миллисекундах.
ServiceMonitor
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
 Inheritedrunning : Boolean
[только для чтения] Показывает, запущен ли монитор.
ServiceMonitor
  urlRequest : URLRequest
[только для чтения] Объект URLRequest, представляющий запрос проверки.
URLMonitor
Общедоступные методы
 МетодОпределено
  
URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)
Создает объект URLMonitor для указанной службы, основанной на протоколах HTTP или HTTPS.
URLMonitor
 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
 Inherited
makeJavascriptSubclass(constructorFunction:Object):void
[статические] Добавляет общедоступные методы ServiceMonitor в прототип функции конструктора JavaScript.
ServiceMonitor
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Запускает монитор служб.
ServiceMonitor
 Inherited
Останавливает мониторинг службы.
ServiceMonitor
  
Возвращает строковое представление заданного объекта.
URLMonitor
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
  
Пытается загрузить содержимое из URL в фоновом режиме, чтобы проверить наличие возвращенного кода состояния HTTP.
URLMonitor
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedУказывает на изменение состояния службы.ServiceMonitor
Сведения о свойстве
acceptableStatusCodesсвойство
acceptableStatusCodes:Array  [чтение и запись]

Версия продукта: AIR 1.0

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



Реализация
    public function get acceptableStatusCodes():Array
    public function set acceptableStatusCodes(value:Array):void
urlRequestсвойство 
urlRequest:URLRequest  [только для чтения]

Версия продукта: AIR 1.0

Объект URLRequest, представляющий запрос проверки.



Реализация
    public function get urlRequest():URLRequest
Сведения о конструкторе
URLMonitor()Конструктор
public function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

Версия продукта: AIR 1.0

Создает объект URLMonitor для указанной службы, основанной на протоколах HTTP или HTTPS.

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

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

Параметр URLRequest указывает запрос проверки для опроса сервера. Как правило, используется метод запроса GET или HEAD.

Параметры
urlRequest:URLRequest — Объект URLRequest, представляющий запрос проверки для опроса сервера.
 
acceptableStatusCodes:Array (default = null) — Массив числовых кодов состояния, в котором перечислены коды, отражающие положительный результат.

Если значение свойства acceptableStatusCodes не указано, следующие коды состояния будут идентифицированы как успешные ответы:

  • 200 (OK)
  • 202 (Принято)
  • 204 (Нет содержимого)
  • 205 (Сброс содержимого)
  • 206 (Частичное содержимое в ответ на запрос с заголовком "Диапазон")
Сведения о методе
checkStatus()метод
override protected function checkStatus():void

Версия продукта: AIR 1.0

Пытается загрузить содержимое из URL в фоновом режиме, чтобы проверить наличие возвращенного кода состояния HTTP.

Если он получает код состояния, который перечислен в свойстве acceptableStatusCodes, свойству available будет присвоено значение true. Если получен код состояния, который не входит в список acceptableStatusCodes, либо при наличии ошибки безопасности или ошибки ввода-вывода, свойству available присваивается значение false.

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

Версия продукта: AIR 1.0

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

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

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