<PTDiffusionTopicUpdateSource> Protocol Reference

Introduction

A source of updates which may be registered in order to update parts of the topic tree.

Classes wishing to peform the role of an update source must conform to this protocol.

Registering as an update source for a particular point in the topic tree allows a client to update all topics below that point in the tree. There is no need to subscribe to a topic in order to update it.

Once an update source is registered it may be in either a active state, where it can provide topic updates, or a standby state, where it is still registered but is not allowed to perform updates. An update source may switch between these states in any order, depending on server policy.

See Also

PTDiffusionTopicUpdateControlFeature

Since

5.7

Inheritance diagram for <PTDiffusionTopicUpdateSource>:

Instance Methods
(void)	- diffusionTopicTreeRegistration:isActiveWithUpdater:
(void)	- diffusionTopicTreeRegistrationIsOnStandbyForUpdates:
Instance Methods inherited from <PTDiffusionTopicTreeRegistrationDelegate>
(void)	- diffusionTopicTreeRegistrationDidClose:
(void)	- diffusionTopicTreeRegistration:didFailWithError:

Method Documentation

- (void) diffusionTopicTreeRegistration:		(PTDiffusionTopicTreeRegistration *)	registration
isActiveWithUpdater:		(PTDiffusionTopicUpdater *)	updater

State notification that this source is now active for the specified topic path, and is therefore in a valid state to send updates on topics at or below the registered topic path.

Parameters

registration	The topic tree registration for which this updater applies.
updater	An updater that may be used to update topics at or below the registered topic path.

Since

5.7

- (void) diffusionTopicTreeRegistrationIsOnStandbyForUpdates:

(PTDiffusionTopicTreeRegistration *)

registration

Notification that this source is not currently allowed to provide topic updates for the specified topic path. This indicates that another UpdateSource is currently active for the given topic path.

Server policy will dictate when this UpdateSource is set to be active.

If this UpdateSource was previously in an active state, any updater instances for this topic path will no longer be valid for use.

Parameters

registration

The topic tree registration for which this updater applies.

Since

5.7