org.rocksdb

类 AbstractWriteBatch

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.AbstractWriteBatch

所有已实现的接口:

java.lang.AutoCloseable, WriteBatchInterface

直接已知子类:

WriteBatch, WriteBatchWithIndex

public abstract class AbstractWriteBatch
extends RocksObject
implements WriteBatchInterface

字段概要

从类继承的字段 org.rocksdb.RocksObject

nativeHandle_

从类继承的字段 org.rocksdb.AbstractImmutableNativeReference

owningHandle_

构造器概要

构造器

限定符	构造器和说明
protected	AbstractWriteBatch(long nativeHandle)

方法概要

限定符和类型	方法和说明
void	clear() Clear all updates buffered in this batch
int	count() Returns the number of updates in the batch.
void	delete(byte[] key) If the database contains a mapping for "key", erase it.
void	delete(java.nio.ByteBuffer key) If column family contains a mapping for "key", erase it.
void	delete(ColumnFamilyHandle columnFamilyHandle, byte[] key) If column family contains a mapping for "key", erase it.
void	delete(ColumnFamilyHandle columnFamilyHandle, java.nio.ByteBuffer key) If column family contains a mapping for "key", erase it.
void	deleteRange(byte[] beginKey, byte[] endKey) Removes the database entries in the range ["beginKey", "endKey"), i.e., including "beginKey" and excluding "endKey". a non-OK status on error.
void	deleteRange(ColumnFamilyHandle columnFamilyHandle, byte[] beginKey, byte[] endKey) Removes the database entries in the range ["beginKey", "endKey"), i.e., including "beginKey" and excluding "endKey". a non-OK status on error.
WriteBatch	getWriteBatch() Get the underlying Write Batch.
void	merge(byte[] key, byte[] value) Merge "value" with the existing value of "key" in the database.
void	merge(ColumnFamilyHandle columnFamilyHandle, byte[] key, byte[] value) Merge "value" with the existing value of "key" in given column family.
void	popSavePoint() Pop the most recent save point.
void	put(byte[] key, byte[] value) Store the mapping "key->value" in the database.
void	put(java.nio.ByteBuffer key, java.nio.ByteBuffer value) Store the mapping "key->value" within given column family.
void	put(ColumnFamilyHandle columnFamilyHandle, byte[] key, byte[] value) Store the mapping "key->value" within given column family.
void	put(ColumnFamilyHandle columnFamilyHandle, java.nio.ByteBuffer key, java.nio.ByteBuffer value) Store the mapping "key->value" within given column family.
void	putLogData(byte[] blob) Append a blob of arbitrary size to the records in this batch.
void	rollbackToSavePoint() Remove all entries in this batch (Put, Merge, Delete, PutLogData) since the most recent call to SetSavePoint() and removes the most recent save point.
void	setMaxBytes(long maxBytes) Set the maximum size of the write batch.
void	setSavePoint() Records the state of the batch for future calls to RollbackToSavePoint().
void	singleDelete(byte[] key) Remove the database entry for key.
void	singleDelete(ColumnFamilyHandle columnFamilyHandle, byte[] key) Remove the database entry for key.

从类继承的方法 org.rocksdb.RocksObject

disposeInternal, disposeInternal, getNativeHandle

从类继承的方法 org.rocksdb.AbstractImmutableNativeReference

close, disOwnNativeHandle, isOwningHandle

从类继承的方法 java.lang.Object

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

构造器详细资料

AbstractWriteBatch

protected AbstractWriteBatch(long nativeHandle)

方法详细资料

count

public int count()

从接口复制的说明: WriteBatchInterface

Returns the number of updates in the batch.

指定者:

count 在接口中 WriteBatchInterface

返回:

number of items in WriteBatch

put

public void put(byte[] key,
                byte[] value)
         throws RocksDBException

从接口复制的说明: WriteBatchInterface

Store the mapping "key->value" in the database.

指定者:

put 在接口中 WriteBatchInterface

参数:

key - the specified key to be inserted.

value - the value associated with the specified key.

抛出:

RocksDBException - thrown if error happens in underlying native library.

put

public void put(ColumnFamilyHandle columnFamilyHandle,
                byte[] key,
                byte[] value)
         throws RocksDBException

从接口复制的说明: WriteBatchInterface

Store the mapping "key->value" within given column family.

指定者:

put 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

key - the specified key to be inserted.

value - the value associated with the specified key.

抛出:

RocksDBException - thrown if error happens in underlying native library.

merge

public void merge(byte[] key,
                  byte[] value)
           throws RocksDBException

从接口复制的说明: WriteBatchInterface

