Klasse SingleCollectionMessaging

java.lang.Object

java.lang.Thread

de.caluga.morphium.messaging.SingleCollectionMessaging

Alle implementierten Schnittstellen:

MorphiumMessaging, ShutdownListener, Closeable, AutoCloseable, Runnable

public class SingleCollectionMessaging
extends Thread
implements ShutdownListener, MorphiumMessaging

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

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifikator und Typ	Klasse	Beschreibung
static interface	SingleCollectionMessaging.AsyncMessageCallback
static class	SingleCollectionMessaging.MessageTimeoutException
static class	SingleCollectionMessaging.ProcessingQueueElement
static class	SingleCollectionMessaging.SystemShutdownException

Von Klasse geerbte verschachtelte Klassen/Schnittstellen Thread

Thread.Builder, Thread.State, Thread.UncaughtExceptionHandler

Feldübersicht

Von Klasse geerbte Felder Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
SingleCollectionMessaging()
SingleCollectionMessaging(Morphium m)	Veraltet.
SingleCollectionMessaging(Morphium m, int pause)	Veraltet.
SingleCollectionMessaging(Morphium m, int pause, boolean processMultiple)	Veraltet.
SingleCollectionMessaging(Morphium m, int pause, boolean processMultiple, boolean multithreadded, int windowSize)	Veraltet.
SingleCollectionMessaging(Morphium m, int pause, boolean multithreadded, int windowSize)	Veraltet.
SingleCollectionMessaging(Morphium m, String queueName, int pause, boolean processMultiple)	Veraltet.
SingleCollectionMessaging(Morphium m, String queueName, int pause, boolean processMultiple, boolean multithreadded, int windowSize)	Veraltet.
SingleCollectionMessaging(Morphium m, String queueName, int pause, boolean processMultiple, boolean multithreadded, int windowSize, boolean useChangeStream)	Veraltet.
SingleCollectionMessaging(Morphium m, String queueName, int pause, boolean multithreadded, int windowSize)	Veraltet.
SingleCollectionMessaging(Morphium m, String queueName, int pause, boolean multithreadded, int windowSize, boolean useChangeStream)	Veraltet.

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
void	addListenerForTopic(String n, MessageListener l)
void	close()
void	disableStatusInfoListener()
void	enableStatusInfoListener()
List<MorphiumMessaging>	getAlternativeMessagings()
int	getAsyncMessagesPending()
String	getCollectionName()
String	getCollectionName(Msg msg)
String	getCollectionName(String msgName)
String	getDMCollectionName(String sender)
int	getInProgressCount()
Map<String, List<String>>	getListenerNames()
MsgLock	getLock(Msg m)
String	getLockCollectionName()
String	getLockCollectionName(String topic)
<T extends Msg> String	getLockCollectionName(T topic)
Morphium	getMorphium()
long	getNumberOfMessages()
int	getPause()
List<String>	getPausedTopics()
long	getPendingMessagesCount()
int	getProcessingCount()
String	getQueueName()
int	getRunningTasks()
String	getSenderId()
String	getStatusInfoListenerName()
Map<String,Long>	getThreadPoolStats()
int	getWindowSize()
void	init(Morphium m)
void	init(Morphium m, MessagingSettings settings)
boolean	isAutoAnswer()
boolean	isMultithreadded()
boolean	isProcessMultiple()
boolean	isRunning()
boolean	isStatusInfoListenerEnabled()
boolean	isUseChangeStream()
boolean	lockMessage(Msg m, String lockId)
boolean	lockMessage(Msg m, String lockId, Date delAt)
void	onShutdown(Morphium m)
void	pauseTopicProcessing(String name)	pause processing for certain messages
void	queueMessage(Msg m)
void	queueMessagetoSelf(Msg m)
void	removeListenerForTopic(String n, MessageListener l)
void	removeMessage(Msg m)
void	run()
<T extends Msg> List<T>	sendAndAwaitAnswers(T theMessage, int numberOfAnswers, long timeout)
<T extends Msg> List<T>	sendAndAwaitAnswers(T theMessage, int numberOfAnswers, long timeout, boolean throwExceptionOnTimeout)
<T extends Msg> void	sendAndAwaitAsync(T theMessage, long timeoutInMs, SingleCollectionMessaging.AsyncMessageCallback cb)	Sends a message asynchronously and sends all incoming answers via callback.
<T extends Msg> T	sendAndAwaitFirstAnswer(T theMessage, long timeoutInMs)
<T extends Msg> T	sendAndAwaitFirstAnswer(T theMessage, long timeoutInMs, boolean throwExceptionOnTimeout)
void	sendMessage(Msg m)
void	sendMessageToSelf(Msg m)
MorphiumMessaging	setAutoAnswer(boolean autoAnswer)
MorphiumMessaging	setMultithreadded(boolean multithreadded)
SingleCollectionMessaging	setPause(int pause)
MorphiumMessaging	setPolling(boolean doPolling)	Just for the understanding: if you do not use the changestream, messaging will poll for new mesages regularly (configured by the pause) setPolling(true) == setUseChangeStream(false)!!!!!!
MorphiumMessaging	setProcessMultiple(boolean processMultiple)	Veraltet.
MorphiumMessaging	setQueueName(String queueName)
SingleCollectionMessaging	setSenderId(String id)
void	setStatusInfoListenerEnabled(boolean statusInfoListenerEnabled)
void	setStatusInfoListenerName(String statusInfoListenerName)
MorphiumMessaging	setUseChangeStream(boolean useChangeStream)
MorphiumMessaging	setWindowSize(int windowSize)
void	terminate()
void	triggerCheck()
Long	unpauseTopicProcessing(String name)	unpause processing
int	waitingForAnswersCount()
int	waitingForAnswersTotalCount()

