PTDiffusionMissingTopicNotification Class Reference

Introduction

Notification that a session has made a request using a selector that does not match any topics.

Processing of the initial request will be halted until proceed is called, at which point the selector will be resolved against the topic tree again.

If after calling proceed the selector still does not match against any topics, no further notifications will be provided.

Should cancel be called, or the notification time out, the request will be discarded. The requesting session will not be notified that their request has been cancelled.

See Also

PTDiffusionMissingTopicHandler

Since

5.7

Inheritance diagram for PTDiffusionMissingTopicNotification:

Properties
PTDiffusionSessionId *	sessionId
NSString *	topicSelectorExpression

Instance Methods
(void)	- cancel
(void)	- proceed

Method Documentation

- (void) cancel

Cancel the client request on the server.

Calling this will prevent any further processing of the request. For subscription requests, the topic selector will be discarded. The client session will not become subscribed to topics that match the selector if they are added later.

Deprecated:

Since 6.4. In the future (when the legacy fetch mechanism is removed) the behavior when a subscription selector matches with no topics will be to add the selector to the session's topic selections regardless of whether this is called, and this method will become a no-op and will eventually be removed.

Since

5.7

- (void) proceed

Instruct the server to complete processing of the session request.

This may be called after additional operations (such as adding topics) have been performed, to allow the requested selector to be resolved against the updated topic tree.

For subscription requests, the topic selector will be added to the client's topic selections. This will cause the client session to become subscribed to topics that match the selector if they are added later.

Since

5.7

Property Documentation

- (PTDiffusionSessionId*) sessionId

readnonatomicassign

The identity of the client session that made the request.

Since

5.7

- (NSString*) topicSelectorExpression

readnonatomicassign

The topic selector expression that triggered this notification.

Since

5.7