View comments | RSS feed
(Adobe® Flex™ Data Services 2 only)
Packagemx.rpc.remoting
Classpublic dynamic class RemoteObject
InheritanceRemoteObject Inheritance AbstractService Inheritance Proxy Inheritance Object
SubclassesRemoteObject

The RemoteObject class gives you access to classes on a remote application server.

See also

Using RPC Components

Public Properties
 PropertyDefined by
 InheritedchannelSet : ChannelSet
Provides access to the ChannelSet used by the service.
AbstractService
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheriteddestination : String
The destination of the service.
AbstractService
  makeObjectsBindable : Boolean
When this value is true, anonymous objects returned are forced to bindable objects.
RemoteObject
 Inheritedoperations : Object
The Operations array is usually only set by the MXML compiler if you create a service using an MXML tag.
AbstractService
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
 InheritedrequestTimeout : int
Provides access to the request timeout in seconds for sent messages.
AbstractService
  source : String
Lets you specify a source value on the client; not supported for destinations that use the JavaAdapter.
RemoteObject
Public Methods
 MethodDefined by
  
RemoteObject(destination:String = null)
Creates a new RemoteObject.
RemoteObject
 Inherited
disconnect():void
Disconnects the service's network connection and removes any pending request responders.
AbstractService
 Inherited
getOperation(name:String):AbstractOperation
Returns an Operation of the given name.
AbstractService
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
logout():void
Logs the user out of the destination.
AbstractService
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
setCredentials(username:String, password:String):void
Set the credentials for the destination accessed by the service.
AbstractService
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
  
setRemoteCredentials(remoteUsername:String, remotePassword:String):void
If a remote object is managed by an external service, such a ColdFusion Component (CFC), a username and password can be set for the authentication mechanism of that remote service.
RemoteObject
  
toString():String
Represents an instance of RemoteObject as a String, describing important properties such as the destination id and the set of channels assigned.
RemoteObject
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
Protected Methods
 MethodDefined by
 Inherited
callProperty(name:*, ... rest):*
Overrides the behavior of an object property that can be called as a function.
Proxy
 Inherited
deleteProperty(name:*):Boolean
Overrides the request to delete a property.
Proxy
 Inherited
getDescendants(name:*):*
Overrides the use of the descendant operator.
Proxy
 Inherited
getProperty(name:*):*
Overrides any request for a property's value.
Proxy
 Inherited
hasProperty(name:*):Boolean
Overrides a request to check whether an object has a particular property by name.
Proxy
 Inherited
isAttribute(name:*):Boolean
Checks whether a supplied QName is also marked as an attribute.
Proxy
 Inherited
nextName(index:int):String
Allows enumeration of the proxied object's properties by index number to retrieve property names.
Proxy
 Inherited
nextNameIndex(index:int):int
Allows enumeration of the proxied object's properties by index number.
Proxy
 Inherited
nextValue(index:int):*
Allows enumeration of the proxied object's properties by index number to retrieve property values.
Proxy
 Inherited
setProperty(name:*, value:*):void
Overrides a call to change a property's value.
Proxy
Events
 EventSummaryDefined by
 Inherited
fault
The fault event is dispatched when a service call fails and isn't handled by the Operation itself.AbstractService
 Inherited
invoke
The invoke event is dispatched when a service Operation is invoked so long as an Error is not thrown before the Channel attempts to send the message.AbstractService
 Inherited
result
The result event is dispatched when a service call successfully returns and isn't handled by the Operation itself.AbstractService
Property detail
makeObjectsBindableproperty
makeObjectsBindable:Boolean  [read-write]

When this value is true, anonymous objects returned are forced to bindable objects.

Implementation
    public function get makeObjectsBindable():Boolean
    public function set makeObjectsBindable(value:Boolean):void
sourceproperty 
source:String  [read-write]

Lets you specify a source value on the client; not supported for destinations that use the JavaAdapter. This allows you to provide more than one source that can be accessed from a single destination on the server.

Implementation
    public function get source():String
    public function set source(value:String):void
Constructor detail
RemoteObject()constructor
public function RemoteObject(destination:String = null)

Creates a new RemoteObject.

Parameters
destination:String (default = null) — [optional] Destination of the RemoteObject; should match a destination name in the services-config.xml file.
Method detail
setRemoteCredentials()method
public override function setRemoteCredentials(remoteUsername:String, remotePassword:String):void

If a remote object is managed by an external service, such a ColdFusion Component (CFC), a username and password can be set for the authentication mechanism of that remote service.

Parameters
remoteUsername:String — the username to pass to the remote endpoint
 
remotePassword:String — the password to pass to the remote endpoint
toString()method 
public function toString():String

Represents an instance of RemoteObject as a String, describing important properties such as the destination id and the set of channels assigned.

Returns
String



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
Tue May 15 2007, 11:34 AM GMT-04:00

Take a survey


Comments


jag57 said on Mar 9, 2007 at 5:40 PM :
A convenient "destination" for accessing CFCs is "ColdFusion".

Then, you can set the "source" property to the path starting at the root folder to your CFC, but use periods "." instead of slashes "/".

e.g. "cfc.SomeCFC" (http://website.com/cfc/SomeCFC)
FlismFlazim said on Jan 8, 2008 at 5:41 PM :
Also note you can set the endPoint if you want to use an abosulte URL during testing. Here's an example for ColdFusion

<mx:RemoteObject
id="myService"
source="path.to.mycfc.TrackerSample"
destination="ColdFusion"
endpoint="http://myColdFusionServer.com/flex2gateway"
makeObjectsBindable="true"
showBusyCursor="true" >
<mx:method name="getUsers" result="handleResult(event)" fault="Alert.show(event.fault.message)"/>
</mx:RemoteObject>

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flex/201/langref/mx/rpc/remoting/RemoteObject.html