ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
mx.messaging 

AdvancedChannelSet  - AS3 ADEP Data Services

Packagemx.messaging
Classpublic class AdvancedChannelSet
InheritanceAdvancedChannelSet Inheritance ChannelSet Inheritance EventDispatcher Inheritance Object

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Extends the base ChannelSet to add advanced messaging functionality.

Default MXML Propertychannels



Public Properties
 PropertyDefined By
 Inheritedauthenticated : Boolean
[read-only] Indicates whether the ChannelSet has an underlying Channel that successfully authenticated with its endpoint.
ChannelSet
 InheritedchannelIds : Array
[read-only] The ids of the Channels used by the ChannelSet.
ChannelSet
 Inheritedchannels : Array
Provides access to the Channels in the ChannelSet.
ChannelSet
 Inheritedclustered : Boolean
Indicates whether the ChannelSet targets a clustered destination.
ChannelSet
 Inheritedconnected : Boolean
[read-only] Indicates whether the ChannelSet is connected.
ChannelSet
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritedcurrentChannel : Channel
[read-only] Returns the current Channel for the ChannelSet.
ChannelSet
 InheritedheartbeatInterval : int
The number of milliseconds between heartbeats sent to the remote host while this ChannelSet is actively connected but idle.
ChannelSet
 InheritedinitialDestinationId : String
Provides access to the initial destination this ChannelSet is used to access.
ChannelSet
 InheritedmessageAgents : Array
[read-only] Provides access to the set of MessageAgents that use this ChannelSet.
ChannelSet
  reliableReconnectDuration : int
The duration in milliseconds that channels within the AdvancedChannelSet will attempt to reconnect in a reliable fashion to the remote endpoint they where previous connected to, before advancing to the normal automatic failover and protocol fallback algorithm.
AdvancedChannelSet
Public Methods
 MethodDefined By
  
AdvancedChannelSet(channelIds:Array = null, clusteredWithURLLoadBalancing:Boolean = false)
Constructs an AdvancedChannelSet.
AdvancedChannelSet
 Inherited
Adds a Channel to the ChannelSet.
ChannelSet
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
 Inherited
Handles a CONNECT ChannelEvent and redispatches the event.
ChannelSet
 Inherited
Handles a DISCONNECT ChannelEvent and redispatches the event.
ChannelSet
 Inherited
Handles a ChannelFaultEvent and redispatches the event.
ChannelSet
 Inherited
Connects a MessageAgent to the ChannelSet.
ChannelSet
 Inherited
Disconnects a specific MessageAgent from the ChannelSet.
ChannelSet
 Inherited
Disconnects all associated MessageAgents and disconnects any underlying Channel that is connected.
ChannelSet
 Inherited
Dispatches an event into the event flow.
EventDispatcher
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
login(username:String, password:String, charset:String = null):mx.rpc:AsyncToken
Authenticates the ChannelSet with the server using the provided credentials.
ChannelSet
 Inherited
Logs the ChannelSet out from the server.
ChannelSet
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Removes a Channel from the ChannelSet.
ChannelSet
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
send(agent:MessageAgent, message:IMessage):void
Sends a message from a MessageAgent over the currently connected Channel.
ChannelSet
 Inherited
setCredentials(credentials:String, agent:MessageAgent, charset:String = null):void
Stores the credentials and passes them through to every connected channel.
ChannelSet
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
[override] Returns a String containing the ids of the Channels in the ChannelSet.
ChannelSet
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Protected Methods
 MethodDefined By
 Inherited
Redispatches message events from the currently connected Channel.
ChannelSet
Events
 Event Summary Defined By
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 InheritedDispatched after a Channel in the ChannelSet has connected to its endpoint.ChannelSet
 InheritedDispatched after a Channel in the ChannelSet has disconnected from its endpoint.ChannelSet
 InheritedDispatched after a Channel in the ChannelSet has faulted.ChannelSet
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
 InheritedThe fault event is dispatched when a login or logout call fails.ChannelSet
 InheritedDispatched when a property of the ChannelSet changes.ChannelSet
 InheritedThe result event is dispatched when a login or logout call successfully returns.ChannelSet
