org.symphonyoss.s2.fugue.pubsub

Class AbstractSubscriberManager<P,T extends ISubscriberManager<P,T>>

java.lang.Object

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

org.symphonyoss.s2.fugue.FugueLifecycleComponent<T>

org.symphonyoss.s2.fugue.pubsub.AbstractSubscriberManager<P,T>

Type Parameters:

P - Type of payload received.

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

All Implemented Interfaces:

org.symphonyoss.s2.common.fluent.IFluent<T>, IFugueComponent, IFugueLifecycleComponent, ISubscriberManager<P,T>

public abstract class AbstractSubscriberManager<P,T extends ISubscriberManager<P,T>>
extends FugueLifecycleComponent<T>
implements ISubscriberManager<P,T>

Base class for subscriber managers.

Author:

Bruce Skingle

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	FAILED_CONSUMER_RETRY_TIME
protected static long	FAILED_DEAD_LETTER_RETRY_TIME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSubscriberManager(Class<T> type, ITraceContextFactory traceFactory, IThreadSafeErrorConsumer<P> unprocessableMessageConsumer)

Method Summary

Modifier and Type	Method and Description
protected void	assertConfigurable()
protected List<Subscription<P>>	getSubscribers()
protected ITraceContextFactory	getTraceFactory()
long	handleMessage(IThreadSafeRetryableConsumer<P> consumer, P payload, ITraceContext trace) Handle the given message.
protected void	setLifeCycleState(FugueLifecycleState arg0)
void	start()
protected abstract void	startSubscription(Subscription<P> subscription)
void	stop()
protected abstract void	stopSubscriptions() Stop all subscribers.
T	withSubscription(String topicName, String subscriptionName, IThreadSafeRetryableConsumer<P> consumer) Add the given subscription.
T	withSubscriptionsByConfig(List<String> topicNames, String subscriptionName, IThreadSafeRetryableConsumer<P> consumer) Subscribe to the given subscription on the given topic.

Methods inherited from class org.symphonyoss.s2.common.fluent.Fluent

self

Methods inherited from class java.lang.Object

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

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

self

Methods inherited from interface org.symphonyoss.s2.fugue.IFugueComponent

getComponentId, getComponentState, getComponentStatusMessage

Field Detail

FAILED_DEAD_LETTER_RETRY_TIME

protected static final long FAILED_DEAD_LETTER_RETRY_TIME

FAILED_CONSUMER_RETRY_TIME

protected static final long FAILED_CONSUMER_RETRY_TIME

Constructor Detail

AbstractSubscriberManager

protected AbstractSubscriberManager(Class<T> type,
                                    ITraceContextFactory traceFactory,
                                    IThreadSafeErrorConsumer<P> unprocessableMessageConsumer)

Method Detail

withSubscription

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

Description copied from interface: ISubscriberManager

Add the given subscription.

Specified by:

withSubscription in interface ISubscriberManager<P,T extends ISubscriberManager<P,T>>

Parameters:

topicName - A topic name

subscriptionName - A subscription name

consumer - The consumer for received messages.

Returns:

this (fluent method)

withSubscriptionsByConfig

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

Description copied from interface: ISubscriberManager

Subscribe to the given subscription on the given topic.

Specified by:

withSubscriptionsByConfig in interface ISubscriberManager<P,T extends ISubscriberManager<P,T>>

Parameters:

topicNames - A list of topic names.

subscriptionName - A subscription name.

consumer - A consumer for received messages.

Returns:

this (fluent method)

startSubscription

protected abstract void startSubscription(Subscription<P> subscription)

stopSubscriptions

protected abstract void stopSubscriptions()

Stop all subscribers.

getTraceFactory

protected ITraceContextFactory getTraceFactory()

getSubscribers

protected List<Subscription<P>> getSubscribers()

start

public void start()

Specified by:

start in interface IFugueComponent

stop

public void stop()

Specified by:

stop in interface IFugueComponent

handleMessage

public long handleMessage(IThreadSafeRetryableConsumer<P> consumer,
                          P payload,
                          ITraceContext trace)

Handle the given message.

Parameters:

consumer - The consumer for the message.

payload - A received message.

trace - A trace context.

Returns:

The number of milliseconds after which a retry should be made, or -1 if the message was processed and no retry is necessary.

assertConfigurable

protected void assertConfigurable()

setLifeCycleState

protected void setLifeCycleState(FugueLifecycleState arg0)