Von Klasse geerbte Methoden Thread

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

Von Klasse geerbte Methoden Object

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

Von Schnittstelle geerbte Methoden MorphiumMessaging

start

Konstruktordetails

SingleCollectionMessaging

public SingleCollectionMessaging()

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 int pause,
 boolean processMultiple)

Veraltet.

attaches to the default queue named "msg"

Parameter:

m - - morphium

pause - - pause between checks

processMultiple - - deprecated, set windowSize to 1 if needed

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 int pause)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 int pause,
 boolean processMultiple,
 boolean multithreadded,
 int windowSize)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 int pause,
 boolean multithreadded,
 int windowSize)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 String queueName,
 int pause,
 boolean processMultiple)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 String queueName,
 int pause,
 boolean multithreadded,
 int windowSize)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 String queueName,
 int pause,
 boolean processMultiple,
 boolean multithreadded,
 int windowSize)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 String queueName,
 int pause,
 boolean processMultiple,
 boolean multithreadded,
 int windowSize,
 boolean useChangeStream)

Veraltet.

SingleCollectionMessaging

@Deprecated
public SingleCollectionMessaging(Morphium m,
 String queueName,
 int pause,
 boolean multithreadded,
 int windowSize,
 boolean useChangeStream)

Veraltet.

Parameter:

m - : the morphium instance to use

queueName - : The name of the messaging queue

windowSize - : how many messages to mark for processing at once

useChangeStream - : whether to use changeStream (reccommended!) or not. Attention: changestream cannot be used on single mongodb instances or mongos sharded clusters - needs to be a replicaset! morphium automatically sets this value accordingly depending on your configuration

Methodendetails

init

public void init(Morphium m)

Angegeben von:

init in Schnittstelle MorphiumMessaging

init

public void init(Morphium m,
 MessagingSettings settings)

Angegeben von:

init in Schnittstelle MorphiumMessaging

getAlternativeMessagings

public List<MorphiumMessaging> getAlternativeMessagings()

Angegeben von:

getAlternativeMessagings in Schnittstelle MorphiumMessaging

enableStatusInfoListener

public void enableStatusInfoListener()

Angegeben von:

enableStatusInfoListener in Schnittstelle MorphiumMessaging

disableStatusInfoListener

public void disableStatusInfoListener()

Angegeben von:

disableStatusInfoListener in Schnittstelle MorphiumMessaging

getStatusInfoListenerName

public String getStatusInfoListenerName()

Angegeben von:

getStatusInfoListenerName in Schnittstelle MorphiumMessaging

setStatusInfoListenerName

public void setStatusInfoListenerName(String statusInfoListenerName)

Angegeben von:

setStatusInfoListenerName in Schnittstelle MorphiumMessaging

getProcessingCount

public int getProcessingCount()

Angegeben von:

getProcessingCount in Schnittstelle MorphiumMessaging

getInProgressCount

public int getInProgressCount()

Angegeben von:

getInProgressCount in Schnittstelle MorphiumMessaging

waitingForAnswersCount

public int waitingForAnswersCount()

Angegeben von:

waitingForAnswersCount in Schnittstelle MorphiumMessaging

waitingForAnswersTotalCount

public int waitingForAnswersTotalCount()

Angegeben von:

waitingForAnswersTotalCount in Schnittstelle MorphiumMessaging

isStatusInfoListenerEnabled