Public Constants
 ConstantDefined By
  MAX_REPLY_FETCH_INTERVAL_MILLIS : int = 30000
[static] Constant value for the upper limit for fetch interval.
AdvancedChannelSet
  START : String = "start"
[static] Special header value to instruct a client to start measuring it's rate.
AdvancedChannelSet
  STOP : String = "stop"
[static] Special header value to instruct a client to stop measuring it's rate.
AdvancedChannelSet
Protected Constants
 ConstantDefined By
  ADAPTIVE_FREQUENCY_DESTINATION : String = "_DSAF"
[static] Special value of a destination using adaptive frequency.
AdvancedChannelSet
Property Detail

reliableReconnectDuration

property
public var reliableReconnectDuration:int

The duration in milliseconds that channels within the AdvancedChannelSet will attempt to reconnect in a reliable fashion to the remote endpoint they where previous connected to, before advancing to the normal automatic failover and protocol fallback algorithm. The default value, 0, triggers a single reliable reconnect attempt. Assigned values must be 0 or greater and for any value larger than 0, in the event of a network disconnect, attempts will be made to re-establish the pre-existing reliable connection for the specified time duration in milliseconds.


Throws
RangeError — If a negative value is assigned.
Constructor Detail

AdvancedChannelSet

()Constructor
public function AdvancedChannelSet(channelIds:Array = null, clusteredWithURLLoadBalancing:Boolean = false)

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Constructs an AdvancedChannelSet. If the channelIds argument is provided, the AdvancedChannelSet will use automatically configured Channels obtained via ServerConfig.getChannel() to reach a destination. Attempting to manually assign Channels to an AdvancedChannelSet that uses configured Channels is not allowed.

If the channelIds argument is not provided or is null, Channels must be manually created and added to the AdvancedChannelSet in order to connect and send messages.

If the AdvancedChannelSet is clustered using url-load-balancing (where each server declares a unique RTMP or HTTP URL and the client fails over from one URL to the next), the first time that a Channel in the ChannelSet successfully connects the AdvancedChannelSet will automatically make a request for all of the endpoints across the cluster for all member Channels and will assign these failover URLs to each respective Channel. This allows Channels in the ChannelSet to failover individually, and when failover options for a specific Channel are exhausted the AdvancedChannelSet will advance to the next Channel in the set to attempt to reconnect.

Regardless of clustering, if a Channel cannot connect or looses connectivity, the AdvancedChannelSet will advance to its next available Channel and attempt to reconnect. This allows the AdvancedChannelSet to hunt through Channels that use different protocols, ports, etc., in search of one that can connect to its endpoint successfully.

Parameters
channelIds:Array (default = null) — The ids of configured Channels obtained from ServerConfig for this AdvancedChannelSet to use. If null, Channels must be manually added to the AdvancedChannelSet.
 
clusteredWithURLLoadBalancing:Boolean (default = false) — True if the Channels in the AdvancedChannelSet are clustered using url load balancing.
Constant Detail

ADAPTIVE_FREQUENCY_DESTINATION

Constant
protected static const ADAPTIVE_FREQUENCY_DESTINATION:String = "_DSAF"

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Special value of a destination using adaptive frequency.

MAX_REPLY_FETCH_INTERVAL_MILLIS

Constant 
public static const MAX_REPLY_FETCH_INTERVAL_MILLIS:int = 30000

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Constant value for the upper limit for fetch interval.

START

Constant 
public static const START:String = "start"

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Special header value to instruct a client to start measuring it's rate.

STOP

Constant 
public static const STOP:String = "stop"

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Data Services for Java EE 3
Runtime Versions: Flash Player 9, AIR 1.1

Special header value to instruct a client to stop measuring it's rate.