Skip to main content

Reference

The reference describes how oncebox works and every setting it exposes.

PageWhat it covers
Core ConceptsArchitecture, event lifecycle, batch capture, fencing, the database clock, background jobs
Delivery GuaranteesAt-least-once, effectively-once and at-most-once, duplicates, ordering, limitations
Publishing EventsOutboxPublisher, @OutboxPublish, transactions, serialization, event ids
Processing & ResilienceState machine, retries and backoff, stuck event recovery, cleanup
Dead Letter QueueDLQ state machine, transfer semantics, OutboxDlqHandler, REST API
InboxIdempotent consumers, choosing between them, cache, deserialization
Messaging IntegrationKafka and RabbitMQ senders, headers, routing, broker settings on both sides
PersistenceDatabases, dialect modules, table schemas, MySQL isolation level
Schema MigrationsCreating and upgrading the tables with Flyway, Liquibase or at startup
PollingFixed and adaptive strategies, thread pool sizing, distributed lock
ObservabilityMetrics and Grafana dashboards
ConfigurationEvery property with its default
Configuration RecipesReady configurations: several event types, RabbitMQ, production, inbox, both sides, local development