Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The MessagePerformanceUtils utility class is used to retrieve various metrics about
the sizing and timing of a message sent from a client to the server and its
response message, as well as pushed messages from the server to the client.
Metrics are gathered when corresponding properties on the channel used are enabled:
<record-message-times> denotes capturing of timing information,
<record-message-sizes> denotes capturing of sizing information.
You can then use methods of this utility class to retrieve various performance information
about the message that you have just received.
When these metrics are enabled an instance of this class should be created from
a response, acknowledgement, or message handler via something like:
clientReceiveTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Timestamp in milliseconds since epoch of when the client received response message from
the server
Implementation public function get clientReceiveTime():Number
messageSize:int
[read-only]
The size of the original client message as measured during deserialization by the server
endpoint
Implementation public function get messageSize():int
networkRTT:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The network round trip time for a client message and the server response to it,
calculated by the difference between total time and server processing time
Implementation public function get networkRTT():Number
originatingMessageSentTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Only populated in the case of a pushed message, timestamp in milliseconds since epoch of
when the client that caused a push message sent its message.
Implementation public function get originatingMessageSentTime():Number
originatingMessageSize:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Only populated in the case of a pushed message, size in Bytes of the message that originally
caused this pushed message
Implementation public function get originatingMessageSize():Number
pushedMessageFlag:Boolean
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns true if message was pushed to the client and is not a response to a message that
originated on the client
Implementation public function get pushedMessageFlag():Boolean
pushOneWayTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Only populated in the case of a pushed message, this is the network time between
the server pushing the message and the client receiving it. Note that the server
and client clocks must be in sync for this to be meaningful.
Implementation public function get pushOneWayTime():Number
responseMessageSize:int
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The size of the response message sent to the client by the server as measured during serialization
at the server endpoint
Implementation public function get responseMessageSize():int
serverAdapterExternalTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time spent in a module invoked from the adapter associated with the destination for this message
but external to it, before either the response to the message was ready or the message had been
prepared to be pushed to the receiving client.
Implementation public function get serverAdapterExternalTime():Number
serverAdapterTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time spent in the adapter associated with the destination for this message before
either the response to the message was ready or the message had been prepared
to be pushed to the receiving client.
Implementation public function get serverAdapterTime():Number
serverNonAdapterTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Server processing time spent outside of the adapter associated with the destination of this message
Implementation public function get serverNonAdapterTime():Number
serverPollDelay:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time that the message waited on the server after it was ready to be pushed to the client
but had not yet been polled for.
Implementation public function get serverPollDelay():Number
serverPrePushTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time between server receiving the client message and the server beginning to push
messages out to other clients as a result of the original message.
Implementation public function get serverPrePushTime():Number
serverProcessingTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time between server receiving the client message and either the time
the server responded to the received message or had the pushed message ready
to be sent to the receiving client.
Implementation public function get serverProcessingTime():Number
serverSendTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Timestamp in milliseconds since epoch of when the server sent a response message back
to the client
Implementation public function get serverSendTime():Number
totalPushTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Only populated in the case of a pushed message, this is the time between the push causing client
sending its message and the push receving client receiving it. Note that the two clients'
clocks must be in sync for this to be meaningful.
Implementation public function get totalPushTime():Number
totalTime:Number
[read-only]
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Time between this client sending a message and receiving a response
for it from the server
Implementation public function get totalTime():Number
public function MessagePerformanceUtils(message:Object)
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Constructor
Creates an MPUtils instance with information from the MPI headers
of the passed in message
Parameters | message:Object — The message whose MPI headers will be used in retrieving
MPI information
|
public function prettyPrint():String
Language Version: | ActionScript 3.0 |
Product Versions: | BlazeDS 4, LiveCycle Data Services 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Method returns a summary of all information available in MPI. A suggested use of this
is something like,
Returns | String — String containing a summary of all information available in MPI
|
Example (
How to use this example )
var mpiutil:MessagePerformanceUtils = new MessagePerformanceUtils(message);
Alert.show(mpiutil.prettyPrint(), "MPI Output", Alert.NONMODAL);