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

RemoteObject  - AS3 Flex

Пакетmx.rpc.remoting.mxml
Классpublic dynamic class RemoteObject
НаследованиеRemoteObject Inheritance RemoteObject Inheritance AbstractService Inheritance Proxy
Реализует IMXMLSupport, IMXMLObject

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

Тег <mx:RemoteObject> используется для представления объекта HTTPService в файле MXML. Этот тег предоставляет доступ к методам объектов Java с использованием кодировки в формате Action Message Format (AMF).

Синтаксис MXMLexpandedСкрыть синтаксис MXML

The <mx:RemoteObject> tag accepts the following tag attributes:

 <mx:RemoteObject
  Properties
  concurrency="multiple|single|last"
  destination="No default."
  id="No default."
  endpoint="No default."
  showBusyCursor="false|true"
  source="No default." (currently, Adobe ColdFusion only)
  makeObjectsBindable="false|true"
  
  Events
  fault="No default."
  result="No default."  
 />
 

<mx:RemoteObject> can have multiple <mx:method> tags, which have the following tag attributes:

 <mx:method
  Properties
  concurrency="multiple|single|last"
  name="No default, required."
  makeObjectsBindable="false|true"
         
 Events
  fault="No default."
  result="No default."
 />
 

It then can have a single <mx:arguments> child tag which is an array of objects that is passed in order.

Посмотреть примеры



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

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.mxml.Operation. Как правило, доступ к операции можно получить путем простого указания ее имени после переменной службы (myService.someOperation), но если имя операции совпадает с определенным методом в службе (например, setCredentials), то для обращения к операции можно использовать этот метод.

Параметры

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

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

initialized

()метод 
public function initialized(document:Object, id:String):void

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

Вызывается автоматически компилятором MXML, если RemoteObject настроен с использованием тега. Если RemoteObject создается через ActionScript, может потребоваться вызвать этот метод самостоятельно, поскольку его использование рекомендуется для проверки правильности любых аргументов.

Параметры

document:Object — MXML-документ, в котором находится данный RemoteObject.
 
id:String — идентификатор данного RemoteObject в документе.

RemoteObjectExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the RemoteObject tag. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" 
     xmlns:s="library://ns.adobe.com/flex/spark" 
     xmlns:mx="library://ns.adobe.com/flex/mx">
        
    <!--  Make sure the Flex Data Services proxy-config.xml file contains the following definition.
    The Java class mypackage.stockquote.MyTicker.class must be available on the 
    web application's classpath.
        
    <destination id="MyRemoteObjectDest">
        <properties>
            <source>mypackage.stockquote.MyTicker</source>
            <scope>application</scope>
        </properties>
    </destination>
    -->
        
    <fx:Script>
        <![CDATA[
            import mx.controls.Alert;        
        ]]>    
    </fx:Script>

    <fx:Declarations>
        <mx:RemoteObject id="RO" destination="MyRemoteObjectDest"
            fault="Alert.show(event.fault.faultString), 'Error'">
            
            <mx:method name="GetQuote">
                <mx:arguments>
                    <symbol>{stockSymbol.text}</symbol>
                </mx:arguments>
            </mx:method>
        </mx:RemoteObject>
    </fx:Declarations>
        
    <mx:Panel title="RemoteObject Example" height="75%" width="75%" 
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
            
        <mx:Label width="100%"  color="blue"
            text="Enter a stock symbol to obtain a quote."/>
            
        <mx:TextInput id="stockSymbol" text="ADBE"/>
        <mx:Button label="Get Quote" click="RO.GetQuote.send()"/>
            
        <mx:Text htmlText="Company: {RO.GetQuote.lastResult.GetQuoteResult.StockQuote.Company}"/>
        <mx:Text htmlText="Current price: ${RO.GetQuote.lastResult.GetQuoteResult.StockQuote.Price}"/>
    </mx:Panel>    
</s:Application>




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

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