PostCenter

Kind of class: public class
Package:
Inherits from:
  • EventDispatcher
Classpath: org.asaplibrary.util.postcenter.PostCenter
File last modified: Wednesday, 11 May 2011, 19:03:38
Send navigateToURL requests safely on all browsers. Windows Internet Explorer cannot handle navigateToURL messages that are sent out quickly in succession; PostCenter functions as intermediary and queues and batches requests where possible. If you need to sent requests from multiple places in your application it becomes a difficult task to manage the timings of these requests. It is safer to let PostCenter deal with this. Note that it is still recommended to use ExternalInterface for Flash to Javascript communication. For example, you may safely send out Javascript calls in succession (even on IE 6): 
ExternalInterface.call("updateContent", 1);
ExternalInterface.call("updateContent", 2);
ExternalInterface.call("updateContent", 3);
Events broadcasted to listeners
Usage note
  • Be careful with using multiple PostCenter objects: timings are not synchronized and postings to the browser may conflict with each other. Use PostCenter.defaultPostCenter unless you know what you are doing!
Usage
  • Sending out a URLRequest This is an example from Flash Help, extended to be sent out with PostCenter: 
    // compose the request:
var url:String = "http://www.adobe.com";
var variables:URLVariables = new URLVariables();
variables.exampleSessionId = new Date().getTime();
variables.exampleUserLabel = "Your Name";
var request:URLRequest = new URLRequest(url);
request.data = variables;
// send out the request:
PostCenter.defaultPostCenter.sendRequest(request); // no window specified: will be sent to the current window
    Sending out a message string Multiple calls to the same window are concatenated and sent as one URLRequest. We will use a Javascript call as example, though you preferable should use ExternalInterface for this purpose. 
    var message:String;
var pc:PostCenter = PostCenter.defaultPostCenter;
message = "Javascript:sendStatsOne(" + contentId + ")";
pc.sendMessage(message);
message = "Javascript:sendStatsTwo(" + contentId + ")";
pc.sendMessage(message);

Summary

Class properties
Instance methods
  • sendURLRequest (inRequest:URLRequest, inWindow:String = "_self") : void
    • Adds a URLRequest to the send queue.
  • sendMessage (inMessage:String, inWindow:String = "_self") : void
    • Adds a message to the send queue.

Class properties

defaultPostCenter

static defaultPostCenter:PostCenter(read)
Returns
  • The default global instance of the PostCenter.

Instance methods

sendMessage

function sendMessage(inMessage:String, inWindow:String = "_self") : void

Adds a message to the send queue. Multiple messages to the same window get concatenated into 1 URLRequest. Get notified by the send progress by subscribing to PostCenterEvent._EVENT. Messages are sent out with a GET send method.

Parameters
inMessage:text to be sent
inWindow :the window name; see PostCenter.sendURLRequest

sendURLRequest

function sendURLRequest(inRequest:URLRequest, inWindow:String = "_self") : void

Adds a URLRequest to the send queue. Each request will be sent after SEND_DELAY milliseconds. Get notified by the send progress by subscribing to PostCenterEvent._EVENT. Specify in the URLRequest if the send method should be GET or POST.

Parameters
inRequest:the URLRequest to send
inWindow :(optional) name of the window to send message to: either the name of a specific window, or one of the following values: "_self" (the current frame in the current window), "_blank" (a new window), "_parent" (the parent of the current frame), "_top" (the top-level frame in the current window); default "_self"