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

URLMonitor  - AS3

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

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

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

Этот класс включен в файл 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.*;



Общедоступные свойства
 СвойствоОпределено
      acceptableStatusCodes : Array
Числовые коды состояния, отражающие положительный результат.
URLMonitor
 Inherited    available : Boolean
Показывает, считается ли служба «доступной» в данный момент. Значение false является начальным значением до тех пор, пока либо проверка состояния приведет к присвоению свойству значения true, либо свойство будет инициализировано со значением true явным образом. Как правило, это свойство настраивается с помощью реализации метода checkStatus() в подклассе или специализирующем объекте. Но если приложение обладает автономным источником информации о доступности службы (например, успешно или безуспешно выполненным запросом), свойство можно задать вручную.
ServiceMonitor
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inherited    lastStatusUpdate : Date
[только для чтения] Время последнего обновления состояния.
ServiceMonitor
 Inherited    pollInterval : Number
Интервал опроса сервера в миллисекундах.
ServiceMonitor
 Inherited    running : 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
    start():void
Запускает монитор служб.
ServiceMonitor
 Inherited
    stop():void
Останавливает мониторинг службы.
ServiceMonitor
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
    toString():String
[переопределить] Возвращает строковое представление заданного объекта.
URLMonitor
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
Защищенные методы
 МетодОпределено
  
    checkStatus():void
[переопределить] Пытается загрузить содержимое, находящееся по указанному URL-адресу, в фоновом режиме для осуществления проверки наличия возвращенного кода состояния HTTP.
URLMonitor
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
 Inherited
    status
Указывает на изменение состояния службы.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 — Строковое представление объекта.




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

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