| Пакет | mx.rpc |
| Класс | public dynamic class AbstractService |
| Наследование | AbstractService  Proxy |
| Реализует | IEventDispatcher |
| Подклассы | AbstractWebService, HTTPMultiService, ManagedRemoteService, RemoteObject |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
| Свойство | Определено | ||
|---|---|---|---|
| channelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой. | AbstractService | ||
| destination : String
Адрес назначения службы. | AbstractService | ||
| managers : Array
Свойство managers используется для хранения списка менеджеров данных, которые изменяют поведение этой службы. | AbstractService | ||
| operations : Object
Массив операций обычно устанавливается только компилятором MXML при создании службы посредством тега MXML. | AbstractService | ||
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | AbstractService | ||
| Метод | Определено | ||
|---|---|---|---|
AbstractService(destination:String = null)
Конструктор. | AbstractService | ||
Разъединяет сетевое подключение службы и удаляет любые ответчики для запросов в очереди. | AbstractService | ||
Возвращает операцию для данного имени. | AbstractService | ||
Вызов для инициализации службы. | AbstractService | ||
Регистрирует пользователя за пределами адреса назначения. | AbstractService | ||
Устанавливает учетные данные для адреса назначения, к которому обращалась служба при использовании Data Services на стороне сервера. | AbstractService | ||
Имя пользователя и пароль для аутентификации пользователя в случае обращения к удаленной внешней конечной точке, например к web-службе через прокси или к удаленному объекту через пользовательский адаптер при использовании Data Services на стороне сервера. | AbstractService | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| Событие ошибки передается при ошибке вызова службы и отсутствии обработки этого вызова операцией. | AbstractService | |||
| Событие вызова передается при вызове операции службы при отсутствии ошибки до попытки канала передать сообщение. | AbstractService | |||
| Событие результата передается при успешном возврате вызова службы и отсутствии обработки этого вызова операцией. | AbstractService | |||
channelSet | свойство |
channelSet:ChannelSet| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к ChannelSet, используемому данной службой. ChannelSet может быть создан и присвоен вручную или динамически – для использования настроенных каналов со значением destination этой службы.
Реализация
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voiddestination | свойство |
destination:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Адрес назначения службы. Это значение должно соответствовать значению адреса в файле services-config.xml.
Реализация
public function get destination():String public function set destination(value:String):voidmanagers | свойство |
managers:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Свойство managers используется для хранения списка менеджеров данных, которые изменяют поведение этой службы. Эта функция позволяет определить один или несколько компонентов менеджеров, связанных с этой службой. Для этого свойства устанавливается значение данной службы, если для менеджеров указано свойство service. При инициализации этой службы метод initialize также вызывается для любых компонентов менеджеров.
Реализация
public function get managers():Array public function set managers(value:Array):voidoperations | свойство |
operations:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Массив операций обычно устанавливается только компилятором MXML при создании службы посредством тега MXML.
Реализация
public function get operations():Object public function set operations(value:Object):voidrequestTimeout | свойство |
requestTimeout:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. Если значение меньше или равно нулю, тайм-аут запроса не применяется.
Реализация
public function get requestTimeout():int public function set requestTimeout(value:int):voidAbstractService | () | Конструктор |
disconnect | () | метод |
public function disconnect():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Разъединяет сетевое подключение службы и удаляет любые ответчики для запросов в очереди. Этот метод не ожидает завершения сетевых операций в очереди.
getOperation | () | метод |
public function getOperation(name:String):AbstractOperation| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает операцию для данного имени. Если операция не была создана предварительно, она создается подклассами в течение этого вызова. Как правило, доступ к операции можно получить путем простого указания ее имени после переменной службы (myService.someOperation), но если имя операции совпадает с определенным методом в службе (например, setCredentials), то для обращения к операции можно использовать этот метод.
Параметры
name:String — Имя операции.
|
AbstractOperation — Операция, которая выполняется для этого имени.
|
initialize | () | метод |
public function initialize():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вызов для инициализации службы.
logout | () | метод |
public function logout():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Регистрирует пользователя за пределами адреса назначения. Выход из адреса назначения применяется для всех подключений, использующих одинаковый ChannelSet, указанный в конфигурации сервера. Например, если при подключении по каналу my-rtmp выполняется выход из системы посредством одного из компонентов RPC, выход будет выполнен для всех подключений по этому ChannelSet.
Примечание. Adobe рекомендует вместо этого метода использовать метод mx.messaging.ChannelSet.logout().
Связанные элементы API
setCredentials | () | метод |
public function setCredentials(username:String, password:String, charset:String = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает учетные данные для адреса назначения, к которому обращалась служба при использовании Data Services на стороне сервера. Учетные данные применяются ко всем службам, подключенным по одному ChannelSet. Учтите, что для служб, использующих прокси или внешний адаптер для удаленной конечной точки, вместо этого требуется setRemoteCredentials.
Параметры
username:String — Имя пользователя для адреса назначения.
| |
password:String — Пароль для адреса назначения.
| |
charset:String (default = null) |
setRemoteCredentials | () | метод |
public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя пользователя и пароль для аутентификации пользователя в случае обращения к удаленной внешней конечной точке, например к web-службе через прокси или к удаленному объекту через пользовательский адаптер при использовании Data Services на стороне сервера.
Параметры
remoteUsername:String — Имя пользователя для передачи в удаленную конечную точку
| |
remotePassword:String — Пароль для передачи в удаленную конечную точку
| |
charset:String (default = null) |
fault | Событие |
mx.rpc.events.FaultEventсвойство FaultEvent.type =
mx.rpc.events.FaultEvent.FAULT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие ошибки передается при ошибке вызова службы и отсутствии обработки этого вызова операцией.
Тип события FAULT.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true, вызов preventDefault()из метода responder.fault связанного маркера приводит к предотвращению передачи этого события службой или операцией |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
fault | Объект Fault, который содержит подробную информацию о причине этого события. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
token | Маркер, представляющий вызов метода. Используется в образце асинхронного маркера выполнения. |
invoke | Событие |
mx.rpc.events.InvokeEventсвойство InvokeEvent.type =
mx.rpc.events.InvokeEvent.INVOKE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие вызова передается при вызове операции службы при отсутствии ошибки до попытки канала передать сообщение.
Тип события INVOKE.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
cancelable | true |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение запроса, связанное с данным событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Событие |
mx.rpc.events.ResultEventсвойство ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие результата передается при успешном возврате вызова службы и отсутствии обработки этого вызова операцией.
Тип события RESULT.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true, preventDefault() из метода связанного маркера responder.result предотвращает передачу этого события операцией или службой |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Результат, возвращаемый вызовом RPC. |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
Tue Jun 12 2018, 11:34 AM Z