How cajunsystems/cajun works
Cajun is a Java actor system for building concurrent applications. Applications define actors and handlers, configure and spawn them, then exchange messages through actor identities; actors process messages serially and can reply or create children. The broader product adds stateful recovery, backpressure, supervision, mailbox/thread-pool choices, and distributed messaging. The graph combines shown runtime calls with major README capabilities; several capability branches are represented at their source-directory level because their implementations were not sampled.
Main entry points: Actor.java Actor processing · ActorSystem.java Actor system · HandlerActor.java Handler adapter · persistence Persistence APIs
Components 21
Actor runtime
- Actor system
lib/src/main/java/com/cajunsystems/ActorSystem.java - Actor builder
lib/src/main/java/com/cajunsystems/builder/ActorBuilder.java - Actor processing
lib/src/main/java/com/cajunsystems/Actor.java - Handler adapter
lib/src/main/java/com/cajunsystems/internal/HandlerActor.java - Actor handlers
lib/src/main/java/com/cajunsystems/handler - Actor context
lib/src/main/java/com/cajunsystems/ActorContext.java - Supervision
lib/src/main/java/com/cajunsystems/SupervisionStrategy.java
Messaging and flow
- Actor identity
lib/src/main/java/com/cajunsystems/Pid.java - Request replies
lib/src/main/java/com/cajunsystems/ReplyingMessage.java - Backpressure
lib/src/main/java/com/cajunsystems/backpressure/BackpressureManager.java
Resilience and persistence
- Stateful actors
lib/src/main/java/com/cajunsystems/internal/StatefulHandlerActor.java - Persistence APIs
lib/src/main/java/com/cajunsystems/persistence - Filesystem persistence
cajun-persistence/src/main/java/com/cajunsystems/persistence/filesystem - LMDB persistence
cajun-persistence/src/main/java/com/cajunsystems/persistence/lmdb
Execution configuration
- Mailboxes
cajun-mailbox/src/main/java/com/cajunsystems/mailbox - Thread pools
lib/src/main/java/com/cajunsystems/config/ThreadPoolFactory.java
Cluster runtime
- Cluster actor system
lib/src/main/java/com/cajunsystems/cluster/ClusterActorSystem.java - Cluster factory
lib/src/main/java/com/cajunsystems/runtime/cluster/ClusterFactory.java - Cluster messaging
lib/src/main/java/com/cajunsystems/runtime/cluster/DirectMessagingSystem.java - Cluster metadata
lib/src/main/java/com/cajunsystems/runtime/cluster/EtcdMetadataStore.java
Other components
- Application
Connections 20
- Application → Actor system: creates actors
README.md - Actor system → Actor processing: starts actors
lib/src/main/java/com/cajunsystems/ActorSystem.java - Actor builder → Handler adapter: constructs
lib/src/main/java/com/cajunsystems/builder/ActorBuilder.java - Handler adapter → Actor handlers: delegates messages
lib/src/main/java/com/cajunsystems/internal/HandlerActor.java - Handler adapter → Actor processing: extends
lib/src/main/java/com/cajunsystems/internal/HandlerActor.java - Actor context → Actor identity: sends messages
lib/src/main/java/com/cajunsystems/ActorContext.java - Actor identity → Actor system: routes messages
lib/src/main/java/com/cajunsystems/Pid.java - Actor context → Request replies: replies to
lib/src/main/java/com/cajunsystems/ActorContext.java - Actor processing → Mailboxes: processes queued messages
lib/src/main/java/com/cajunsystems/Actor.java - Actor processing → Thread pools: runs on
- Actor processing → Backpressure: manages pressure
lib/src/main/java/com/cajunsystems/Actor.java - Actor processing → Supervision: recovers failures
lib/src/main/java/com/cajunsystems/Actor.java - Stateful actors → Actor handlers: runs stateful handlers
lib/src/main/java/com/cajunsystems/internal/StatefulHandlerActor.java - Stateful actors → Persistence APIs: uses persistence
lib/src/main/java/com/cajunsystems/internal/StatefulHandlerActor.java - Persistence APIs → Filesystem persistence: implemented by
cajun-persistence/src/main/java/com/cajunsystems/persistence/impl/FileSystemPersistenceProvider.java - Persistence APIs → LMDB persistence: implemented by
cajun-persistence/src/main/java/com/cajunsystems/persistence/lmdb/LmdbSnapshotStore.java - Actor system → Cluster actor system: supports cluster mode
- Cluster factory → Cluster messaging: creates messaging
- Cluster factory → Cluster metadata: creates metadata store
- Cluster actor system → Cluster messaging: distributes messages