goog.pubsub.PubSub

Invokes a callback function when this object is disposed. Callbacks are invoked in the order in which they were added. If a callback is added to an already disposed Disposable, it will be called immediately.

Clears the subscription list for a topic, or all topics if unspecified.

Disposes of the object and its resources.

Performs appropriate cleanup. See description of goog.disposable.IDisposable for examples. Classes that extend goog.Disposable should override this method. Not reentrant. To avoid calling it twice, it must only be called from the subclass' disposeInternal method. Everywhere else the public dispose method must be used. For example:

 mypackage.MyClass = function() {
 mypackage.MyClass.base(this, 'constructor');
     // Constructor logic specific to MyClass.
     ...
   };
   goog.inherits(mypackage.MyClass, goog.Disposable);

   mypackage.MyClass.prototype.disposeInternal = function() {
     // Dispose logic specific to MyClass.
     ...
     // Call superclass's disposeInternal at the end of the subclass's, like
     // in C++, to avoid hard-to-catch issues.
     mypackage.MyClass.base(this, 'disposeInternal');
   };
 

Returns the number of subscriptions to the given topic (or all topics if unspecified). This number will not change while publishing any messages.

Publishes a message to a topic. Calls functions subscribed to the topic in the order in which they were added, passing all arguments along.

If this object was created with async=true, subscribed functions are called via goog.async.run(). Otherwise, the functions are called directly, and if any of them throw an uncaught error, publishing is aborted.

Associates a disposable object with this object so that they will be disposed together.

Subscribes a function to a topic. The function is invoked as a method on the given opt_context object, or in the global scope if no context is specified. Subscribing the same function to the same topic multiple times will result in multiple function invocations while publishing. Returns a subscription key that can be used to unsubscribe the function from the topic via #unsubscribeByKey.

Subscribes a single-use function to a topic. The function is invoked as a method on the given opt_context object, or in the global scope if no context is specified, and is then unsubscribed. Returns a subscription key that can be used to unsubscribe the function from the topic via #unsubscribeByKey.

Unsubscribes a function from a topic. Only deletes the first match found. Returns a Boolean indicating whether a subscription was removed.

Removes a subscription based on the key returned by #subscribe. No-op if no matching subscription is found. Returns a Boolean indicating whether a subscription was removed.

If monitoring the goog.Disposable instances is enabled, stores the creation stack trace of the Disposable instance.