Interface BatchedStorageWriter
- All Known Implementing Classes:
AbstractStorageEngine, TagHistoryStorageEngineBridge
public interface BatchedStorageWriter
Capability of a storage engine that accepts pre-coalesced batches of temporal points and writes
them directly, bypassing the debounce or coalesce queue used for realtime arrivals. Engines opt
in through
StorageEngine.batchWriter(); callers that already batched their points, such
as bulk ingest, should prefer it.
Contract
- The writer honors the
TemporalPointBatchas given, never merging it with other submissions, so the returnedCompletionStagereflects this submission alone. - Only the pre-storage queueing is skipped: metrics, availability checks and the wrapping decorators' cross-cuts still apply.
StorageResult.failedData()reports per-point failures asStorageEngine.storeAtomic(List)does.- Implementations are thread-safe; concurrent submissions are permitted.
- Since:
- 2027.02
-
Method Summary
Modifier and TypeMethodDescription<P extends TemporalPoint<?,?>>
CompletionStage<StorageResult<P>> writeBatch(TemporalPointBatch<P> batch) Writes a pre-coalesced batch directly, bypassing anyPointStorageStrategydebounce queue.
-
Method Details
-
writeBatch
<P extends TemporalPoint<?,?>> CompletionStage<StorageResult<P>> writeBatch(TemporalPointBatch<P> batch) Writes a pre-coalesced batch directly, bypassing anyPointStorageStrategydebounce queue.- Type Parameters:
P- the temporal-point subtype of the batch- Parameters:
batch- the batch to write; non-null and non-empty- Returns:
- a stage resolving to the outcome for this batch
-