Packagemx.rpc.remoting
Classpublic dynamic class RemoteObject
InheritanceRemoteObject Inheritance AbstractService Inheritance Proxy Inheritance Object
Subclasses RemoteObject

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


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
  
getOperation(name:String):AbstractOperation
Returns an Operation of the given name.
RemoteObject
 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, charset:String = null):void
Sets the credentials for the destination accessed by the service when using Data Services on the server side.
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, charset:String = null):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
Events
 Event Summary Defined 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
getOperation()method
public override function getOperation(name:String):AbstractOperation

Returns an Operation of the given name. If the Operation wasn't created beforehand, a new mx.rpc.remoting.Operation is created during this call. Operations are usually accessible by simply naming them after the service variable (myService.someOperation), but if your Operation name happens to match a defined method on the service (like setCredentials), you can use this method to get the Operation instead.

Parameters

name:String — Name of the Operation.

Returns
AbstractOperation — Operation that executes for this name.
setRemoteCredentials()method 
public override function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):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
 
charset:String (default = null) — The character set encoding to use while encoding the remote credentials. The default is null, which implies the legacy charset of ISO-Latin-1. The only other supported charset is "UTF-8".

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-2007 Adobe Systems Incorporated. All rights reserved.
Fri Feb 15 2008, 2:47 AM GMT-08:00