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

The stream that will be called when a session subscribes or fetches using a topic selector that matches no topics. More...

Inheritance diagram for PushTechnology.ClientInterface.Client.Features.Control.Topics.IMissingTopicNotificationStream:
PushTechnology.ClientInterface.Client.Callbacks.IStream PushTechnology.ClientInterface.Client.Callbacks.ICallback PushTechnology.ClientInterface.Client.Features.Control.Topics.MissingTopicNotificationStreamDefault

Public Member Functions

void OnMissingTopic (IMissingTopicNotification notification)
 Called when a session requests a topic that does not exist, and the topic path belongs to part of the topic tree for which this stream was registered. More...
 
- Public Member Functions inherited from PushTechnology.ClientInterface.Client.Callbacks.IStream
void OnClose ()
 Notification that a stream context was closed normally. More...
 
- Public Member Functions inherited from PushTechnology.ClientInterface.Client.Callbacks.ICallback
void OnError (ErrorReason errorReason)
 Notification of a contextual error related to this callback. More...
 

Detailed Description

The stream that will be called when a session subscribes or fetches using a topic selector that matches no topics.

Stream instances can be registered using ITopicControl.AddMissingTopicHandlerAsync(string,IMissingTopicNotificationStream).

Since 6.0

Member Function Documentation

void PushTechnology.ClientInterface.Client.Features.Control.Topics.IMissingTopicNotificationStream.OnMissingTopic ( IMissingTopicNotification  notification)

Called when a session requests a topic that does not exist, and the topic path belongs to part of the topic tree for which this stream was registered.

The implementation should take the appropriate action (for example, create the topic), and then call IMissingTopicNotification.Proceed() on the given notification . This allows the session request to continue and successfully resolve against the topic if it was created.

Alternatively, the stream can call IMissingTopicNotification.Cancel() to discard the request. A stream should always call IMissingTopicNotification.Proceed() or IMissingTopicNotification.Cancel(), otherwise resources will continue to be reserved on the server and the session's request will not complete.

Parameters
notificationThe missing topic notification.

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


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