Add comments to some of the code I touched/created.
This commit is contained in:
parent
948de2bdbe
commit
fcd612e486
@ -3,6 +3,9 @@
|
||||
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* A wrapper for data to facilitate adding functionality to messages.
|
||||
*/
|
||||
function Message(data) {
|
||||
this.data = data;
|
||||
this.allowsReply = false;
|
||||
@ -10,6 +13,9 @@ function Message(data) {
|
||||
this.id;
|
||||
}
|
||||
Message.prototype = {
|
||||
/**
|
||||
* Reply to the action handler that sent the message.
|
||||
*/
|
||||
reply: function messageReply(data) {
|
||||
if (!this.allowsReply)
|
||||
error('This message does not accept replies.');
|
||||
@ -20,6 +26,11 @@ Message.prototype = {
|
||||
data: data
|
||||
});
|
||||
},
|
||||
/**
|
||||
* Setup the message to allow a reply.
|
||||
* @param {function} messager A function that takes a JSON reply.
|
||||
* @param {String} id The id to identify this message.
|
||||
*/
|
||||
setupReply: function setupReply(messager, id) {
|
||||
this.allowsReply = true;
|
||||
this.messager = messager;
|
||||
@ -73,7 +84,12 @@ MessageHandler.prototype = {
|
||||
}
|
||||
ah[actionName] = [handler, scope];
|
||||
},
|
||||
|
||||
/**
|
||||
* Sends a message to the comObj to invoke the action with the supplied data.
|
||||
* @param {String} actionName Action to call.
|
||||
* @param {JSON} data JSON data to send.
|
||||
* @param {function} [callback] Optional callback that will handle a reply.
|
||||
*/
|
||||
send: function messageHandlerSend(actionName, data, callback) {
|
||||
var message = {
|
||||
action: actionName,
|
||||
|
Loading…
x
Reference in New Issue
Block a user