org.symphonyoss.s2.fugue.pubsub

Interface ISubscriberManager<P,T extends ISubscriberManager<P,T>>

Type Parameters:

P - The type of payload received.

T - Type of concrete manager, needed for fluent methods.

All Superinterfaces:

org.symphonyoss.s2.common.fluent.IFluent<T>

All Known Implementing Classes:

AbstractSubscriberManager

public interface ISubscriberManager<P,T extends ISubscriberManager<P,T>>
extends org.symphonyoss.s2.common.fluent.IFluent<T>

A subscriber manager of payload type P.

Author:

Bruce Skingle

Method Summary

Modifier and Type	Method and Description
T	withSubscription(IThreadSafeRetryableConsumer<P> consumer, String subscriptionName, List<String> topicNames) Subscribe to the given subscription on the given topics.
T	withSubscription(IThreadSafeRetryableConsumer<P> consumer, String subscriptionName, String[] topicNames) Subscribe to the given subscription on the given topics.
T	withSubscription(IThreadSafeRetryableConsumer<P> consumer, String subscriptionName, String topicName, String... additionalTopicNames) Subscribe to the given subscription on the given topics.

Methods inherited from interface org.symphonyoss.s2.common.fluent.IFluent

self

Method Detail

withSubscription

T withSubscription(IThreadSafeRetryableConsumer<P> consumer,
                   String subscriptionName,
                   String topicName,
                   String... additionalTopicNames)

Subscribe to the given subscription on the given topics. This method allows for the creation of the same subscription on one or more topics, the same consumer will receive messages received on the given subscription on any of the topics. The topics are all treated in the same way, the method is declared with topic and additionalTopics to ensure that at least one topic is provided. This method does the same thing as the other withSubscription methods, alternative signatures are provided as a convenience.

Parameters:

consumer - A consumer for received messages.

subscriptionName - A subscription name.

topicName - A topic name.

additionalTopicNames - An optional list of additional topic names.

Returns:

this (fluent method)

withSubscription

T withSubscription(IThreadSafeRetryableConsumer<P> consumer,
                   String subscriptionName,
                   List<String> topicNames)

Subscribe to the given subscription on the given topics. This method allows for the creation of the same subscription on one or more topics, the same consumer will receive messages received on the given subscription on any of the topics. The topics are all treated in the same way, the method is declared with topic and additionalTopics to ensure that at least one topic is provided. This method does the same thing as the other withSubscription methods, alternative signatures are provided as a convenience.

Parameters:

consumer - A consumer for received messages.

subscriptionName - A subscription name.

topicNames - A list of topic names.

Returns:

this (fluent method)

Throws:

IllegalArgumentException - If the list of topics is empty.

withSubscription

T withSubscription(IThreadSafeRetryableConsumer<P> consumer,
                   String subscriptionName,
                   String[] topicNames)

Subscribe to the given subscription on the given topics. This method allows for the creation of the same subscription on one or more topics, the same consumer will receive messages received on the given subscription on any of the topics. The topics are all treated in the same way, the method is declared with topic and additionalTopics to ensure that at least one topic is provided. This method does the same thing as the other withSubscription methods, alternative signatures are provided as a convenience.

Parameters:

consumer - A consumer for received messages.

subscriptionName - A subscription name.

topicNames - A list of topic names.

Returns:

this (fluent method)

Throws:

IllegalArgumentException - If the list of topics is empty.