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

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

<?xml version="1.0"?>
<!-- Simple example to demonstrate the RemoteObject tag. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

<!--  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>
-->

    <mx:Script>
        <![CDATA[
            import mx.controls.Alert;        
        ]]>    
    </mx:Script>

    <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>

    <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>    
</mx:Application>

Comments

mpeterson said on Jun 30, 2006 at 11:00 AM :

In the MXML example at the bottom of this page, "faultstring" should be "faultString".
- Mike Peterson
Adobe Flex documentation team

edward_apostol said on Mar 24, 2007 at 6:03 PM :

It would be useful to provide an example of connecting a Flex application to a remote object without the use of the destination attribute or configuring any config file.

smgilson said on Mar 26, 2007 at 1:10 PM :

Technically it's not easy out of the box.

You can make a feature request for this feature here: http://www.adobe.com/cfusion/mmform/index.cfm?name=wishform&product=20

Stephen Gilson
Flex Doc Team

brindy666 said on Nov 16, 2007 at 3:41 AM :

As a newbie I found it useful to know that the event objects are of type ResultEvent and FaultEvent respectively.

No screen name said on Jul 21, 2008 at 10:06 PM :

The description for the 'endpoint' property reads, "If the endpoint url starts with "https" a SecureAMFChannel will be used, otherwise an AMFChannel will be used"

However, if I set the endpoint to a relative path it always assumes http.

I believe this to be bug, if not would it be possible to have this object detect https when resolving the relative path?

mpeterson said on Jul 22, 2008 at 10:32 AM :

The ASDoc comment needs some additional text:
Relative URLs that retain the protocol of the loaded SWF file are not supported by this property. Iff you use a relative URL, the protocol will always be "http".
To get "https", the value you assign needs to start with "https".

- Mike Peterson
Flex doc team

No screen name said on Jul 22, 2008 at 4:56 PM :

Thank you for your quick response.

From what you're saying, if an swf is loaded through a secure channel (ie. via SSL), remoting data being sent to a gateway defined via a relative url will flow through an insecure channel instead of the original secure channel through which the swf itself was loaded.

So basically it's dangerous to use relative urls (at least for remoting) when the swf is loaded via SSL.

senthilckumar said on Jul 22, 2008 at 5:29 PM :

So this means a relative endpoint url will cause remoting data to be sent over an insecure channel even if the swf itself was loaded via a secure channel

I've got myself a work around for this by detecting the protocol using mx.core.Application.application.loaderInfo.url (on or after the applicationComplete event)

It would be less of a security issue if the endpoint property could do a similar sort of protocol resolution when it's set to a relative url