Diffusion .NET Client Library  6.1.5
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties Events Pages
PushTechnology.ClientInterface.Client.Features.Control.Topics.ITopicUpdateSource Interface Reference

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

Inheritance diagram for PushTechnology.ClientInterface.Client.Features.Control.Topics.ITopicUpdateSource:
PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler PushTechnology.ClientInterface.Client.Features.Control.Topics.TopicUpdateSourceDefault

Public Member Functions

void OnActive (string topicPath, ITopicUpdater updater)
 Notifies 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. More...
 
void OnStandby (string topicPath)
 Notifies that this source is not currently allowed to provide topic updates for the specified topic path. More...
 
- Public Member Functions inherited from PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler
void OnRegistered (string topicPath, IRegistration registration)
 Called when the handler has been successfully registered with the server. More...
 
void OnClose (string topicPath)
 Called if the handler is closed. More...
 
void OnError (string topicPath, ErrorReason errorReason)
 Notification of a contextual error related to this handler. More...
 

Detailed Description

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

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.

When an update source is registered it will be notified via the OnRegistered callback. Once 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.



Since 5.1

Member Function Documentation

void PushTechnology.ClientInterface.Client.Features.Control.Topics.ITopicUpdateSource.OnActive ( string  topicPath,
ITopicUpdater  updater 
)

Notifies 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
topicPathThe registration path.
updaterThe updater that may be used to update topics at or below the registered path. For topics that are based on IDataType{TValue}s it is recommended that ITopicUpdater.ValueUpdater{TValue} is used to obtain an updater specific to certain topic types.

Implemented in PushTechnology.ClientInterface.Client.Features.Control.Topics.TopicUpdateSourceDefault.

void PushTechnology.ClientInterface.Client.Features.Control.Topics.ITopicUpdateSource.OnStandby ( string  topicPath)

Notifies that this source is not currently allowed to provide topic updates for the specified topic path.

This indicates that another update source is currently active for the given topic path.

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

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

Parameters
topicPathThe registration path.

Implemented in PushTechnology.ClientInterface.Client.Features.Control.Topics.TopicUpdateSourceDefault.


The documentation for this interface was generated from the following file: