How stoufexis/jarpc works
Jarpc is a schema-driven Java RPC generator plus a runtime built on Aeron. The main workflow is: a caller supplies a service specification, the generator parses RPC fields and types and renders typed client/server and codec classes; generated clients encode and publish requests, while generated servers decode requests and encode responses. Runtime support handles Aeron connections, message framing, polling, and concurrent-client dispatch. The README documents both client modes and the single-threaded server. Runtime internals are sampled selectively, so unsampled links are omitted rather than inferred.
Main entry points: SingleThreadedJarpcServer.java Server transport · template Typed RPC classes · SingleThreadedJarpcClient.java Single-thread client base · ConcurrentJarpcClient.java Concurrent client
Components 24
Schema generation
- Generator CLI
generator/src/main/java/stoufexis/jarpc/gen/Cli.java - Schema model
generator/src/main/java/stoufexis/jarpc/gen/model/Spec.java - Template generator
generator/src/main/java/stoufexis/jarpc/gen/Generator.java - Typed RPC classes
generator/src/main/resources/template
Client runtime
- Generated clients
generator/src/main/resources/template/client - Concurrent client
generator/src/main/resources/template/client/ConcurrentJarpcClient.java - Single-thread client base
lib/src/main/java/stoufexis/jarpc/lib/client/singlethread/SingleThreadedJarpcClient.java - Response dispatch
lib/src/main/java/stoufexis/jarpc/lib/client/concurrent/ResponseHandlerUtil.java - Request queue
lib/src/main/java/stoufexis/jarpc/lib/client/ringbuffer/MPSCBufferPollAgent.java - Client error handling
lib/src/main/java/stoufexis/jarpc/lib/client/ClientErrorHandler.java
Protocol support
- Generated codecs
generator/src/main/resources/template/common - Connection config
lib/src/main/java/stoufexis/jarpc/lib/common/ConnectionConfig.java - Message publisher
lib/src/main/java/stoufexis/jarpc/lib/common/Publisher.java - Message framing
lib/src/main/java/stoufexis/jarpc/lib/common/internal/MessageHeaderCodec.java - Field encoding
lib/src/main/java/stoufexis/jarpc/lib/common/EncodeUtil.java - Field decoding
lib/src/main/java/stoufexis/jarpc/lib/common/DecodeUtil.java
Server runtime
- Generated server
generator/src/main/resources/template/server - Server transport
lib/src/main/java/stoufexis/jarpc/lib/server/SingleThreadedJarpcServer.java - Server state machine
lib/src/main/java/stoufexis/jarpc/lib/server/ServerStateMachine.java - Client image tracking
lib/src/main/java/stoufexis/jarpc/lib/server/Images.java - Server publications
lib/src/main/java/stoufexis/jarpc/lib/server/internal/ServerPublications.java
Other components
- Service developer
- RPC specification
- Aeron transport
Connections 26
- Service developer → RPC specification: defines schema
README.md - Service developer → Generator CLI: runs generator
README.md - Generator CLI → Schema model: parses spec
generator/src/main/java/stoufexis/jarpc/gen/Cli.java - Generator CLI → Template generator: requests generation
generator/src/main/java/stoufexis/jarpc/gen/Cli.java - Template generator → Schema model: renders from
generator/src/main/java/stoufexis/jarpc/gen/Generator.java - Template generator → Typed RPC classes: renders templates
generator/src/main/java/stoufexis/jarpc/gen/Generator.java - Typed RPC classes → Generated clients: includes
README.md - Typed RPC classes → Generated server: includes
README.md - Typed RPC classes → Generated codecs: includes
README.md - Concurrent client → Single-thread client base: delegates polling
generator/src/main/resources/template/client/ConcurrentJarpcClient.java - Concurrent client → Request queue: queues requests
generator/src/main/resources/template/client/ConcurrentJarpcClient.java - Concurrent client → Response dispatch: dispatches responses
generator/src/main/resources/template/client/ConcurrentJarpcClient.java - Single-thread client base → Message publisher: publishes requests
lib/src/main/java/stoufexis/jarpc/lib/client/singlethread/SingleThreadedJarpcClient.java - Single-thread client base → Message framing: decodes headers
lib/src/main/java/stoufexis/jarpc/lib/client/singlethread/SingleThreadedJarpcClient.java - Single-thread client base → Client error handling: reports errors
lib/src/main/java/stoufexis/jarpc/lib/client/singlethread/SingleThreadedJarpcClient.java - Generated clients → Field encoding: encodes fields
generator/src/main/resources/template/client/SingleThreadedJarpcClient.java - Generated clients → Field decoding: decodes fields
generator/src/main/resources/template/client/SingleThreadedJarpcClient.java - Connection config → Aeron transport: configures connections
- Message publisher → Message framing: writes headers
lib/src/main/java/stoufexis/jarpc/lib/common/Publisher.java - Generated server → Field encoding: encodes responses
generator/src/main/resources/template/server/SingleThreadedJarpcServer.java - Generated server → Field decoding: decodes requests
generator/src/main/resources/template/server/SingleThreadedJarpcServer.java - Server transport → Server state machine: drives state
lib/src/main/java/stoufexis/jarpc/lib/server/SingleThreadedJarpcServer.java - Server transport → Client image tracking: tracks images
lib/src/main/java/stoufexis/jarpc/lib/server/SingleThreadedJarpcServer.java - Server transport → Server publications: uses publications
lib/src/main/java/stoufexis/jarpc/lib/server/SingleThreadedJarpcServer.java - Server transport → Message framing: decodes headers
lib/src/main/java/stoufexis/jarpc/lib/server/SingleThreadedJarpcServer.java - Server transport → Aeron transport: receives messages