Interface IMissingTopicHandler
The handler that will be called when a session subscribes or fetches using a topic selector that matches no topics.
Inherited Members
Namespace: PushTechnology.ClientInterface.Client.Features.Control.Topics
Assembly: Diffusion.Client.dll
Syntax
public interface IMissingTopicHandler : ITopicTreeHandler
Remarks
Handler instances can be registered using AddMissingTopicHandler(String, IMissingTopicHandler).
Methods
OnMissingTopic(IMissingTopicNotification)
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 handler was registered.
Declaration
void OnMissingTopic(IMissingTopicNotification notification)
Parameters
Type | Name | Description |
---|---|---|
IMissingTopicNotification | notification | The missing topic notification. |
Remarks
The implementation should take the appropriate action (for example, create the topic), and then call
Proceed() on the given notification
. This allows
the session request to continue and successfully resolve against the topic if it was created.
Alternatively, the handler can call Cancel() to discard the request. A handler should always call Proceed() or Cancel(), otherwise resources will continue to be reserved on the server and the session's request will not complete.