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	getSenderId()
boolean	isAutoAnswer()
boolean	isRunning()
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)
void	setAutoAnswer(boolean autoAnswer)
void	setPause(int pause)
void	setRunning(boolean running) Deprecated.
void	setSenderId(String id)
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 void setSenderId(String id)

getPause

public int getPause()

setPause

public void 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 void 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)