How cafanasyev/java-sapient-sdk works
The Java SAPIENT SDK connects an application’s node implementations to a fusion node over TCP. Its main workflow is node registration, acknowledgement handling, periodic status reporting, and routing inbound tasks/acks; callers can also publish typed reports and alerts. NodeWrapper owns each node’s lifecycle, while NodeDispatcher coordinates wrappers and the transport client. The README documents TLS configuration and optional connection-state monitoring. Some implementation details are unsampled, so uncertain links are omitted or marked unverified.
Main entry points: NodeDispatcher.java Node Dispatcher · SocketClient.java Socket Client · NodeWrapper.java Node Wrapper · INode.java Node Implementation
Components 14
Node API
- Node Implementation
src/main/java/io/sapient/transmission/INode.java - Dispatcher API
src/main/java/io/sapient/transmission/INodeDispatcher.java
Node Lifecycle
- Node Dispatcher
src/main/java/io/sapient/transmission/NodeDispatcher.java - Node Wrapper
src/main/java/io/sapient/transmission/NodeWrapper.java - Dispatcher Config
src/main/java/io/sapient/transmission/NodeDispatcherConfig.java - Lifecycle Jitter
src/main/java/io/sapient/transmission/Jitter.java
TCP Transport
- Client API
src/main/java/io/sapient/transport/IClient.java - Socket Client
src/main/java/io/sapient/transport/SocketClient.java - Socket Provider
src/main/java/io/sapient/transport/ISocketProvider.java - Connection State
src/main/java/io/sapient/transport/ConnectionState.java - Thread Safety Marker
src/main/java/io/sapient/transport/ThreadSafe.java
TLS Support
- SSL Context Factory
src/main/java/io/sapient/transport/SslContextFactory.java
Other components
- SDK Integrator
- Fusion Node
Connections 19
- SDK Integrator → Node Implementation: implements
README.md - SDK Integrator → Node Dispatcher: configures
README.md - SDK Integrator → Socket Provider: implements
README.md - Dispatcher API → Node Implementation: manages
src/main/java/io/sapient/transmission/INodeDispatcher.java - Node Dispatcher → Node Wrapper: creates
src/main/java/io/sapient/transmission/NodeDispatcher.java - Node Dispatcher → Dispatcher Config: uses
src/main/java/io/sapient/transmission/NodeDispatcher.java - Node Dispatcher → Client API: publishes through
src/main/java/io/sapient/transmission/NodeDispatcher.java - Node Dispatcher → Node Implementation: routes callbacks
src/main/java/io/sapient/transmission/NodeDispatcher.java - Node Wrapper → Node Implementation: polls and reports
src/main/java/io/sapient/transmission/NodeWrapper.java - Node Wrapper → Node Dispatcher: publishes reports
src/main/java/io/sapient/transmission/NodeWrapper.java - Node Wrapper → Lifecycle Jitter: uses timing
src/main/java/io/sapient/transmission/NodeWrapper.java - Dispatcher Config → Lifecycle Jitter: sets window
src/main/java/io/sapient/transmission/NodeDispatcherConfig.java - Client API → Connection State: exposes
src/main/java/io/sapient/transport/IClient.java - Socket Client → Client API: implements
src/main/java/io/sapient/transport/SocketClient.java - Socket Client → Socket Provider: opens sockets via
src/main/java/io/sapient/transport/SocketClient.java - Socket Client → Connection State: reports
src/main/java/io/sapient/transport/SocketClient.java - Socket Client → Thread Safety Marker: uses annotation
src/main/java/io/sapient/transport/SocketClient.java - Socket Client → Fusion Node: exchanges messages
README.md - SSL Context Factory → Socket Provider: can supply TLS
README.md