dojo.subscribe ¶

since:	0.9

Contents

dojo.subscribe
- Introduction
- Usage

Linked a listener to a named topic.

Introduction ¶

Subscribe is a part of the Dojo Topic system used to register a function listening to a named channel. The channel is sent data via dojo.publish.

Usage ¶

To subscribe a function to a channel:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.subscribe("/foo/bar/baz", function(data){
    console.log("i got", data);
  });
});
// Dojo < 1.7
dojo.subscribe("/foo/bar/baz", function(data){
   console.log("i got", data);
});

To trigger that function, publish some data on the same channel:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.publish("/foo/bar/baz", [{ some:"object data" }]);
});
// Dojo < 1.7
dojo.publish("/foo/bar/baz", [{ some:"object data" }]);

The channel name can be any string you choose:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.subscribe("foo-bar", function(data){ /*handle*/ });
  connect.subscribe("bar", function(data){ /*handle*/ });
  connect.subscribe("/foo/bar", function(data){ /*handle*/ });
});
// Dojo < 1.7
dojo.subscribe("foo-bar", function(data){ /*handle*/ });
dojo.subscribe("bar", function(data){ /*handle*/ });
dojo.subscribe("/foo/bar", function(data){ /*handle*/ });

Each are unique channels.

Globbing¶

Dojo Topics do not support globbing, or mixing of channel names based on wildcards. This example is invalid:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.subscribe("/foo/*", function(data){ /*handle*/ });
});
// Dojo < 1.7
dojo.subscribe("/foo/*", function(data){ /*handle*/ });

While this works when using cometd‘s dojox.cometd.subscribe function, it is not practical to do on the client side. Only fully named channels are supported.

Subscribing with scope¶

Subscribe uses dojo.hitch under the covers to provide more advanced functionality for controlling in which context the attached function will be called.

Consider the following object:

var obj = {
   member:"unpublished",
   anon: function(data){
       this.member = "fixed";
   }
}

To execute an anonymous function in the scope of obj:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.subscribe("/foo/bar", obj, function(data){
    // here 'this' refers to the obj instance
    this.member = "published";
  });
});
// Dojo < 1.7
dojo.subscribe("/foo/bar", obj, function(data){
    // here 'this' refers to the obj instance
    this.member = "published";
});

Alternately, you can pass a named function instead of an anonymous function with scope:

// Dojo 1.7 (AMD)
require(["dojo/_base/connect"], function(connect){
  connect.subscribe("/foo/bar", obj, "anon");
});
// Dojo < 1.7
dojo.subscribe("/foo/bar", obj, "anon");

This will execute obj.anon() in the scope of obj, passing in whatever data the accompanying dojo.publish call sent.

dojo.subscribe
- Introduction
- Usage
  - Globbing
  - Subscribing with scope

dojo.subscribe¶

Introduction¶

Usage¶

Globbing¶

Subscribing with scope¶

Table of Contents

dojo.subscribe ¶

Introduction ¶

Usage ¶