de.caluga.morphium.messaging

Class Messaging

java.lang.Object

java.lang.Thread

de.caluga.morphium.messaging.Messaging

All Implemented Interfaces:

ShutdownListener, Runnable

public class Messaging
extends Thread
implements ShutdownListener

User: Stephan Bösebeck Date: 26.05.12 Time: 15:48

Messaging implements a simple, threadsafe and messaging api. Used for cache synchronization. Msg can have several modes: - LockedBy set to ALL (Exclusive Messages): every listener may process it (in parallel), means 1->n. e.g. Cache sync - LockedBy null (non exclusive messages): only one listener at a time - Message listeners may return a Message as answer. Or throw a MessageRejectedException.c

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
Messaging(Morphium m)
Messaging(Morphium m, int pause, boolean processMultiple) attaches to the default queue named "msg"
Messaging(Morphium m, int pause, boolean processMultiple, boolean multithreadded, int windowSize)
Messaging(Morphium m, String queueName, int pause, boolean processMultiple)
Messaging(Morphium m, String queueName, int pause, boolean processMultiple, boolean multithreadded, int windowSize)
Messaging(Morphium m, String queueName, int pause, boolean processMultiple, boolean multithreadded, int windowSize, boolean useChangeStream)

Method Summary

Modifier and Type	Method and Description
void	addListenerForMessageNamed(String n, MessageListener l)
void	addMessageListener(MessageListener l)
void	findAndProcessPendingMessages(String name)
List<Msg>	findMessages(Query<Msg> q)
String	getCollectionName()
long	getMessageCount()
long	getNumberOfMessages()
int	getPause()
String	getQueueName()
String	getSenderId()
int	getWindowSize()
boolean	isAutoAnswer()
boolean	isMultithreadded()
boolean	isProcessMultiple()
boolean	isRunning()
boolean	isUseChangeStream()
void	onShutdown(Morphium m)
void	pauseProcessingOfMessagesNamed(String name) pause processing for certain messages
void	queueMessage(Msg m)
void	queueMessagetoSelf(Msg m)
void	removeListenerForMessageNamed(String n, MessageListener l)
void	removeMessage(Msg m)
void	removeMessageListener(MessageListener l)
void	run()
List<Msg>	sendAndAwaitAnswers(Msg theMessage, int numberOfAnswers, long timeout)
Msg	sendAndAwaitFirstAnswer(Msg theMessage, long timeoutInMs)
void	sendMessageToSelf(Msg m)
Messaging	setAutoAnswer(boolean autoAnswer)
Messaging	setMultithreadded(boolean multithreadded)
Messaging	setPause(int pause)
Messaging	setProcessMultiple(boolean processMultiple)
Messaging	setQueueName(String queueName)
void	setRunning(boolean running) Deprecated.
Messaging	setSenderId(String id)
Messaging	setUseChangeStream(boolean useChangeStream)
Messaging	setWindowSize(int windowSize)
void	start()
void	storeMessage(Msg m)
void	terminate()
Long	unpauseProcessingOfMessagesNamed(String name) unpause processing

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

Messaging

public Messaging(Morphium m,
                 int pause,
                 boolean processMultiple)

attaches to the default queue named "msg"

Parameters:

m - - morphium

pause - - pause between checks

processMultiple - - process multiple messages at once, if false, only ony by one

Messaging

public Messaging(Morphium m)

Messaging

public Messaging(Morphium m,
                 int pause,
                 boolean processMultiple,
                 boolean multithreadded,
                 int windowSize)

Messaging

public Messaging(Morphium m,
                 String queueName,
                 int pause,
                 boolean processMultiple)

Messaging

public Messaging(Morphium m,
                 String queueName,
                 int pause,
                 boolean processMultiple,
                 boolean multithreadded,
                 int windowSize)

Messaging

public Messaging(Morphium m,
                 String queueName,
                 int pause,
                 boolean processMultiple,
                 boolean multithreadded,
                 int windowSize,
                 boolean useChangeStream)

Method Detail

getMessageCount

public long getMessageCount()

removeMessage

public void removeMessage(Msg m)

findMessages

public List<Msg> findMessages(Query<Msg> q)

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

pauseProcessingOfMessagesNamed

public void pauseProcessingOfMessagesNamed(String name)

pause processing for certain messages

Parameters:

name -

unpauseProcessingOfMessagesNamed

public Long unpauseProcessingOfMessagesNamed(String name)

unpause processing

Parameters:

name -

Returns:

duration or null

findAndProcessPendingMessages

public void findAndProcessPendingMessages(String name)

getCollectionName

public String getCollectionName()

addListenerForMessageNamed

public void addListenerForMessageNamed(String n,
                                       MessageListener l)

removeListenerForMessageNamed

public void removeListenerForMessageNamed(String n,
                                          MessageListener l)

getSenderId

public String getSenderId()

setSenderId

public Messaging setSenderId(String id)

getPause

public int getPause()

setPause

public Messaging setPause(int pause)

isRunning

public boolean isRunning()

setRunning

@Deprecated
public void setRunning(boolean running)

Deprecated.

terminate

public void terminate()

addMessageListener

public void addMessageListener(MessageListener l)

removeMessageListener

public void removeMessageListener(MessageListener l)

queueMessage

public void queueMessage(Msg m)

start

public void start()

Overrides:

start in class Thread

storeMessage

public void storeMessage(Msg m)

getNumberOfMessages

public long getNumberOfMessages()

sendMessageToSelf

public void sendMessageToSelf(Msg m)

queueMessagetoSelf

public void queueMessagetoSelf(Msg m)

isAutoAnswer

public boolean isAutoAnswer()

setAutoAnswer

public Messaging setAutoAnswer(boolean autoAnswer)

onShutdown

public void onShutdown(Morphium m)

Specified by:

onShutdown in interface ShutdownListener

sendAndAwaitFirstAnswer

public Msg sendAndAwaitFirstAnswer(Msg theMessage,
                                   long timeoutInMs)

sendAndAwaitAnswers

public List<Msg> sendAndAwaitAnswers(Msg theMessage,
                                     int numberOfAnswers,
                                     long timeout)

isProcessMultiple

public boolean isProcessMultiple()

setProcessMultiple

public Messaging setProcessMultiple(boolean processMultiple)

getQueueName

public String getQueueName()

setQueueName

public Messaging setQueueName(String queueName)

isMultithreadded

public boolean isMultithreadded()

setMultithreadded

public Messaging setMultithreadded(boolean multithreadded)

getWindowSize

public int getWindowSize()

setWindowSize

public Messaging setWindowSize(int windowSize)

isUseChangeStream

public boolean isUseChangeStream()

setUseChangeStream

public Messaging setUseChangeStream(boolean useChangeStream)