class AbstractInvoker
package feathers.rpc
extends EventDispatcher
extended by HTTPService, AbstractOperation
An invoker is an object that actually executes a remote procedure call (RPC). For example, RemoteObject, HTTPService, and WebService objects are invokers.
Variables
read 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
makeObjectsBindable: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
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.
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 |
---|
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. |
---|