org.apache.pekko.persistence.r2dbc.query.scaladsl
R2dbcReadJournal
Companion object R2dbcReadJournal
final class R2dbcReadJournal extends ReadJournal with CurrentEventsBySliceQuery with EventsBySliceQuery with EventTimestampQuery with LoadEventQuery with CurrentEventsByPersistenceIdQuery with EventsByPersistenceIdQuery with CurrentPersistenceIdsQuery with PagedPersistenceIdsQuery
- Alphabetic
- By Inheritance
- R2dbcReadJournal
- PagedPersistenceIdsQuery
- CurrentPersistenceIdsQuery
- EventsByPersistenceIdQuery
- CurrentEventsByPersistenceIdQuery
- LoadEventQuery
- EventTimestampQuery
- EventsBySliceQuery
- CurrentEventsBySliceQuery
- ReadJournal
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Instance Constructors
- new R2dbcReadJournal(system: ExtendedActorSystem, config: Config, cfgPath: String)
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- def currentEventsByPersistenceId(persistenceId: String, fromSequenceNr: Long, toSequenceNr: Long): Source[EventEnvelope, NotUsed]
- Definition Classes
- R2dbcReadJournal → CurrentEventsByPersistenceIdQuery
- def currentEventsBySlices[Event](entityType: String, minSlice: Int, maxSlice: Int, offset: Offset): Source[EventEnvelope[Event], NotUsed]
- Definition Classes
- R2dbcReadJournal → CurrentEventsBySliceQuery
- def currentPersistenceIds(): Source[String, NotUsed]
- Definition Classes
- R2dbcReadJournal → CurrentPersistenceIdsQuery
- def currentPersistenceIds(afterId: Option[String], limit: Long): Source[String, NotUsed]
- Definition Classes
- R2dbcReadJournal → PagedPersistenceIdsQuery
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def eventsByPersistenceId(persistenceId: String, fromSequenceNr: Long, toSequenceNr: Long): Source[EventEnvelope, NotUsed]
- Definition Classes
- R2dbcReadJournal → EventsByPersistenceIdQuery
- def eventsBySlices[Event](entityType: String, minSlice: Int, maxSlice: Int, offset: Offset): Source[EventEnvelope[Event], NotUsed]
Query events for given slices.
Query events for given slices. A slice is deterministically defined based on the persistence id. The purpose is to evenly distribute all persistence ids over the slices.
The consumer can keep track of its current position in the event stream by storing the
offset
and restart the query from a givenoffset
after a crash/restart.The supported offset is TimestampOffset and Offset.noOffset.
The timestamp is based on the database
transaction_timestamp()
when the event was stored.transaction_timestamp()
is the time when the transaction started, not when it was committed. This means that a "later" event may be visible first and when retrieving events after the previously seen timestamp we may miss some events. In distributed SQL databases there can also be clock skews for the database timestamps. For that reason it will perform additional backtracking queries to catch missed events. Events from backtracking will typically be duplicates of previously emitted events. It's the responsibility of the consumer to filter duplicates and make sure that events are processed in exact sequence number order for each persistence id. Such deduplication is provided by the R2DBC Projection.Events emitted by the backtracking don't contain the event payload (
EventBySliceEnvelope.event
is None) and the consumer can load the fullEventBySliceEnvelope
with R2dbcReadJournal.loadEnvelope.The events will be emitted in the timestamp order with the caveat of duplicate events as described above. Events with the same timestamp are ordered by sequence number.
The stream is not completed when it reaches the end of the currently stored events, but it continues to push new events when new events are persisted. Corresponding query that is completed when it reaches the end of the currently stored events is provided by R2dbcReadJournal.currentEventsBySlices.
- Definition Classes
- R2dbcReadJournal → EventsBySliceQuery
- def extractEntityTypeFromPersistenceId(persistenceId: String): String
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- def loadEnvelope[Event](persistenceId: String, sequenceNr: Long): Future[EventEnvelope[Event]]
- Definition Classes
- R2dbcReadJournal → LoadEventQuery
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- def sliceForPersistenceId(persistenceId: String): Int
- Definition Classes
- R2dbcReadJournal → EventsBySliceQuery → CurrentEventsBySliceQuery
- def sliceRanges(numberOfRanges: Int): Seq[Range]
- Definition Classes
- R2dbcReadJournal → EventsBySliceQuery → CurrentEventsBySliceQuery
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def timestampOf(persistenceId: String, sequenceNr: Long): Future[Option[Instant]]
- Definition Classes
- R2dbcReadJournal → EventTimestampQuery
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()