com.pushtechnology.diffusion.client.features.control.topics

Interface TopicControl.MissingTopicNotification

Enclosing interface:

TopicControl

public static interface TopicControl.MissingTopicNotification

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

Method Summary

Modifier and Type	Method and Description
void	cancel() Deprecated. since 6.6 This method is a no-op. In previous releases this would prevent the selector from being added to the session's selections. Since 6.6 the selector is always added to the session's selections before this notification is issued regardless.
List<String>	getServerNames() Returns a list of the names of the servers through which the notification has been routed.
default SessionId	getSessionId() Returns the identity of the session that made the request.
Map<String,String>	getSessionProperties() Returns the session properties of the session that made the request.
default String	getTopicPath() Returns the topic path derived from the requested topic selector.
TopicSelector	getTopicSelector() Returns the TopicSelector that triggered this notification.
void	proceed() Deprecated. since 6.6 This method is a no-op. In previous releases this would cause the selector to be added to the session's selections and the selection to be re-evaluated. Since 6.6 the selector is always added to the session's selections before this notification is issued.

Method Detail

getSessionProperties

Map<String,String> getSessionProperties()

Returns the session properties of the session that made the request.

Returns:

the session properties

Since:

6.7

getSessionId

default SessionId getSessionId()

Returns the identity of the session that made the request.

This method is equivalent to calling sessionIdFromString(getSessionProperties().get(Session.SESSION_ID).

Returns:

the session identifier

getTopicPath

default String getTopicPath()

Returns the topic path derived from the requested topic selector. This method is equivalent to calling getTopicSelector().getPathPrefix().

Returns:

the topic path

getTopicSelector

TopicSelector getTopicSelector()

Returns the TopicSelector that triggered this notification.

Returns:

the topic selector

Since:

5.1

getServerNames

List<String> getServerNames()

Returns a list of the names of the servers through which the notification has been routed.

The first name in the list will be the name of the server to which the originating session was connected. If the notification was routed through remote server connections before reaching the recipient then those servers will also be listed in the order that the notification passed through them.

Returns:

list of server names, the first being the one which the originating session was connected to

Since:

6.7

proceed

@Deprecated
void proceed()

Deprecated. since 6.6

This method is a no-op. In previous releases this would cause the selector to be added to the session's selections and the selection to be re-evaluated. Since 6.6 the selector is always added to the session's selections before this notification is issued.

This method has no effect.

cancel

@Deprecated
void cancel()

Deprecated. since 6.6

This method is a no-op. In previous releases this would prevent the selector from being added to the session's selections. Since 6.6 the selector is always added to the session's selections before this notification is issued regardless.

This method has no effect.

Since:

5.1