Merge "value" with the existing value of "key" in the database. "key->merge(existing, value)"

指定者:

merge 在接口中 WriteBatchInterface

参数:

key - the specified key to be merged.

value - the value to be merged with the current value for the specified key.

抛出:

RocksDBException - thrown if error happens in underlying native library.

merge

public void merge(ColumnFamilyHandle columnFamilyHandle,
                  byte[] key,
                  byte[] value)
           throws RocksDBException

从接口复制的说明: WriteBatchInterface

Merge "value" with the existing value of "key" in given column family. "key->merge(existing, value)"

指定者:

merge 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

key - the specified key to be merged.

value - the value to be merged with the current value for the specified key.

抛出:

RocksDBException - thrown if error happens in underlying native library.

put

public void put(java.nio.ByteBuffer key,
                java.nio.ByteBuffer value)
         throws RocksDBException

从接口复制的说明: WriteBatchInterface

Store the mapping "key->value" within given column family.

指定者:

put 在接口中 WriteBatchInterface

参数:

key - the specified key to be inserted. It is using position and limit. Supports direct buffer only.

value - the value associated with the specified key. It is using position and limit. Supports direct buffer only.

抛出:

RocksDBException - thrown if error happens in underlying native library.

put

public void put(ColumnFamilyHandle columnFamilyHandle,
                java.nio.ByteBuffer key,
                java.nio.ByteBuffer value)
         throws RocksDBException

从接口复制的说明: WriteBatchInterface

Store the mapping "key->value" within given column family.

指定者:

put 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

key - the specified key to be inserted. It is using position and limit. Supports direct buffer only.

value - the value associated with the specified key. It is using position and limit. Supports direct buffer only.

抛出:

RocksDBException - thrown if error happens in underlying native library.

delete

public void delete(byte[] key)
            throws RocksDBException

从接口复制的说明: WriteBatchInterface

If the database contains a mapping for "key", erase it. Else do nothing.

指定者:

delete 在接口中 WriteBatchInterface

参数:

key - Key to delete within database

抛出:

RocksDBException - thrown if error happens in underlying native library.

delete

public void delete(ColumnFamilyHandle columnFamilyHandle,
                   byte[] key)
            throws RocksDBException

从接口复制的说明: WriteBatchInterface

If column family contains a mapping for "key", erase it. Else do nothing.

指定者:

delete 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

key - Key to delete within database

抛出:

RocksDBException - thrown if error happens in underlying native library.

delete

public void delete(java.nio.ByteBuffer key)
            throws RocksDBException

从接口复制的说明: WriteBatchInterface

If column family contains a mapping for "key", erase it. Else do nothing.

指定者:

delete 在接口中 WriteBatchInterface

参数:

key - Key to delete within database. It is using position and limit. Supports direct buffer only.

抛出:

RocksDBException - thrown if error happens in underlying native library.

delete

public void delete(ColumnFamilyHandle columnFamilyHandle,
                   java.nio.ByteBuffer key)
            throws RocksDBException

从接口复制的说明: WriteBatchInterface

If column family contains a mapping for "key", erase it. Else do nothing.

指定者:

delete 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

key - Key to delete within database. It is using position and limit. Supports direct buffer only.

抛出:

RocksDBException - thrown if error happens in underlying native library.

singleDelete

public void singleDelete(byte[] key)
                  throws RocksDBException

从接口复制的说明: WriteBatchInterface

Remove the database entry for key. Requires that the key exists and was not overwritten. It is not an error if the key did not exist in the database.

If a key is overwritten (by calling WriteBatchInterface.put(byte[], byte[]) multiple times), then the result of calling SingleDelete() on this key is undefined. SingleDelete() only behaves correctly if there has been only one Put() for this key since the previous call to SingleDelete() for this key.

This feature is currently an experimental performance optimization for a very specific workload. It is up to the caller to ensure that SingleDelete is only used for a key that is not deleted using Delete() or written using Merge(). Mixing SingleDelete operations with Deletes and Merges can result in undefined behavior.

指定者:

singleDelete 在接口中 WriteBatchInterface

参数:

key - Key to delete within database

抛出:

RocksDBException - thrown if error happens in underlying native library.

singleDelete

public void singleDelete(ColumnFamilyHandle columnFamilyHandle,
                         byte[] key)
                  throws RocksDBException

从接口复制的说明: WriteBatchInterface

Remove the database entry for key. Requires that the key exists and was not overwritten. It is not an error if the key did not exist in the database.

If a key is overwritten (by calling WriteBatchInterface.put(byte[], byte[]) multiple times), then the result of calling SingleDelete() on this key is undefined. SingleDelete() only behaves correctly if there has been only one Put() for this key since the previous call to SingleDelete() for this key.