public boolean isStatusInfoListenerEnabled()

Angegeben von:

isStatusInfoListenerEnabled in Schnittstelle MorphiumMessaging

setStatusInfoListenerEnabled

public void setStatusInfoListenerEnabled(boolean statusInfoListenerEnabled)

Angegeben von:

setStatusInfoListenerEnabled in Schnittstelle MorphiumMessaging

getListenerNames

public Map<String, List<String>> getListenerNames()

Angegeben von:

getListenerNames in Schnittstelle MorphiumMessaging

getThreadPoolStats

public Map<String,Long> getThreadPoolStats()

Angegeben von:

getThreadPoolStats in Schnittstelle MorphiumMessaging

getPendingMessagesCount

public long getPendingMessagesCount()

Angegeben von:

getPendingMessagesCount in Schnittstelle MorphiumMessaging

removeMessage

public void removeMessage(Msg m)

Angegeben von:

removeMessage in Schnittstelle MorphiumMessaging

run

public void run()

Angegeben von:

run in Schnittstelle Runnable

Setzt außer Kraft:

run in Klasse Thread

getAsyncMessagesPending

public int getAsyncMessagesPending()

Angegeben von:

getAsyncMessagesPending in Schnittstelle MorphiumMessaging

pauseTopicProcessing

public void pauseTopicProcessing(String name)

pause processing for certain messages

Angegeben von:

pauseTopicProcessing in Schnittstelle MorphiumMessaging

Parameter:

name -

getPausedTopics

public List<String> getPausedTopics()

Angegeben von:

getPausedTopics in Schnittstelle MorphiumMessaging

unpauseTopicProcessing

public Long unpauseTopicProcessing(String name)

unpause processing

Angegeben von:

unpauseTopicProcessing in Schnittstelle MorphiumMessaging

Parameter:

name -

Gibt zurück:

duration or null

triggerCheck

public void triggerCheck()

getLock

public MsgLock getLock(Msg m)

getLockCollectionName

public String getLockCollectionName()

Angegeben von:

getLockCollectionName in Schnittstelle MorphiumMessaging

lockMessage

public boolean lockMessage(Msg m,
 String lockId)

lockMessage

public boolean lockMessage(Msg m,
 String lockId,
 Date delAt)

Angegeben von:

lockMessage in Schnittstelle MorphiumMessaging

getCollectionName

public String getCollectionName()

Angegeben von:

getCollectionName in Schnittstelle MorphiumMessaging

getCollectionName

public String getCollectionName(String msgName)

Angegeben von:

getCollectionName in Schnittstelle MorphiumMessaging

getCollectionName

public String getCollectionName(Msg msg)

Angegeben von:

getCollectionName in Schnittstelle MorphiumMessaging

addListenerForTopic

public void addListenerForTopic(String n,
 MessageListener l)

Angegeben von:

addListenerForTopic in Schnittstelle MorphiumMessaging

removeListenerForTopic

public void removeListenerForTopic(String n,
 MessageListener l)

Angegeben von:

removeListenerForTopic in Schnittstelle MorphiumMessaging

getSenderId

public String getSenderId()

Angegeben von:

getSenderId in Schnittstelle MorphiumMessaging

setSenderId

public SingleCollectionMessaging setSenderId(String id)

Angegeben von:

setSenderId in Schnittstelle MorphiumMessaging

getPause

public int getPause()

Angegeben von:

getPause in Schnittstelle MorphiumMessaging

setPause

public SingleCollectionMessaging setPause(int pause)

Angegeben von:

setPause in Schnittstelle MorphiumMessaging

isRunning

public boolean isRunning()

Angegeben von:

isRunning in Schnittstelle MorphiumMessaging

close

public void close()

Angegeben von:

close in Schnittstelle AutoCloseable

Angegeben von:

close in Schnittstelle Closeable

Angegeben von:

close in Schnittstelle MorphiumMessaging

terminate

public void terminate()

Angegeben von:

terminate in Schnittstelle MorphiumMessaging

queueMessage

public void queueMessage(Msg m)

Angegeben von:

queueMessage in Schnittstelle MorphiumMessaging

sendMessage

public void sendMessage(Msg m)

Angegeben von:

sendMessage in Schnittstelle MorphiumMessaging

getNumberOfMessages

public long getNumberOfMessages()

Angegeben von:

getNumberOfMessages in Schnittstelle MorphiumMessaging

sendMessageToSelf

public void sendMessageToSelf(Msg m)

Angegeben von:

sendMessageToSelf in Schnittstelle MorphiumMessaging

queueMessagetoSelf

public void queueMessagetoSelf(Msg m)

