air.netURLMonitor Класс URLMonitor следит за доступностью службы, основанной на протоколе HTTP или HTTPS.air.net:ServiceMonitor Класс 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.~~;
URLMonitor Создает объект URLMonitor для указанной службы, основанной на протоколах HTTP или HTTPS.urlRequestflash.net:URLRequestОбъект URLRequest, представляющий запрос проверки для опроса сервера. acceptableStatusCodesArraynullМассив числовых кодов состояния, в котором перечислены коды, отражающие положительный результат.

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

  • 200 (OK)
  • 202 (Принято)
  • 204 (Нет содержимого)
  • 205 (Сброс содержимого)
  • 206 (Частичное содержимое в ответ на запрос с заголовком «Диапазон»)
Создает объект URLMonitor для указанной службы, основанной на протоколах HTTP или HTTPS.

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

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

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

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

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

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

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

acceptableStatusCodes Числовые коды состояния, отражающие положительный результат.Array Числовые коды состояния, отражающие положительный результат. urlRequest Объект URLRequest, представляющий запрос проверки.flash.net:URLRequest Объект URLRequest, представляющий запрос проверки. ServiceMonitor Класс ServiceMonitor внедряет среду для мониторинга состояния и доступности сетевых служб.flash.events:EventDispatcher Класс 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.~~;
status Указывает на изменение состояния службы.flash.events.StatusEvent.STATUSflash.events.StatusEvent Указывает на изменение состояния службы.

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

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

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

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

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

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

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

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

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

makeJavascriptSubclass Добавляет общедоступные методы ServiceMonitor в прототип функции конструктора JavaScript.constructorFunctionObjectСвойство prototype объекта JavaScript. Например, если объект JavaScript, используемый в качестве специализирующего, назван MyHTTPMonitor, укажите в качестве значения этого параметра MyHTTPMonitor.prototype. Добавляет общедоступные методы 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.

start Запускает монитор служб. Запускает монитор служб. stop Останавливает мониторинг службы. Останавливает мониторинг службы. toString Возвращает строковое представление заданного объекта.Строковое представление объекта. String Возвращает строковое представление заданного объекта.

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

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

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

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

lastStatusUpdate Время последнего обновления состояния.Date Время последнего обновления состояния. pollInterval Интервал опроса сервера в миллисекундах.Number0 Интервал опроса сервера в миллисекундах.

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

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

running Показывает, запущен ли монитор.Boolean Показывает, запущен ли монитор. SecureSocketMonitor Объект SecureSocketMonitor отслеживает доступность конечной точки TCP через протоколы SSL и TLS.air.net:SocketMonitor Объект SecureSocketMonitor отслеживает доступность конечной точки TCP через протоколы SSL и TLS.

Этот класс включен в файл aircore.swc. Flash Builder загружает этот класс автоматически при создании проекта для AIR. 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.~~;
SecureSocketMonitor Создает объект SecureSocketMonitor для заданной конечной точки TCP.hostStringУзел, который требуется отслеживать. portintПорт, который требуется отслеживать. Создает объект SecureSocketMonitor для заданной конечной точки TCP.

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

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

createSocket Создает объект SecureSocket.SecureSocket: объект SecureSocket, который будет использоваться данным экземпляром SocketMonitor, или null, если защищенные сокеты не поддерживаются текущей системой. flash.net:Socket Создает объект SecureSocket. toString Возвращает строковое представление заданного объекта.Строковое представление объекта. String Возвращает строковое представление заданного объекта.

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

SocketMonitor Объект SocketMonitor следит за доступностью конечной точки TCP.air.net:ServiceMonitor Объект SocketMonitor следит за доступностью конечной точки TCP.

Этот класс включен в файл aircore.swc. Flash Builder загружает этот класс автоматически при создании проекта для AIR. 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.~~;
SocketMonitor Создает объект SocketMonitor для заданной конечной точки TCP.hostStringУзел, который требуется отслеживать. portintПорт, который требуется отслеживать. Создает объект SocketMonitor для заданной конечной точки TCP.

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

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

checkStatus Вызов метода checkStatus() для объекта SocketMonitor приводит к тому, что приложение пытается подключиться к сокету, чтобы проверить наличие события connect. Вызов метода checkStatus() для объекта SocketMonitor приводит к тому, что приложение пытается подключиться к сокету, чтобы проверить наличие события connect. createSocket Создает объект Socket.объект Socket, который будет использоваться этим экземпляром SocketMonitor. flash.net:Socket Создает объект Socket. toString Возвращает строковое представление заданного объекта.Строковое представление объекта. String Возвращает строковое представление заданного объекта.

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

host Отслеживаемый узел.String Отслеживаемый узел. port Отслеживаемый порт.int Отслеживаемый порт.