Package pt.unl.fct.di.novasys.babel2.channels

@NullMarked package pt.unl.fct.di.novasys.babel2.channels

Channel abstractions, lifecycle builders, wire messages, and node components for Babel 2.

This package forms the transport abstraction layer of Babel 2, decoupling protocol logic from concrete network transports.

Key Concepts

• Channels: BabelChannel is the base channel interface supporting unicast and ephemeral messaging. ComposedBabelChannel aggregates multiple concrete channels (such as TCP, UDP, and QUIC) into a single composite transport. IPBabelChannel specializes channels operating over IP sockets.
• Builders: BabelChannelBuilder, AbstractBabelChannelBuilder, and AbstractIPBabelChannelBuilder provide fluent configuration for channel parameters including binding addresses, event loops, and connection tolerances.
• Messages: BabelMessage is the foundational marker interface for all network messages. Application messages annotate records with BabelIPMessage to generate wire serializers. SignedBabelMessage wraps payloads with cryptographic signatures.
• Node Components: BabelNodeComponent and IPBabelNodeComponent represent transport-specific addressing attributes attached to abstract node identities.
• Node Store: NodeStore and DefaultNodeStore manage dynamic node resolution and component storage.

Related Packages

Package	Description
pt.unl.fct.di.novasys.babel2.channels.discovery	Channel extensions and interfaces for local network broadcast and multicast communication.
pt.unl.fct.di.novasys.babel2.channels.exceptions	Exception types thrown by Babel 2 channel and serialization subsystems.
pt.unl.fct.di.novasys.babel2.channels.internal	In-memory simulated communication channels for intra-JVM protocol testing and message passing.
pt.unl.fct.di.novasys.babel2.channels.messages	Network handshake and discovery messages exchanged across IP channels.
pt.unl.fct.di.novasys.babel2.channels.quic	QUIC transport channel implementation for Babel 2, providing multiplexed, stream-oriented communication secured by mutual TLS.
pt.unl.fct.di.novasys.babel2.channels.serializers	Core serializer abstractions, registries, and primitive wire serializers for Babel 2 IP messaging.
pt.unl.fct.di.novasys.babel2.channels.tcp_tls	TCP transport channel implementation for Babel 2, providing reliable, ordered, connection-oriented message delivery over persistent TCP sockets with configurable authentication modes and identity verification.
pt.unl.fct.di.novasys.babel2.channels.udp	UDP datagram channel implementation for connectionless unicast and multicast messaging.
pt.unl.fct.di.novasys.babel2.channels.utils	Platform transport utilities and helper methods for Netty network channels.

Class	Description
AbstractBabelChannelBuilder<T extends BabelChannelBuilder>	Abstract base class for BabelChannelBuilder implementations.
AbstractIPBabelChannelBuilder<T extends BabelChannelBuilder>	Base builder for channel implementations operating over IP networks.
BabelChannel	Represents a communication channel between two Babel runtimes.
BabelChannelBuilder	Factory interface for creating BabelChannel instances during runtime initialisation.
BabelIPMessage	Annotation that marks a Java record as a Babel IP network message and assigns it a unique integer identifier used during serialization and deserialization.
BabelMessage	Marker interface for all protocol-level messages exchanged between BabelNode instances through a BabelChannel.
BabelNodeComponent	Represents a component attached to a BabelNode.
BasicSignedBabelMessageSerializer<T extends BabelMessage>	Serializer and verifier for SignedBabelMessage instances wrapping a message of type T.
ComposedBabelChannel	A BabelChannel that composes many underlying channels.
DefaultNodeStore	Default implementation of NodeStore using concurrent collections.
FullSignedBabelMessageSerializer<T extends BabelMessage>	Extended serializer for SignedBabelMessage instances capable of both signing outgoing messages and forwarding already-signed messages.
IPBabelChannel	Interface representing a Babel channel operating over IP network protocols (TCP, TLS, UDP, QUIC).
IPBabelNodeComponent	Immutable record that identifies a Babel node by its IP-level socket address.
MessageProcessor	Compile-time annotation processor that generates binary serializer classes for every Java record annotated with BabelIPMessage.
NodeStore	A central directory mapping identities (BabelNode) to transport-specific attributes (BabelNodeComponent).
PublicKeyBabelNode	A default implementation of a BabelNode, identified by a PublicKey.
PublicKeyBabelNodeComparator	Canonical Comparator for PublicKeyBabelNode instances based on the lexicographical comparison of their encoded public key bytes.
SignedBabelMessage<T extends BabelMessage>	Wrapper for a BabelMessage that optionally carries a cryptographic signature and the identity of the sending node.