org.jsimpledb.kv.spanner

Class ReadWriteSpannerView

java.lang.Object

org.jsimpledb.kv.AbstractKVStore

org.jsimpledb.kv.mvcc.MutableView

org.jsimpledb.kv.spanner.ReadWriteSpannerView

All Implemented Interfaces:

Closeable, AutoCloseable, Cloneable, CloseableKVStore, KVStore

public class ReadWriteSpannerView
extends MutableView
implements CloseableKVStore

Provides a mutable KVStore view of a ReadContext.

For best performance, supply an ExecutorService for asynchronous batch loading.

Use bufferMutations() to transfer outstanding mutations into a TransactionContext.

See Also:

ReadOnlySpannerView, BatchingKVStore

Field Summary

Fields

Modifier and Type	Field and Description
protected Function<? super SpannerException,RuntimeException>	exceptionMapper
protected Logger	log
protected String	tableName

Constructor Summary

Constructors

Constructor and Description
ReadWriteSpannerView(String tableName, ReadContext context, Function<? super SpannerException,RuntimeException> exceptionMapper) Constructor for when no batching is desired.
ReadWriteSpannerView(String tableName, ReadContext context, Function<? super SpannerException,RuntimeException> exceptionMapper, ExecutorService executor, int rttEstimate) Constructor for when batching is desired.

Method Summary

Modifier and Type	Method and Description
void	bufferMutations(TransactionContext context) Atomically transfer all of the outstanding mutations associated with this instance into the given transaction context, and then clear them.
ReadWriteSpannerView	clone()
void	close() Close the associated ReadContext.

Methods inherited from class org.jsimpledb.kv.mvcc.MutableView

adjustCounter, decodeCounter, disableReadTracking, encodeCounter, get, getKVStore, getRange, getReads, getWrites, put, remove, removeRange, setKVStore, setReadOnly, toString

Methods inherited from class org.jsimpledb.kv.AbstractKVStore

getAtLeast, getAtMost

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jsimpledb.kv.KVStore

adjustCounter, decodeCounter, encodeCounter, get, getAtLeast, getAtMost, getRange, getRange, getRange, put, remove, removeRange

Field Detail

log

protected final Logger log

tableName

protected final String tableName

exceptionMapper

protected final Function<? super SpannerException,RuntimeException> exceptionMapper

Constructor Detail

ReadWriteSpannerView

public ReadWriteSpannerView(String tableName,
                            ReadContext context,
                            Function<? super SpannerException,RuntimeException> exceptionMapper)

Constructor for when no batching is desired.

Parameters:

tableName - name of the Spanner database table

context - read context

exceptionMapper - mapper for any thrown SpannerExceptions, or null for none

Throws:

IllegalArgumentException - if tableName or context is null

ReadWriteSpannerView

public ReadWriteSpannerView(String tableName,
                            ReadContext context,
                            Function<? super SpannerException,RuntimeException> exceptionMapper,
                            ExecutorService executor,
                            int rttEstimate)

Constructor for when batching is desired.

Parameters:

tableName - name of the Spanner database table

context - read context

exceptionMapper - mapper for any thrown SpannerExceptions, or null for none

executor - asynchronous load task executor

rttEstimate - initial RTT estimate in milliseconds

Throws:

IllegalArgumentException - if tableName, context or executor is null

Method Detail

bufferMutations

public void bufferMutations(TransactionContext context)

Atomically transfer all of the outstanding mutations associated with this instance into the given transaction context, and then clear them.

Parameters:

context - transaction context

Throws:

IllegalArgumentException - if context is null

clone

public ReadWriteSpannerView clone()

Overrides:

clone in class MutableView

close

public void close()

Close the associated ReadContext.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface CloseableKVStore