com.pushtechnology.diffusion.client.features

Class Topics.SubscriberStream.Default

java.lang.Object

com.pushtechnology.diffusion.client.callbacks.Callback.Default

com.pushtechnology.diffusion.client.callbacks.Stream.Default

com.pushtechnology.diffusion.client.features.Topics.SubscriberStream.Default

All Implemented Interfaces:

Callback, Stream, Topics.SubscriberStream

Direct Known Subclasses:

Topics.ValueStream.Default

Enclosing interface:

Topics.SubscriberStream

public abstract static class Topics.SubscriberStream.Default
extends Stream.Default
implements Topics.SubscriberStream

Default Topics.SubscriberStream implementation.

This logs calls to onSubscription and onUnsubscription at 'debug' level. These implementations can be useful during development but are usually overridden to provide meaningful processing.

Nested Class Summary

Nested classes/interfaces inherited from interface com.pushtechnology.diffusion.client.features.Topics.SubscriberStream

Topics.SubscriberStream.Default

Constructor Summary

Constructors

Constructor and Description
Default()

Method Summary

Modifier and Type	Method and Description
void	onSubscription(String topicPath, TopicSpecification specification) Subscription notification.
void	onUnsubscription(String topicPath, TopicSpecification specification, Topics.UnsubscribeReason reason) Unsubscription notification.

Methods inherited from class com.pushtechnology.diffusion.client.callbacks.Stream.Default

onClose

Methods inherited from class com.pushtechnology.diffusion.client.callbacks.Callback.Default

onError

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.pushtechnology.diffusion.client.callbacks.Stream

onClose

Methods inherited from interface com.pushtechnology.diffusion.client.callbacks.Callback

onError

Constructor Detail

Default

public Default()

Method Detail

onSubscription

public void onSubscription(String topicPath,
                           TopicSpecification specification)

Description copied from interface: Topics.SubscriberStream

Subscription notification.

This method is called when a session is subscribed to a topic that matches the stream registration. This method is also called when a stream is added, for all of the session's subscriptions to topics that match the stream registration.

For a given topic, onSubscription will be the initial notification, and the first notification following an unsubscription notification if the session re-subscribes to the topic.

This method is also called for fallback streams that match the topic type when the session removes the last stream that selected a subscribed topic. The fallback stream will now receive updates for the topic, starting with an immediate notification of the currently cached value (if any).

Specified by:

onSubscription in interface Topics.SubscriberStream

Parameters:

topicPath - the topic path

specification - the topic specification

onUnsubscription

public void onUnsubscription(String topicPath,
                             TopicSpecification specification,
                             Topics.UnsubscribeReason reason)

Description copied from interface: Topics.SubscriberStream

Unsubscription notification.

This method is called if the session is unsubscribed from a topic that matches the stream registration. The stream will receive no more updates for the topic unless the session re-subscribes to the topic.

This method is also called for fallback streams that match the topic type if the session adds the first stream that selects a subscribed topic. For these notifications, reason will be Topics.UnsubscribeReason.STREAM_CHANGE. The fallback stream will no longer receive updates for the topic.

Specified by:

onUnsubscription in interface Topics.SubscriberStream

Parameters:

topicPath - the topic path

specification - the topic specification

reason - the reason for unsubscription