Angegeben von:

queueMessagetoSelf in Schnittstelle MorphiumMessaging

isAutoAnswer

public boolean isAutoAnswer()

Angegeben von:

isAutoAnswer in Schnittstelle MorphiumMessaging

setAutoAnswer

public MorphiumMessaging setAutoAnswer(boolean autoAnswer)

Angegeben von:

setAutoAnswer in Schnittstelle MorphiumMessaging

onShutdown

public void onShutdown(Morphium m)

Angegeben von:

onShutdown in Schnittstelle ShutdownListener

sendAndAwaitFirstAnswer

public <T extends Msg> T sendAndAwaitFirstAnswer(T theMessage,
 long timeoutInMs)

Angegeben von:

sendAndAwaitFirstAnswer in Schnittstelle MorphiumMessaging

sendAndAwaitAsync

public <T extends Msg> void sendAndAwaitAsync(T theMessage,
 long timeoutInMs,
 SingleCollectionMessaging.AsyncMessageCallback cb)

Sends a message asynchronously and sends all incoming answers via callback. If sent message is exclusive, only one answer will be processed, otherwise all incoming answers up to timeout will be processed.

Angegeben von:

sendAndAwaitAsync in Schnittstelle MorphiumMessaging

sendAndAwaitFirstAnswer

public <T extends Msg> T sendAndAwaitFirstAnswer(T theMessage,
 long timeoutInMs,
 boolean throwExceptionOnTimeout)

Angegeben von:

sendAndAwaitFirstAnswer in Schnittstelle MorphiumMessaging

sendAndAwaitAnswers

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

Angegeben von:

sendAndAwaitAnswers in Schnittstelle MorphiumMessaging

sendAndAwaitAnswers

public <T extends Msg> List<T> sendAndAwaitAnswers(T theMessage,
 int numberOfAnswers,
 long timeout,
 boolean throwExceptionOnTimeout)

Angegeben von:

sendAndAwaitAnswers in Schnittstelle MorphiumMessaging

isProcessMultiple

public boolean isProcessMultiple()

Angegeben von:

isProcessMultiple in Schnittstelle MorphiumMessaging

setProcessMultiple

@Deprecated
public MorphiumMessaging setProcessMultiple(boolean processMultiple)

Veraltet.

Angegeben von:

setProcessMultiple in Schnittstelle MorphiumMessaging

getQueueName

public String getQueueName()

Angegeben von:

getQueueName in Schnittstelle MorphiumMessaging

setQueueName

public MorphiumMessaging setQueueName(String queueName)

Angegeben von:

setQueueName in Schnittstelle MorphiumMessaging

isMultithreadded

public boolean isMultithreadded()

Angegeben von:

isMultithreadded in Schnittstelle MorphiumMessaging

setMultithreadded

public MorphiumMessaging setMultithreadded(boolean multithreadded)

Angegeben von:

setMultithreadded in Schnittstelle MorphiumMessaging

getWindowSize

public int getWindowSize()

Angegeben von:

getWindowSize in Schnittstelle MorphiumMessaging

setWindowSize

public MorphiumMessaging setWindowSize(int windowSize)

Angegeben von:

setWindowSize in Schnittstelle MorphiumMessaging

isUseChangeStream

public boolean isUseChangeStream()

Angegeben von:

isUseChangeStream in Schnittstelle MorphiumMessaging

getRunningTasks

public int getRunningTasks()

Angegeben von:

getRunningTasks in Schnittstelle MorphiumMessaging

getMorphium

public Morphium getMorphium()

Angegeben von:

getMorphium in Schnittstelle MorphiumMessaging

setPolling

public MorphiumMessaging setPolling(boolean doPolling)

Just for the understanding: if you do not use the changestream, messaging will poll for new mesages regularly (configured by the pause) setPolling(true) == setUseChangeStream(false)!!!!!!

Angegeben von:

setPolling in Schnittstelle MorphiumMessaging

setUseChangeStream

public MorphiumMessaging setUseChangeStream(boolean useChangeStream)

Angegeben von:

setUseChangeStream in Schnittstelle MorphiumMessaging

getLockCollectionName

public <T extends Msg> String getLockCollectionName(T topic)

Angegeben von:

getLockCollectionName in Schnittstelle MorphiumMessaging

getLockCollectionName

public String getLockCollectionName(String topic)

Angegeben von:

getLockCollectionName in Schnittstelle MorphiumMessaging

getDMCollectionName

public String getDMCollectionName(String sender)

Angegeben von:

getDMCollectionName in Schnittstelle MorphiumMessaging