mx.collections

# ItemResponder - AS3 Flex

Package | mx.collections
Class | public class ItemResponder
Inheritance | ItemResponder Object
Implements | IResponder

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

The ItemResponder class provides a default implementation of the `mx.rpc.IResponder` interface. It represents a responder that lets you specify methods to be called when a request is completed, either successfully or with an error. The class object can also lets you provide data (a token) to be used by the responder methods.

You use an `ItemResponder` object in the `catch` statement of a try block that might result in getting remote data, as shown in the following code:

         import mx.collections.ItemResponder;
         //...

         try
         {
            //...
            cursor.moveNext();
         }
        catch(e:ItemPendingError)
         {
            e.addResponder(new ItemResponder(myResultFunction, myFaultFunction, {info:"..."}));
         }

The result method specified must have the following signature:

`

         public function myResultFunction(result:Object, token:Object = null):void;

`

The fault method specified must have the following signature:

`

         public function myFaultFunction(error:Object, token:Object = null):void;

`

Any other signature will result in a runtime error.

Related API Elements

mx.collections.errors.ItemPendingError

Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | constructor : Object A reference to the class object or constructor function for a given object instance. | Object

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | ItemResponder(result:Function, fault:Function, token:Object = null) Constructs an instance of the responder with the specified data and handlers. | ItemResponder
|  | fault(info:Object):void This method is called by a service when an error has been received. | ItemResponder
|  | hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined. | Object
|  | 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
|  | propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable. | Object
|  | result(data:Object):void This method is called by a service when the return value has been received. | ItemResponder
|  | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations. | Object
|  | toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions. | Object
|  | toString():String Returns the string representation of the specified object. | Object
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Constructor Detail

### ItemResponder

()
Constructor

`public function ItemResponder(result:Function, fault:Function, token:Object = null)`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

Constructs an instance of the responder with the specified data and handlers.

Parameters

| `result:Function` — Function that should be called when the request has completed successfully. Must have the following signature: `
    	     		    public function (result:Object, token:Object = null):void;
`
| `fault:Function` — Function that should be called when the request has completed with errors. Must have the following signature: `
    	     		    public function (error:ErrorMessage, token:Object = null):void;
`
| `token:Object` (default = `null`)`` — Object [optional] additional information to associate with this request. This object is passed to the result and fault functions as their second parameter.

Method Detail

### fault

()
method

`public function fault(info:Object):void`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

This method is called by a service when an error has been received.

Parameters

| `info:Object` — Object containing the information about the error that occured.

### result

()
method

`public function result(data:Object):void`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

This method is called by a service when the return value has been received.

Parameters

| `data:Object` — Object containing the information returned from the request.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00