An invoker is an object that actually executes a remote procedure call (RPC). For example, RemoteObject, HTTPService, and WebService objects are invokers.

Variables

@:flash.propertyread onlykeepLastResult:Bool

Flag indicating whether the operation should keep its last call result for later access.

If set to true, the last call result will be accessible through lastResult bindable property.

If set to false, the last call result will be cleared after the call, and must be processed in the operation's result handler. This will allow the result object to be garbage collected, which is especially useful if the operation is only called a few times and returns a large result.

If not set, will use the keepLastResult value of its owning Service, if any, or the default value.

See also:

  • lastResult

  • mx.rpc.AbstractService#keepLastResult

@:flash.propertyread onlylastResult:Dynamic

The result of the last invocation.

@:flash.propertymakeObjectsBindable:Bool

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

operationManager:Function

This property is set usually by framework code which wants to modify the behavior of a service invocation without modifying the way in which the service is called externally. This allows you to add a "filter" step on the method call to ensure for example that you do not return duplicate instances for the same id or to insert parameters for performing on-demand paging.

When this is set to a non-null value on the send call, the operationManager function is called instead. It returns the token that the caller uses to be notified of the result. Typically the called function will at some point clear this property temporarily, then invoke the operation again actually sending it to the server this time.

resultElementType:Class<Dynamic>

Like resultType, used to define the ActionScript class used by a given operation though this property only applies to operations which return a multi-valued result (e.g. an Array or ArrayCollection (IList)). This property specifies an ActionScript class for the members of the array or array collection. When you set resultElementType, you do not have to set resultType. In that case, the operation returns an Array if makeObjectsbindable is false and an ArrayCollection otherwise.

resultType:Class<Dynamic>

Specifies an optional return type for the operation. Used in situations where you want to coerce the over-the-wire information into a specific ActionScript class or to provide metadata for other services as to the return type of this operation.

Methods

@:value({ id : null })cancel(?id:String):AsyncToken

Cancels the last service invocation or an invokation with the specified ID. Even though the network operation may still continue, no result or fault event is dispatched.

Parameters:

id

The messageId of the invocation to cancel. Optional. If omitted, the last service invocation is canceled.

Returns:

The AsyncToken associated with the call that is cancelled or null if no call was cancelled.

@:value({ fireBindingEvent : true })clearResult(fireBindingEvent:Bool = true):Void

Sets the result property of the invoker to null. This is useful when the result is a large object that is no longer being used.

Parameters:

fireBindingEvent

Set to true if you want anything bound to the result to update. Otherwise, set to false. The default value is true

setResult(result:Any):Void

This hook is exposed to update the lastResult property. Since lastResult is ordinarily updated automatically by the service, you do not typically call this. It is used by managed services that want to ensure lastResult always points to "the" managed instance for a given identity even if the the service returns a new copy of the same object.

Parameters:

result

The new value for the lastResult property.