Symbio (Reactive Storage)

The VLINGO XOOM Reactive CQRS and Event Sourcing storage and projections.

What Is Symbio?

The idea behind the name "symbio" is that there is a symbiotic relationship between domain models and persistence, and persistence and domain models. They depend on each other, but in a way that neither "life form" may be entirely conscious of the other. This is certainly true of the domain model more so than the data model.

The XOOM Symbio parent tool is a set of protocols and default in-memory implementations. The protocols are usable by concrete implementations. The in-memory implementations are useful for testing.

There are three primary kinds of storage mechanism protocols available: ObjectStore, StateStore (i.e. Key-Value and NoSQL), and Journal. Among these there are a number of concrete implementations. For example, there are Postgres implementations of all three: ObjectStore, StateStore, and Journal.

An important point to consider is, if you use the XOOM Lattice entity types, there is no need to learn the operations of the storage types. You get all storage persistence for free when you use one of ObjectEntity, StatefulEntity, and EventSourced.

Each storage type is discussed in the following subsections. Additionally there is a separate useful discussion about Adapters, which are used to translate between application or service state and persistent state.




An object storage in which StateObject instances are self defined, including their identity. This is often thought of as object-relational mapping, which certainly can be and is supported, but is not limited to such.


The basic state storage protocol in which StateObject instances are persisted as key-value tuples, with CLOB/BLOB values. This is used as a NoSQL database, but may use an RDBMS as the storage engine.


Used within a Bounded Context (microservice) to store DomainEvent and Command instances. Each use of the Journal appends some number of Entry instances, which are serialized DomainEvent and Command instances, and perhaps State snapshots.


Used to roundtrip translate between service/application state and storage state.