Threads und Message-Queues on sillysky.net

EThreadPriority

Tue, 14 Oct 2025 00:00:00 +0000

This enum describes the priority of a thread.

LOWEST (1)
VERY_LOW (2)
LOWER (3)
LOW (4)
NORMAL (5)
HIGH (6)
HIGHER (7)
VERY_HIGH (8)
ULTRA_HIGH (9)
HIGHEST (10)

The enum is used e.g. in the job engine.

A Java thread can be assigned priority 1 (low) to 10 (high).

IMessageQueue

Tue, 14 Oct 2025 00:00:00 +0000

Each thread of a namespaces has its own message queue. Here the messages are added, which are addressed to targets, which are associated with the thread. The thread fetches the messages from the queue and then delivers them to the target. This ensures that messages for a target are always processed in the same thread.

The methods of the message queue are only used by the system, but they are in principle also accessible to the community, e.g. to configure the thread.

IMessageQueueRegistry

Tue, 14 Oct 2025 00:00:00 +0000

Each namespace has a MessageQueueRegistry. All message queues of the namespaces are registered here. Each MessageQueueRegistry contains at least one message queue. However, the user can add more.

Access

The registry is obtained via getter from the namespace:

final IMessageQueueRegistry mqr = namespace.getMessageQueueRegistry();

Creating a message queue

This method creates a message queue and starts it.

@NotNull IMessageQueue createAndStartAsyncQueue(@NotNull IId aQueueId,
                                                @NotNull String aDesc,
                                                int aThreadPriority) throws CException;

It requires a valid queue ID, which can be created via CIdFactory.