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

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

Core runtime, protocol lifecycle, executor models, and protocol extensions for Babel 2.

This package contains the central orchestrator and protocol interfaces for the Babel 2 framework:

Runtime & Bootstrap

• Babel — The core runtime managing channel lifecycles, protocol registrations, and event routing.
• BabelBootstrap — Fluent builder configuring the runtime, node identity, cryptographic key pairs, channel composition, and protocol registrations.

Protocol Abstractions & Execution

• BabelProtocol — Core interface implemented by all protocols, receiving initialization, channel events, and annotated event/message handlers.
• BabelProtocolHolder — Manages the thread execution model for an individual protocol:
  • DedicatedExecutorProtocolHolder — Runs the protocol on a single dedicated thread.
  • SharedExecutorProtocolHolder — Shares an executor thread pool across multiple protocols.
  • NettyExecutorProtocolHolder — Executes protocol handlers directly within Netty event loops.

Node Identity & Extensions

• BabelNode — Abstract identity interface representing nodes in the distributed system.
• IPBabelNodeIdentity — Specialization identifying nodes by channel name and socket address.
• ProtocolExtension and ProtocolExtensionFactory — Modular extension system enabling composable capabilities (Broadcast, Membership, Resolver, Signed Messaging).

Related Packages

Package	Description
pt.unl.fct.di.novasys.babel2.core.broadcast	Provides interfaces and extensions for implementing and consuming broadcast services in the Babel 2 framework.
pt.unl.fct.di.novasys.babel2.core.membership	Provides interfaces and extensions for implementing and consuming membership (overlay network) services in the Babel 2 framework.
pt.unl.fct.di.novasys.babel2.core.resolver	Address and node component resolution protocol abstractions and extensions for Babel 2.
pt.unl.fct.di.novasys.babel2.core.signed	Cryptographically signed message support and extensions for Babel 2 protocols.

Class	Description
AbstractBabelProtocolHolder	Abstract base implementation of BabelProtocolHolder providing handler discovery via reflection, dynamic lambda generation, and dispatch routines.
Babel	The Babel class serves as the central orchestration engine for the Babel 2 runtime.
BabelBootstrap	Builder class for configuring and creating a Babel runtime instance.
BabelNode	Opaque handle that represents a remote Babel process reachable through a BabelChannel.
BabelProtocol	Defines the lifecycle and configuration requirements for a protocol within the Babel framework.
BabelProtocolFactory<T extends BabelProtocol>	Factory interface for creating BabelProtocol instances from a Properties configuration object.
BabelProtocolHolder	Wraps a BabelProtocol and manages its execution environment, event delivery, and dispatching of messages and events.
BabelProtocolHolderFactory	Factory interface for creating instances of BabelProtocolHolder.
DedicatedExecutorProtocolHolder	A BabelProtocolHolder implementation that runs the protocol on a dedicated, single-threaded executor using a lock-free MpscArrayQueue.
DedicatedExecutorProtocolHolderFactory	Factory for creating DedicatedExecutorProtocolHolder instances.
IPBabelNodeIdentity	A BabelNode identity implementation based on an IP socket address and channel type.
NettyExecutorProtocolHolder	Protocol holder implementation executing protocol event handlers on a Netty EventLoopGroup.
NettyExecutorProtocolHolderFactory	Factory for creating NettyExecutorProtocolHolder instances backed by a Netty EventLoopGroup.
ProtocolExtension<T extends BabelProtocol>	A pluggable cross-cutting extension that augments a BabelProtocol with additional event handling capabilities.
ProtocolExtensionFactory	Factory interface for creating ProtocolExtension instances.
SharedExecutorProtocolHolder	A BabelProtocolHolder implementation that schedules event queue draining on a shared thread pool executor.
SharedExecutorProtocolHolderFactory	Factory for creating SharedExecutorProtocolHolder instances that share a common fixed thread pool executor.