org.symphonyoss.s2.fugue.pubsub

Class AbstractSubscriberManager<T extends AbstractSubscriberManager<T>>

java.lang.Object

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

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

All Implemented Interfaces:

IFugueComponent, IFugueLifecycleComponent

public abstract class AbstractSubscriberManager<T extends AbstractSubscriberManager<T>>
extends FugueLifecycleComponent<T>

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

Constructor and Description
AbstractSubscriberManager(Class<T> type, INamingStrategy namingStrategy, ITraceContextFactory traceFactory, IThreadSafeRetryableConsumer<Reader> consumer, IThreadSafeConsumer<Reader> unprocessableMessageConsumer)

Method Summary

Modifier and Type	Method and Description
protected void	assertConfigurable()
protected ITraceContextFactory	getTraceFactory()
protected T	getTypedThis()
long	handleMessage(Reader item, ITraceContext trace) Handle the given message.
protected void	setLifeCycleState(FugueLifecycleState arg0)
void	start()
protected abstract void	startSubscriptions(Map<String,Set<String>> subscriptionsByTopic, Map<String,Set<String>> topicsBySubscription) Start with the given subscriptions.
void	stop()
protected abstract void	stopSubscriptions() Stop all subscribers.
protected void	transitionTo(FugueLifecycleState arg0)
T	withSubscription(String topicName, String subscriptionName) Subscribe to the given subscription on the given topic.

Methods inherited from class java.lang.Object

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

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

public AbstractSubscriberManager(Class<T> type,
                                 INamingStrategy namingStrategy,
                                 ITraceContextFactory traceFactory,
                                 IThreadSafeRetryableConsumer<Reader> consumer,
                                 IThreadSafeConsumer<Reader> unprocessableMessageConsumer)

Method Detail

withSubscription

public T withSubscription(String topicName,
                          String subscriptionName)

Subscribe to the given subscription on the given topic.

Parameters:

topicName - The name of the topic to subscribe to.

subscriptionName - The name of the subscription to subscribe to.

Returns:

this (fluent method)

Throws:

IllegalArgumentException - If a duplicate request is made.

startSubscriptions

protected abstract void startSubscriptions(Map<String,Set<String>> subscriptionsByTopic,
                                           Map<String,Set<String>> topicsBySubscription)

Start with the given subscriptions. We guarantee not to provide the same topic/subscription name more than once, it would be an error to do so and we throw IllegalArgumentException to our caller if they request a duplicate. We provide the same set of information indexed both ways as a convenience, the implementor should process one or the other but not both.

Parameters:

subscriptionsByTopic - A map of topic names, each entry is a set of subscription names.

topicsBySubscription - A map of subscription names, each entry is a set of topic names.

stopSubscriptions

protected abstract void stopSubscriptions()

Stop all subscribers.

getTraceFactory

protected ITraceContextFactory getTraceFactory()

start

public final void start()

stop

public final void stop()

handleMessage

public long handleMessage(Reader item,
                          ITraceContext trace)

Handle the given message.

Parameters:

item - A received message as a (possibly read-only) Reader.

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.

getTypedThis

protected T getTypedThis()

assertConfigurable

protected void assertConfigurable()

transitionTo

protected void transitionTo(FugueLifecycleState arg0)

setLifeCycleState

protected void setLifeCycleState(FugueLifecycleState arg0)