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

RemoteObject  - AS3 Flex

Пакетmx.rpc.remoting
Классpublic dynamic class RemoteObject
НаследованиеRemoteObject Inheritance AbstractService Inheritance Proxy
Подклассы RemoteObject

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Класс RemoteObject предоставляет доступ к классам на удаленном сервере приложений.



Общедоступные свойства
 СвойствоОпределено
 InheritedchannelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой.
AbstractService
  concurrency : String
Значение, которое указывает способ обработки нескольких вызовов одной службы.
RemoteObject
  convertParametersHandler : Function
Дополнительная функция, предназначенная, главным образом, для разработчиков инфраструктуры, которые должны установить функцию для вызова с параметрами, передаваемыми в каждый вызов удаленного объекта.
RemoteObject
  convertResultHandler : Function
Дополнительная функция, предназначенная, прежде всего, для разработчиков инфраструктуры, которые должны установить функцию для обработки результатов операции перед уведомлением обработчиков результатов.
RemoteObject
 Inheriteddestination : String
Адрес назначения службы.
AbstractService
  endpoint : String
Это свойство позволяет разработчику быстро указать конечную точку для адреса назначения RemoteObject без ссылки на файл конфигурации службы во время компиляции или путем создания ChannelSet программным способом.
RemoteObject
  makeObjectsBindable : Boolean
Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable.
RemoteObject
 Inheritedmanagers : Array
Свойство managers используется для хранения списка менеджеров данных, которые изменяют поведение этой службы.
AbstractService
 Inheritedoperations : Object
Массив операций обычно устанавливается только компилятором MXML при создании службы посредством тега MXML.
AbstractService
 InheritedrequestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений.
AbstractService
  showBusyCursor : Boolean
Если значение true, во время выполнения службы отображается курсор в состоянии занятости.
RemoteObject
  source : String
Позволяет указывать исходное значение в системе клиента; не поддерживается для адресов назначения с использованием JavaAdapter.
RemoteObject
Общедоступные методы
 МетодОпределено
  
RemoteObject(destination:String = null)
Создает новый RemoteObject.
RemoteObject
 Inherited
Разъединяет сетевое подключение службы и удаляет любые ответчики для запросов в очереди.
AbstractService
  
[переопределить] Возвращает операцию для данного имени.
RemoteObject
 Inherited
Вызов для инициализации службы.
AbstractService
 Inherited
Регистрирует пользователя за пределами адреса назначения.
AbstractService
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
Устанавливает учетные данные для адреса назначения, к которому обращалась служба при использовании Data Services на стороне сервера.
AbstractService
  
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
[переопределить] Если управление удаленным объектом осуществляется посредством внешней службы, например компонентом ColdFusion (CFC), для механизма аутентификации этой удаленной службы можно установить имя пользователя и пароль.
RemoteObject
  
Представляет экземпляр RemoteObject в виде строки с описанием важных свойств, например идентификатора адреса назначения и присвоенного набора каналов.
RemoteObject
События
 Событие Сводка Определено
 InheritedСобытие ошибки передается при ошибке вызова службы и отсутствии обработки этого вызова операцией.AbstractService
 InheritedСобытие вызова передается при вызове операции службы при отсутствии ошибки до попытки канала передать сообщение.AbstractService
 InheritedСобытие результата передается при успешном возврате вызова службы и отсутствии обработки этого вызова операцией.AbstractService
Сведения о свойстве

concurrency

свойство
concurrency:String

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Значение, которое указывает способ обработки нескольких вызовов одной службы. Значением по умолчанию является multiple. Допустимыми являются следующие значения:

  • multiple – Существующие запросы не отменяются, и разработчик несет ответственность за обеспечение непротиворечивости возвращенных данных путем тщательного управления потоком событий. Это значение по умолчанию.
  • single – Для метода создается только один запрос в конкретный момент времени; для дополнительных запросов, созданных во время ожидания обработки этим запросом, незамедлительно генерируется ошибка, и на сервер они не передаются.
  • last – При создании запроса клиент игнорирует событие результата или ошибки для любого текущего запроса в очереди. В систему клиента передаются только результат или ошибка для последнего запроса. Это позволяет упростить обработку событий в клиентском приложении, однако необходимо использовать такой режим только при возможности безопасного игнорирования результатов и ошибок для запросов.



