Introduction to nyssr.net on sillysky.net

Messages

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

Messages in nyssr.net are asynchronous and object-to-object. A target waits for incoming messages, processes them, and can send further messages without blocking the rest of the network.

This simple mechanism supports observers, notifications, services, broadcasts, requests, and responses.

Request and response

A message travels from a sender to a receiver. Both addresses are carried in the envelope. When the sender wants an answer, it sets the wantAnswer flag. The receiver can then return a response after processing the request.

Namespaces

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

Namespaces are components of Nodes.

Each namespace has at least one thread, exactly one target registry, and exactly one nano service registry. They are the basis of applications, since applications with all their targets and local services must be executed multiple times and simultaneously in a node.

Target Registries

Namespaces have a Target-Registry. Targets - the Java objects that can receive messages - are registered in these target registries. During registration, the targets are given a unique address. The namespace ID is part of this address.

Nodes

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

A node is a small Java runtime that participates in the nyssr.net network. Its microkernel is roughly 1.2 MByte and contains the messaging core, timers, threads, namespaces, and logging. Networking and other capabilities are loaded as plugins when the node starts.

One runtime, many roles

Nodes are normally built from the same kernel and configured through their plugin list. The same container can therefore take different roles:

a registry or coordination node
a node hosting application services
a node connected to local databases or machines
a client or development node

The role is not hardcoded into the container. Plugins provide the capabilities.

Segments

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

All nodes of a company are part of a Segment .

The operation of multiple segments and the communication of objects between the segments is currently still experimental.

Targets

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

The class that programmers work with most often is the Target class. Targets are lightweight Java Objects that send and receive messages.

Registration

To make this possible, they are registered in the Target Registry. Upon successful registration, a target receives an ID, the target ID (TID for short). It is possible to give constant TIDs to targets during registration, but usually a random ID generated by the target registry is sufficient.

Concurrency

All messages are sent asynchronously. Targets are bound to a thread during registration, which is part of a so-called namespace. All messages, which they receive in the lifetime, they will always receive in this thread. Messages are never passed to the target at the same time, but they are always processed one after the other. This avoids problems with concurrency. If several targets are to exchange data together, they should be registered in the same namespace thread.