Package | mx.messaging.messages |
Class | public class CommandMessage |
Inheritance | CommandMessage AsyncMessage AbstractMessage Object |
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Property | Defined By | ||
---|---|---|---|
body : Object
The body of a message contains the specific data that needs to be
delivered to the remote destination. | AbstractMessage | ||
clientId : String
The clientId indicates which MessageAgent sent the message. | AbstractMessage | ||
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
correlationId : String
Provides access to the correlation id of the message. | AsyncMessage | ||
destination : String
The message destination. | AbstractMessage | ||
headers : 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 | ||
messageId : String
The unique id for the message. | AbstractMessage | ||
operation : uint
Provides access to the operation/command for the CommandMessage. | CommandMessage | ||
prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | ||
timestamp : Number
Provides access to the time stamp for the message. | AbstractMessage | ||
timeToLive : Number
The time to live value of a message indicates how long the message
should be considered valid and deliverable. | AbstractMessage |
Method | Defined By | ||
---|---|---|---|
Constructs an instance of a CommandMessage with an empty body and header
and a default operation of UNKNOWN_OPERATION. | CommandMessage | ||
[static]
Provides a description of the operation specified. | CommandMessage | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
[override]
Returns a string representation of the message. | CommandMessage | ||
Returns the primitive value of the specified object. | Object |
Constant | Defined By | ||
---|---|---|---|
ADD_SUBSCRIPTIONS : String = "DSAddSub" [static]
Header used in a MULTI_SUBSCRIBE message to specify an Array of subtopic/selector
pairs to add to the existing set of subscriptions. | CommandMessage | ||
AUTHENTICATION_MESSAGE_REF_TYPE : String = "flex.messaging.messages.AuthenticationMessage" [static]
The server message type for authentication commands. | CommandMessage | ||
CLIENT_PING_OPERATION : uint = 5 [static]
This operation is used to test connectivity over the current channel to
the remote endpoint. | CommandMessage | ||
CLIENT_SYNC_OPERATION : uint = 4 [static]
This operation is used by a remote destination to sync missed or cached messages
back to a client as a result of a client issued poll command. | CommandMessage | ||
CLUSTER_REQUEST_OPERATION : uint = 7 [static]
This operation is used to request a list of failover endpoint URIs
for the remote destination based on cluster membership. | CommandMessage | ||
CREDENTIALS_CHARSET_HEADER : String = "DSCredentialsCharset" [static]
Header to specify which character set encoding was used while encoding
login credentials. | CommandMessage | ||
DESTINATION_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 | ||
DISCONNECT_OPERATION : uint = 12 [static]
This operation is used to indicate that a channel has disconnected. | CommandMessage | ||
ENDPOINT_HEADER : String = "DSEndpoint" [static]
Messages are tagged with the endpoint id for the Channel they are sent over. | AbstractMessage | ||
FLEX_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 | ||
HEARTBEAT_HEADER : String = "DS<3" [static]
Header that indicates the message is a heartbeat. | CommandMessage | ||
LOGIN_OPERATION : uint = 8 [static]
This operation is used to send credentials to the endpoint so that
the user can be logged in over the current channel. | CommandMessage | ||
LOGOUT_OPERATION : uint = 9 [static]
This operation is used to log the user out of the current channel, and
will invalidate the server session if the channel is HTTP based. | CommandMessage | ||
MAX_FREQUENCY_HEADER : String = "DSMaxFrequency" [static]
Header to indicate the maximum number of messages a Consumer wants to
receive per second. | CommandMessage | ||
MESSAGING_VERSION : String = "DSMessagingVersion" [static]
Endpoints can imply what features they support by reporting the
latest version of messaging they are capable of during the handshake of
the initial ping CommandMessage. | CommandMessage | ||
MULTI_SUBSCRIBE_OPERATION : uint = 11 [static]
Used by the MultiTopicConsumer to subscribe/unsubscribe for more
than one topic in the same message. | CommandMessage | ||
NEEDS_CONFIG_HEADER : String = "DSNeedsConfig" [static]
Header to indicate that the Channel needs the configuration from the
server. | CommandMessage | ||
NO_OP_POLL_HEADER : String = "DSNoOpPoll" [static]
Header to suppress poll response processing. | CommandMessage | ||
POLL_OPERATION : uint = 2 [static]
This operation is used to poll a remote destination for pending,
undelivered messages. | CommandMessage | ||
POLL_WAIT_HEADER : String = "DSPollWait" [static]
Header to drive an idle wait time before the next client poll request. | CommandMessage | ||
PRESERVE_DURABLE_HEADER : String = "DSPreserveDurable" [static]
Durable JMS subscriptions are preserved when an unsubscribe message
has this parameter set to true in its header. | CommandMessage | ||
PRIORITY_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 | ||
REMOTE_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 | ||
REMOTE_CREDENTIALS_HEADER : String = "DSRemoteCredentials" [static]
Messages that need to set remote credentials for a destination
carry the Base64 encoded credentials in this header. | AbstractMessage | ||
REMOVE_SUBSCRIPTIONS : String = "DSRemSub" [static]
Like the above, but specifies the subtopic/selector array of to remove
| CommandMessage | ||
REQUEST_TIMEOUT_HEADER : String = "DSRequestTimeout" [static]
Messages sent with a defined request timeout use this header. | AbstractMessage | ||
SELECTOR_HEADER : String = "DSSelector" [static]
Subscribe commands issued by a Consumer pass the Consumer's selector
expression in this header. | CommandMessage | ||
STATUS_CODE_HEADER : String = "DSStatusCode" [static]
A status code can provide context about the nature of a response
message. | AbstractMessage | ||
SUBSCRIBE_OPERATION : uint = 0 [static]
This operation is used to subscribe to a remote destination. | CommandMessage | ||
SUBSCRIPTION_INVALIDATE_OPERATION : uint = 10 [static]
This operation is used to indicate that the client's subscription with a
remote destination has timed out. | CommandMessage | ||
SUBTOPIC_HEADER : String = "DSSubtopic" [static]
Messages sent by a MessageAgent with a defined subtopic
property indicate their target subtopic in this header. | AsyncMessage | ||
SUBTOPIC_SEPARATOR : String = "_;_" [static]
The separator string used for separating subtopic and selectors in the
add and remove subscription headers. | CommandMessage | ||
TRIGGER_CONNECT_OPERATION : uint = 13 [static]
This operation is used to trigger a ChannelSet to connect. | CommandMessage | ||
UNKNOWN_OPERATION : uint = 10000 [static]
This is the default operation for new CommandMessage instances. | CommandMessage | ||
UNSUBSCRIBE_OPERATION : uint = 1 [static]
This operation is used to unsubscribe from a remote destination. | CommandMessage |
operation | property |
public var operation:uint
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Provides access to the operation/command for the CommandMessage. Operations indicate how this message should be processed by the remote destination.
CommandMessage | () | Constructor |
public function CommandMessage()
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Constructs an instance of a CommandMessage with an empty body and header
and a default operation
of UNKNOWN_OPERATION
.
getOperationAsString | () | method |
public static function getOperationAsString(op:uint):String
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Provides a description of the operation specified.
This method is used in toString()
operations on this
message.
Parameters
op:uint — One of the CommandMessage operation constants.
|
String — Short name for the operation.
|
Example
How to use this example
var msg:CommandMessage = CommandMessage(event.message);
trace("Current operation -'"+
CommandMessage.getOperationAsString(msg.operation)+ "'.");
toString | () | method |
override public function toString():String
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a string representation of the message.
ReturnsString — String representation of the message.
|
ADD_SUBSCRIPTIONS | Constant |
public static const ADD_SUBSCRIPTIONS:String = "DSAddSub"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header used in a MULTI_SUBSCRIBE message to specify an Array of subtopic/selector pairs to add to the existing set of subscriptions.
AUTHENTICATION_MESSAGE_REF_TYPE | Constant |
public static const AUTHENTICATION_MESSAGE_REF_TYPE:String = "flex.messaging.messages.AuthenticationMessage"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The server message type for authentication commands.
CLIENT_PING_OPERATION | Constant |
public static const CLIENT_PING_OPERATION:uint = 5
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to test connectivity over the current channel to the remote endpoint.
CLIENT_SYNC_OPERATION | Constant |
public static const CLIENT_SYNC_OPERATION:uint = 4
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used by a remote destination to sync missed or cached messages back to a client as a result of a client issued poll command.
CLUSTER_REQUEST_OPERATION | Constant |
public static const CLUSTER_REQUEST_OPERATION:uint = 7
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to request a list of failover endpoint URIs for the remote destination based on cluster membership.
CREDENTIALS_CHARSET_HEADER | Constant |
public static const CREDENTIALS_CHARSET_HEADER:String = "DSCredentialsCharset"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header to specify which character set encoding was used while encoding login credentials.
DISCONNECT_OPERATION | Constant |
public static const DISCONNECT_OPERATION:uint = 12
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to indicate that a channel has disconnected.
HEARTBEAT_HEADER | Constant |
public static const HEARTBEAT_HEADER:String = "DS<3"
Header that indicates the message is a heartbeat.
LOGIN_OPERATION | Constant |
public static const LOGIN_OPERATION:uint = 8
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to send credentials to the endpoint so that
the user can be logged in over the current channel.
The credentials need to be Base64 encoded and stored in the body
of the message.
LOGOUT_OPERATION | Constant |
public static const LOGOUT_OPERATION:uint = 9
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to log the user out of the current channel, and will invalidate the server session if the channel is HTTP based.
MAX_FREQUENCY_HEADER | Constant |
public static const MAX_FREQUENCY_HEADER:String = "DSMaxFrequency"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header to indicate the maximum number of messages a Consumer wants to receive per second.
MESSAGING_VERSION | Constant |
public static const MESSAGING_VERSION:String = "DSMessagingVersion"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Endpoints can imply what features they support by reporting the latest version of messaging they are capable of during the handshake of the initial ping CommandMessage.
MULTI_SUBSCRIBE_OPERATION | Constant |
public static const MULTI_SUBSCRIBE_OPERATION:uint = 11
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Used by the MultiTopicConsumer to subscribe/unsubscribe for more than one topic in the same message.
NEEDS_CONFIG_HEADER | Constant |
public static const NEEDS_CONFIG_HEADER:String = "DSNeedsConfig"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header to indicate that the Channel needs the configuration from the server.
NO_OP_POLL_HEADER | Constant |
public static const NO_OP_POLL_HEADER:String = "DSNoOpPoll"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header to suppress poll response processing. If a client has a long-poll parked on the server and issues another poll, the response to this subsequent poll should be tagged with this header in which case the response is treated as a no-op and the next poll will not be scheduled. Without this, a subsequent poll will put the channel and endpoint into a busy polling cycle.
POLL_OPERATION | Constant |
public static const POLL_OPERATION:uint = 2
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to poll a remote destination for pending, undelivered messages.
POLL_WAIT_HEADER | Constant |
public static const POLL_WAIT_HEADER:String = "DSPollWait"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Header to drive an idle wait time before the next client poll request.
PRESERVE_DURABLE_HEADER | Constant |
public static const PRESERVE_DURABLE_HEADER:String = "DSPreserveDurable"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Durable JMS subscriptions are preserved when an unsubscribe message has this parameter set to true in its header.
REMOVE_SUBSCRIPTIONS | Constant |
public static const REMOVE_SUBSCRIPTIONS:String = "DSRemSub"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Like the above, but specifies the subtopic/selector array of to remove
SELECTOR_HEADER | Constant |
public static const SELECTOR_HEADER:String = "DSSelector"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Subscribe commands issued by a Consumer pass the Consumer's selector
expression in this header.
SUBSCRIBE_OPERATION | Constant |
public static const SUBSCRIBE_OPERATION:uint = 0
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to subscribe to a remote destination.
SUBSCRIPTION_INVALIDATE_OPERATION | Constant |
public static const SUBSCRIPTION_INVALIDATE_OPERATION:uint = 10
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to indicate that the client's subscription with a remote destination has timed out.
SUBTOPIC_SEPARATOR | Constant |
public static const SUBTOPIC_SEPARATOR:String = "_;_"
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The separator string used for separating subtopic and selectors in the add and remove subscription headers.
TRIGGER_CONNECT_OPERATION | Constant |
public static const TRIGGER_CONNECT_OPERATION:uint = 13
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to trigger a ChannelSet to connect.
UNKNOWN_OPERATION | Constant |
public static const UNKNOWN_OPERATION:uint = 10000
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This is the default operation for new CommandMessage instances.
UNSUBSCRIBE_OPERATION | Constant |
public static const UNSUBSCRIBE_OPERATION:uint = 1
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This operation is used to unsubscribe from a remote destination.
Fri Mar 19 2010, 02:45 AM -07:00