This feature is currently an experimental performance optimization for a very specific workload. It is up to the caller to ensure that SingleDelete is only used for a key that is not deleted using Delete() or written using Merge(). Mixing SingleDelete operations with Deletes and Merges can result in undefined behavior.

指定者:

singleDelete 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - The column family to delete the key from

key - Key to delete within database

抛出:

RocksDBException - thrown if error happens in underlying native library.

deleteRange

public void deleteRange(byte[] beginKey,
                        byte[] endKey)
                 throws RocksDBException

从接口复制的说明: WriteBatchInterface

Removes the database entries in the range ["beginKey", "endKey"), i.e., including "beginKey" and excluding "endKey". a non-OK status on error. It is not an error if no keys exist in the range ["beginKey", "endKey").

Delete the database entry (if any) for "key". Returns OK on success, and a non-OK status on error. It is not an error if "key" did not exist in the database.

指定者:

deleteRange 在接口中 WriteBatchInterface

参数:

beginKey - First key to delete within database (included)

endKey - Last key to delete within database (excluded)

抛出:

RocksDBException - thrown if error happens in underlying native library.

deleteRange

public void deleteRange(ColumnFamilyHandle columnFamilyHandle,
                        byte[] beginKey,
                        byte[] endKey)
                 throws RocksDBException

从接口复制的说明: WriteBatchInterface

Removes the database entries in the range ["beginKey", "endKey"), i.e., including "beginKey" and excluding "endKey". a non-OK status on error. It is not an error if no keys exist in the range ["beginKey", "endKey").

Delete the database entry (if any) for "key". Returns OK on success, and a non-OK status on error. It is not an error if "key" did not exist in the database.

指定者:

deleteRange 在接口中 WriteBatchInterface

参数:

columnFamilyHandle - ColumnFamilyHandle instance

beginKey - First key to delete within database (included)

endKey - Last key to delete within database (excluded)

抛出:

RocksDBException - thrown if error happens in underlying native library.

putLogData

public void putLogData(byte[] blob)
                throws RocksDBException

从接口复制的说明: WriteBatchInterface

Append a blob of arbitrary size to the records in this batch. The blob will be stored in the transaction log but not in any other file. In particular, it will not be persisted to the SST files. When iterating over this WriteBatch, WriteBatch::Handler::LogData will be called with the contents of the blob as it is encountered. Blobs, puts, deletes, and merges will be encountered in the same order in which they were inserted. The blob will NOT consume sequence number(s) and will NOT increase the count of the batch

Example application: add timestamps to the transaction log for use in replication.

指定者:

putLogData 在接口中 WriteBatchInterface

参数:

blob - binary object to be inserted

抛出:

RocksDBException - thrown if error happens in underlying native library.

clear

public void clear()

从接口复制的说明: WriteBatchInterface

Clear all updates buffered in this batch

指定者:

clear 在接口中 WriteBatchInterface

setSavePoint

public void setSavePoint()

从接口复制的说明: WriteBatchInterface

Records the state of the batch for future calls to RollbackToSavePoint(). May be called multiple times to set multiple save points.

指定者:

setSavePoint 在接口中 WriteBatchInterface

rollbackToSavePoint

public void rollbackToSavePoint()
                         throws RocksDBException

从接口复制的说明: WriteBatchInterface

Remove all entries in this batch (Put, Merge, Delete, PutLogData) since the most recent call to SetSavePoint() and removes the most recent save point.

指定者:

rollbackToSavePoint 在接口中 WriteBatchInterface

抛出:

RocksDBException - if there is no previous call to SetSavePoint()

popSavePoint

public void popSavePoint()
                  throws RocksDBException

从接口复制的说明: WriteBatchInterface

Pop the most recent save point.

That is to say that it removes the last save point, which was set by WriteBatchInterface.setSavePoint().

指定者:

popSavePoint 在接口中 WriteBatchInterface

抛出:

RocksDBException - If there is no previous call to WriteBatchInterface.setSavePoint(), an exception with Status.Code.NotFound will be thrown.

setMaxBytes

public void setMaxBytes(long maxBytes)

从接口复制的说明: WriteBatchInterface

Set the maximum size of the write batch.

指定者:

setMaxBytes 在接口中 WriteBatchInterface

参数:

maxBytes - the maximum size in bytes.

getWriteBatch

public WriteBatch getWriteBatch()

从接口复制的说明: WriteBatchInterface

Get the underlying Write Batch.

指定者:

getWriteBatch 在接口中 WriteBatchInterface

返回:

the underlying WriteBatch.