Package tech.ydb.yoj.repository.ydb

Class YdbSpliterator<V>

java.lang.Object

tech.ydb.yoj.repository.ydb.YdbSpliterator<V>

All Implemented Interfaces:

Spliterator<V>

public class YdbSpliterator<V>
extends Object
implements Spliterator<V>

YdbSpliterator used to read data from YDB streams. It's possible to supply values from different threads, but supplier threads must not call onNext() concurrently. This Spliterator should be explicitly closed by the close() method for finish work in YDB session; when the stream returned by readTable() is used inside a YOJ transaction, close() will be called automatically at transaction end (both commit and rollback).

To use the new implementation, set ReadTableParams<...>.builder().<...>.useNewSpliterator(true).

Note that using the new implementation currently has a negative performance impact, for more information refer to GitHub Issue #42.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	YdbSpliterator.ConsumerDoneException

Nested classes/interfaces inherited from interface java.util.Spliterator

Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfPrimitive<T extends Object,T_CONS extends Object,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

Field Summary

Fields inherited from interface java.util.Spliterator

CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED

Constructor Summary

Constructors

Modifier	Constructor	Description
	YdbSpliterator(String request, boolean isOrdered)
protected	YdbSpliterator(String request, boolean isOrdered, Duration streamWorkTimeout)

Method Summary

Modifier and Type	Method	Description
int	characteristics()
void	close()
Stream<V>	createStream()
long	estimateSize()
long	getExactSizeIfKnown()
void	onNext(V value)
void	onSupplierThreadComplete(tech.ydb.core.Status status, Throwable ex)
boolean	tryAdvance(Consumer<? super V> action)
Spliterator<V>	trySplit()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Spliterator

forEachRemaining, getComparator, hasCharacteristics

Constructor Details

YdbSpliterator

public YdbSpliterator(String request,
 boolean isOrdered)

YdbSpliterator

protected YdbSpliterator(String request,
 boolean isOrdered,
 Duration streamWorkTimeout)

Method Details

createStream

public Stream<V> createStream()

onNext

public void onNext(V value)

onSupplierThreadComplete

public void onSupplierThreadComplete(tech.ydb.core.Status status,
 Throwable ex)

tryAdvance

public boolean tryAdvance(Consumer<? super V> action)

Specified by:

tryAdvance in interface Spliterator<V>

close

public void close()

trySplit

public Spliterator<V> trySplit()

Specified by:

trySplit in interface Spliterator<V>

estimateSize

public long estimateSize()

Specified by:

estimateSize in interface Spliterator<V>

getExactSizeIfKnown

public long getExactSizeIfKnown()

Specified by:

getExactSizeIfKnown in interface Spliterator<V>

characteristics

public int characteristics()

Specified by:

characteristics in interface Spliterator<V>