Реализация
    public function get concurrency():String
    public function set concurrency(value:String):void

convertParametersHandler

свойство 
public var convertParametersHandler:Function

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Дополнительная функция, предназначенная, главным образом, для разработчиков инфраструктуры, которые должны установить функцию для вызова с параметрами, передаваемыми в каждый вызов удаленного объекта. Функция получает массив параметров и возвращает потенциально измененный массив. Определение функции должно иметь следующий вид: function myParametersFunction(parameters:Array):Array.

convertResultHandler

свойство 
public var convertResultHandler:Function

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Дополнительная функция, предназначенная, прежде всего, для разработчиков инфраструктуры, которые должны установить функцию для обработки результатов операции перед уведомлением обработчиков результатов. Определение функции должно иметь следующий вид: function myConvertResultsFunction(result: operation:AbstractOperation):. Результат передается только после преобразования makeObjectsBindable, но до создания события результата.

endpoint

свойство 
endpoint:String

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Это свойство позволяет разработчику быстро указать конечную точку для адреса назначения RemoteObject без ссылки на файл конфигурации службы во время компиляции или путем создания ChannelSet программным способом. Оно также отменяет существующий ChannelSet, если он установлен для службы RemoteObject.

Если URL-адрес конечной точки начинается с https, то используется SecureAMFChannel. В противном случае используется AMFChannel. В URL-адресе конечной точки для указания того, что канал должен использовать имя и порт сервера, которые применялись при загрузке SWF, доступны два специальных маркера: {server.name} и {server.port}.

Примечание. Это свойство требуется при создании приложений AIR.



Реализация
    public function get endpoint():String
    public function set endpoint(value:String):void

makeObjectsBindable

свойство 
makeObjectsBindable:Boolean

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable.



Реализация
    public function get makeObjectsBindable():Boolean
    public function set makeObjectsBindable(value:Boolean):void

showBusyCursor

свойство 
showBusyCursor:Boolean

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Если значение true, во время выполнения службы отображается курсор в состоянии занятости. Значение по умолчанию false.



Реализация
    public function get showBusyCursor():Boolean
    public function set showBusyCursor(value:Boolean):void

source

свойство 
source:String

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Позволяет указывать исходное значение в системе клиента; не поддерживается для адресов назначения с использованием JavaAdapter. Это позволяет предоставить несколько источников для доступа из одного адреса назначения на сервере.



Реализация
    public function get source():String
    public function set source(value:String):void
Сведения о конструкторе

RemoteObject

()Конструктор
public function RemoteObject(destination:String = null)

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Создает новый RemoteObject.

Параметры
destination:String (default = null) — [Дополнительно] Адрес назначения RemoteObject; должен соответствовать имени адреса назначения в файле services-config.xml.
Сведения о методе

getOperation

()метод
override public function getOperation(name:String):AbstractOperation

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Возвращает операцию для данного имени. Если операция не была создана заранее, в течение этого вызова создается новая операция mx.rpc.remoting.Operation. Как правило, доступ к операции можно получить путем простого указания ее имени после переменной службы (myService.someOperation), но если имя операции совпадает с определенным методом в службе (например, setCredentials), то для обращения к операции можно использовать этот метод.

Параметры

name:String — Имя операции.

Возвращает
AbstractOperation — Операция, которая выполняется для этого имени.

setRemoteCredentials

()метод 
override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Если управление удаленным объектом осуществляется посредством внешней службы, например компонентом ColdFusion (CFC), для механизма аутентификации этой удаленной службы можно установить имя пользователя и пароль.

Параметры

remoteUsername:String — Имя пользователя для передачи в удаленную конечную точку.
 
remotePassword:String — Пароль для передачи в удаленную конечную точку.
 
charset:String (default = null) — Кодировка набора символов для использования при кодировании учетных данных в удаленной службе. По умолчанию имеет нулевое значение, при котором используется унаследованный набор символов ISO-Latin-1. Помимо этого поддерживается только набор символов UTF-8.

toString

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

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Представляет экземпляр RemoteObject в виде строки с описанием важных свойств, например идентификатора адреса назначения и присвоенного набора каналов.

Возвращает
String — Возвращает строковое представление экземпляра RemoteObject.




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

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