Packagemx.messaging.messages
Classpublic class ErrorMessage
InheritanceErrorMessage Inheritance AcknowledgeMessage Inheritance AsyncMessage Inheritance AbstractMessage Inheritance Object

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

The ErrorMessage class is used to report errors within the messaging system. An error message only occurs in response to a message sent within the system.



Public Properties
 PropertyDefined By
 Inheritedbody : Object
The body of a message contains the specific data that needs to be delivered to the remote destination.
AbstractMessage
 InheritedclientId : String
The clientId indicates which MessageAgent sent the message.
AbstractMessage
 InheritedcorrelationId : String
Provides access to the correlation id of the message.
AsyncMessage
 Inheriteddestination : String
The message destination.
AbstractMessage
  extendedData : Object
Extended data that the remote destination has chosen to associate with this error to facilitate custom error processing on the client.
ErrorMessage
  faultCode : String
The fault code for the error.
ErrorMessage
  faultDetail : String
Detailed description of what caused the error.
ErrorMessage
  faultString : String
A simple description of the error.
ErrorMessage
 Inheritedheaders : Object
The headers of a message are an associative array where the key is the header name and the value is the header value.
AbstractMessage
 InheritedmessageId : String
The unique id for the message.
AbstractMessage
  rootCause : Object
Should a root cause exist for the error, this property contains those details.
ErrorMessage
 Inheritedtimestamp : Number
Provides access to the time stamp for the message.
AbstractMessage
 InheritedtimeToLive : Number
The time to live value of a message indicates how long the message should be considered valid and deliverable.
AbstractMessage
Public Methods
 MethodDefined By
  
Constructs an ErrorMessage instance.
ErrorMessage
 Inherited
toString():String
Returns a string representation of the message.
AbstractMessage
Public Constants
 ConstantDefined By
 InheritedDESTINATION_CLIENT_ID_HEADER : String = DSDstClientId
[static] Messages pushed from the server may arrive in a batch, with messages in the batch potentially targeted to different Consumer instances.
AbstractMessage
 InheritedENDPOINT_HEADER : String = DSEndpoint
[static] Messages are tagged with the endpoint id for the Channel they are sent over.
AbstractMessage
 InheritedERROR_HINT_HEADER : String = DSErrorHint
[static] Header name for the error hint header.
AcknowledgeMessage
 InheritedFLEX_CLIENT_ID_HEADER : String = DSId
[static] This header is used to transport the global FlexClient Id value in outbound messages once it has been assigned by the server.
AbstractMessage
  MESSAGE_DELIVERY_IN_DOUBT : String = Client.Error.DeliveryInDoubt
[static] If a message may not have been delivered, the faultCode will contain this constant.
ErrorMessage
 InheritedPRIORITY_HEADER : String = DSPriority
[static] Messages sent by a MessageAgent can have a priority header with a 0-9 numerical value (0 being lowest) and the server can choose to use this numerical value to prioritize messages to clients.
AbstractMessage
 InheritedREMOTE_CREDENTIALS_CHARSET_HEADER : String = DSRemoteCredentialsCharset
[static] Messages that need to set remote credentials for a destination may also need to report the character-set encoding that was used to create the credentials String using this header.
AbstractMessage
 InheritedREMOTE_CREDENTIALS_HEADER : String = DSRemoteCredentials
[static] Messages that need to set remote credentials for a destination carry the Base64 encoded credentials in this header.
AbstractMessage
 InheritedREQUEST_TIMEOUT_HEADER : String = DSRequestTimeout
[static] Messages sent with a defined request timeout use this header.
AbstractMessage
  RETRYABLE_HINT_HEADER : String = DSRetryableErrorHint
[static] Header name for the retryable hint header.
ErrorMessage
 InheritedSTATUS_CODE_HEADER : String = DSStatusCode
[static] A status code can provide context about the nature of a response message.
AbstractMessage
 InheritedSUBTOPIC_HEADER : String = DSSubtopic
[static] Messages sent by a MessageAgent with a defined subtopic property indicate their target subtopic in this header.
AsyncMessage
Property Detail
extendedDataproperty
public var extendedData:Object

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

Extended data that the remote destination has chosen to associate with this error to facilitate custom error processing on the client.

faultCodeproperty 
public var faultCode:String

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

The fault code for the error. This value typically follows the convention of "[outer_context].[inner_context].[issue]". For example: "Channel.Connect.Failed", "Server.Call.Failed", etc.

faultDetailproperty 
public var faultDetail:String

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

Detailed description of what caused the error. This is typically a stack trace from the remote destination.

faultStringproperty 
public var faultString:String

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

A simple description of the error.

rootCauseproperty 
public var rootCause:Object

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

Should a root cause exist for the error, this property contains those details. This may be an ErrorMessage, a NetStatusEvent info Object, or an underlying Flash error event: ErrorEvent, IOErrorEvent, or SecurityErrorEvent.

Constructor Detail
ErrorMessage()Constructor
public function ErrorMessage()

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

Constructs an ErrorMessage instance.

Constant Detail
MESSAGE_DELIVERY_IN_DOUBTConstant
public static const MESSAGE_DELIVERY_IN_DOUBT:String = Client.Error.DeliveryInDoubt

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

If a message may not have been delivered, the faultCode will contain this constant.

RETRYABLE_HINT_HEADERConstant 
public static const RETRYABLE_HINT_HEADER:String = DSRetryableErrorHint

Language Version : ActionScript 3.0
Product Versions : BlazeDS 4, LCDS 3
Runtime Versions : Flash Player 9, AIR 1.1

Header name for the retryable hint header. This is used to indicate that the operation that generated the error may be retryable rather than fatal.