org.symphonyoss.s2.fugue.pubsub

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

Type Parameters:

P - The type of payload received.

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

B - Type of concrete manager (built object), needed for fluent methods.

All Superinterfaces:

org.symphonyoss.s2.common.fluent.IBuilder<T,B>, org.symphonyoss.s2.common.fluent.IFluent<T>

All Known Subinterfaces:

IPullSubscriberManagerBuilder<P,T,B>

All Known Implementing Classes:

AbstractPullSubscriberManager.Builder, AbstractSubscriberManager.Builder

public interface ISubscriberManagerBuilder<P,T extends ISubscriberManagerBuilder<P,T,B>,B extends ISubscriberManager<P,B>>
extends org.symphonyoss.s2.common.fluent.IBuilder<T,B>

A builder for a subscriber manager of payload type P.

Author:

Bruce Skingle

Method Summary

Modifier and Type	Method and Description
T	withConfig(IConfiguration config)
T	withCounter(ICounter counter)
T	withNameFactory(INameFactory nameFactory)
T	withSubscription(IThreadSafeRetryableConsumer<P> consumer, String subscriptionName, Collection<TopicName> 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.
T	withSubscription(IThreadSafeRetryableConsumer<P> consumer, Subscription subscription)
T	withTraceContextTransactionFactory(ITraceContextTransactionFactory traceFactory)
T	withUnprocessableMessageConsumer(IThreadSafeErrorConsumer<P> unprocessableMessageConsumer)

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

build

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

self

Method Detail

withNameFactory

T withNameFactory(INameFactory nameFactory)

withSubscription

T withSubscription(IThreadSafeRetryableConsumer<P> consumer,
                   Subscription subscription)

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,
                   Collection<TopicName> 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.

withConfig

T withConfig(IConfiguration config)

withCounter

T withCounter(ICounter counter)

withTraceContextTransactionFactory

T withTraceContextTransactionFactory(ITraceContextTransactionFactory traceFactory)

withUnprocessableMessageConsumer

T withUnprocessableMessageConsumer(IThreadSafeErrorConsumer<P> unprocessableMessageConsumer)