blob: 2bda525028ad410191be044a0f6463878490c230 [file] [log] [blame]
{ "type": "class",
"qname": "mx.messaging.messages.MessagePerformanceUtils",
"baseClassname": ""
,
"description": "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: &lt;record-message-times&gt; denotes capturing of timing information, &lt;record-message-sizes&gt; denotes capturing of sizing information. <p>You can then use methods of this utility class to retrieve various performance information about the message that you have just received.</p> <p>When these metrics are enabled an instance of this class should be created from a response, acknowledgement, or message handler using code such as below: </p> <pre>\\n var mpiutil:MessagePerformanceUtils = new MessagePerformanceUtils(event.message);\\n </pre>",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "langversion",
"values": ["3.0"]},
{ "tagName": "royalesuppresspublicvarwarning",
"values": []} ],
"members": [
{ "type": "method",
"qname": "mx.messaging.messages.MessagePerformanceUtils",
"namespace": "",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Constructor Creates an MPUtils instance with information from the MPI headers of the passed in message MPI information",
"tags": [
{ "tagName": "param",
"values": ["message The message whose MPI headers will be used in retrieving"]},
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"return": "void",
"params": [{ "name": "message", "type": "Object"}]}
,
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "totalTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Time between this client sending a message and receiving a response for it from the server",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Total time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverProcessingTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Server processing time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverPrePushTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Server pre-push processing time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverAdapterTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Server adapter processing time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverAdapterExternalTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Server adapter-external processing time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverPollDelay",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverNonAdapterTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Server processing time spent outside of the adapter associated with the destination of this message.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "networkRTT",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Network round trip time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "serverSendTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Timestamp in milliseconds since epoch of when the server sent a response message back to the client.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Timestamp in milliseconds since epoch"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "clientReceiveTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Timestamp in milliseconds since epoch of when the client received response message from the server.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Timestamp in milliseconds since epoch"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "int",
"qname": "messageSize",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The size of the original client message as measured during deserialization by the server endpoint.",
"tags": [
{ "tagName": "return",
"values": ["Message size in Bytes"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "int",
"qname": "responseMessageSize",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The size of the response message sent to the client by the server as measured during serialization at the server endpoint.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Message size in Bytes"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Boolean",
"qname": "pushedMessageFlag",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Returns true if message was pushed to the client and is not a response to a message that originated on the client. originated on the client",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["true if this message was pushed to the client and is not a response to a message that"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "totalPushTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Total push time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "pushOneWayTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["One way server push time in milliseconds"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "originatingMessageSentTime",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "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.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Timestamp in milliseconds since epoch"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-only",
"return": "Number",
"qname": "originatingMessageSize",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Only populated in the case of a pushed message, size in Bytes of the message that originally caused this pushed message.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["Pushed causer message size in Bytes"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "method",
"qname": "prettyPrint",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Returns a summary of all information available in MPI. For example: <pre>\\n var mpiutil:MessagePerformanceUtils = new MessagePerformanceUtils(message);\\n Alert.show(mpiutil.prettyPrint(), &quot;MPI Output&quot;, Alert.NONMODAL);\\n </pre>",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 9", "AIR 1.1"]},
{ "tagName": "productversion",
"values": ["BlazeDS 4", "LCDS 3"]},
{ "tagName": "return",
"values": ["String containing a summary of all information available in MPI"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"return": "String",
"params": []}
]
}