Messaging

mojo.Messaging.publish = function( topic, messageObj )

Invokes all listeners subscribed to topic.

Parameters

Example

// subscribe an object's function to a message topic
var test = {dialog: function(msg) {
    if (!msg) msg = "test";
    alert(msg);
}}

var handle = mojo.Messaging.subscribe("someTopic", test, "dialog");

// invoke dialog function by publishing message topic
mojo.Messaging.publish("someTopic");

// invoke dialog function, and pass in a parameter
mojo.Messaging.publish("someTopic", ["hello world"]);

mojo.Messaging.subscribe = function( topic, targetObj, targetFunc )

Attaches a listener to a message topic--Use returned handle to unsubscribe.

Parameters

Returns

{object} handle

Example

// subscribe an object's function to a message topic
var test = {dialog: function(msg) {
    if (!msg) msg = "test";
    alert(msg);
}}

var handle = mojo.Messaging.subscribe("someTopic", test, "dialog");

// invoke dialog function by publishing message topic
mojo.Messaging.publish("someTopic");

// invoke dialog function, and pass in a parameter
mojo.Messaging.publish("someTopic", ["hello world"]);

mojo.Messaging.unsubscribe = function( handle )

Removes a specific subscribed listener from a message topic.

Parameters

Example

// subscribe to a message topic
var handle = mojo.Messaging.subscribe("someTopic", test, "dialog");
// unsubscribe from message topic
mojo.Messaging.unsubscribe(handle);

mojo.Messaging.getTopic = function( topic )

Retrieves the MessagingTopic object associated with the message topic--If topic doesn’t exist, this function will generate one.

Paramters

Returns

{object} Topic

Example

// stand-alone usage
var topicObj = mojo.Messaging.getTopic(“someTopic”);

// usage in a Mojo Controller
this.addObserver(mojo.Messaging.getTopic(“someTopic”), “onPublish”, “SomeCommand”);