RemoteObject

Paket	mx.rpc.remoting
Klass	public dynamic class RemoteObject
Arv	RemoteObject AbstractService Proxy
Underklasser	RemoteObject

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		channelSet : ChannelSet Provides access to the ChannelSet used by the service.	AbstractService
		concurrency : String Value that indicates how to handle multiple calls to the same service.	RemoteObject
		convertParametersHandler : Function An optional function, primarily intended for framework developers who need to install a function to get called with the parameters passed to each remote object invocation.	RemoteObject
		convertResultHandler : Function An optional function, primarily intended for framework developers who need to install a hook to process the results of an operation before notifying the result handlers.	RemoteObject
		destination : String The destination of the service.	AbstractService
		endpoint : String This property allows the developer to quickly specify an endpoint for a RemoteObject destination without referring to a services configuration file at compile time or programmatically creating a ChannelSet.	RemoteObject
		makeObjectsBindable : Boolean When this value is true, anonymous objects returned are forced to bindable objects.	RemoteObject
		managers : Array The managers property stores a list of data managers which modify the behavior of this service.	AbstractService
		operations : Object The Operations array is usually only set by the MXML compiler if you create a service using an MXML tag.	AbstractService
		requestTimeout : int Provides access to the request timeout in seconds for sent messages.	AbstractService
		showBusyCursor : Boolean If true, a busy cursor is displayed while a service is executing.	RemoteObject
		source : String Lets you specify a source value on the client; not supported for destinations that use the JavaAdapter.	RemoteObject

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		RemoteObject(destination:String = null) Creates a new RemoteObject.	RemoteObject
		disconnect():void Disconnects the service's network connection and removes any pending request responders.	AbstractService
		getOperation(name:String):AbstractOperation [åsidosätt] Returns an Operation of the given name.	RemoteObject
		initialize():void Called to initialize the service.	AbstractService
		logout():void Logs the user out of the destination.	AbstractService
		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
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void [åsidosätt] 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

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
fault	The fault event is dispatched when a service call fails and isn't handled by the Operation itself.	AbstractService
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
result	The result event is dispatched when a service call successfully returns and isn't handled by the Operation itself.	AbstractService

Egenskapsdetaljer

concurrency

egenskap

concurrency:String

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

Value that indicates how to handle multiple calls to the same service. The default value is multiple. The following values are permitted:

multiple - Existing requests are not cancelled, and the developer is responsible for ensuring the consistency of returned data by carefully managing the event stream. This is the default.
single - Making only one request at a time is allowed on the method; additional requests made while a request is outstanding are immediately faulted on the client and are not sent to the server.
last - Making a request causes the client to ignore a result or fault for any current outstanding request. Only the result or fault for the most recent request will be dispatched on the client. This may simplify event handling in the client application, but care should be taken to only use this mode when results or faults for requests may be safely ignored.

Implementering
public function get concurrency():String
public function set concurrency(value:String):void

convertParametersHandler

egenskap

public var convertParametersHandler:Function

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

An optional function, primarily intended for framework developers who need to install a function to get called with the parameters passed to each remote object invocation. The function takes an array of parameters and returns the potentially altered array. The function definition should look like: function myParametersFunction(parameters:Array):Array

convertResultHandler

egenskap

public var convertResultHandler:Function

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

An optional function, primarily intended for framework developers who need to install a hook to process the results of an operation before notifying the result handlers. The function definition should look like: function myConvertResultsFunction(result: operation:AbstractOperation): It is passed the result just after the makeObjectsBindable conversion has been done but before the result event is created.

endpoint

egenskap

endpoint:String

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

This property allows the developer to quickly specify an endpoint for a RemoteObject destination without referring to a services configuration file at compile time or programmatically creating a ChannelSet. It also overrides an existing ChannelSet if one has been set for the RemoteObject service.

If the endpoint url starts with "https" a SecureAMFChannel will be used, otherwise an AMFChannel will be used. Two special tokens, {server.name} and {server.port}, can be used in the endpoint url to specify that the channel should use the server name and port that was used to load the SWF.

Note: This property is required when creating AIR applications.

Implementering
public function get endpoint():String
public function set endpoint(value:String):void

makeObjectsBindable

egenskap

makeObjectsBindable:Boolean

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

Implementering
public function get makeObjectsBindable():Boolean
public function set makeObjectsBindable(value:Boolean):void

showBusyCursor

egenskap

showBusyCursor:Boolean

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

If true, a busy cursor is displayed while a service is executing. The default value is false.

Implementering
public function get showBusyCursor():Boolean
public function set showBusyCursor(value:Boolean):void

source

egenskap

source:String

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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.

Implementering
public function get source():String
public function set source(value:String):void

Konstruktordetaljer

()

Konstruktor

public function RemoteObject(destination:String = null)

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

Creates a new RemoteObject.

Parametrar

destination:String (default = null) — [optional] Destination of the RemoteObject; should match a destination name in the services-config.xml file.

Metoddetaljer

getOperation

()

metod

override public function getOperation(name:String):AbstractOperation

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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.

Parametrar

name:String — Name of the Operation.

Returnerar

AbstractOperation — Operation that executes for this name.

setRemoteCredentials

()

metod

override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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.

Parametrar

	`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

()

metod

public function toString():String

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

Returnerar

String — Returns a String representing an instance of a RemoteObject.

Juridiska meddelanden | Onlinesekretesspolicy

RemoteObject - AS3 Flex

Klasser x

concurrency

convertParametersHandler

convertResultHandler

endpoint

makeObjectsBindable

showBusyCursor

source

RemoteObject

getOperation

setRemoteCredentials

toString