RocksDBLogStorage (jraft-core 1.3.8 1.3.8 API)

java.lang.Object
- com.alipay.sofa.jraft.storage.impl.RocksDBLogStorage

所有已实现的接口:

Lifecycle<LogStorageOptions>, LogStorage, Storage, Describer

直接已知子类:

RocksDBSegmentLogStorage
```
public class RocksDBLogStorage
extends Object
implements LogStorage, Describer
```
Log storage based on rocksdb.

作者:

boyan (boyan@alibaba-inc.com) 2018-Apr-06 7:27:47 AM

嵌套类概要

嵌套类
限定符和类型	类和说明
`protected static class`	`RocksDBLogStorage.EmptyWriteContext` An empty write context
`static interface`	`RocksDBLogStorage.WriteContext` A write context

从接口继承的嵌套类/接口 com.alipay.sofa.jraft.util.Describer
Describer.DefaultPrinter, Describer.Printer

字段概要

字段
限定符和类型字段和说明

static byte[] FIRST_LOG_IDX_KEY
First log index and last log index key in configuration column family.

字段
限定符和类型	字段和说明
`static byte[]`	`FIRST_LOG_IDX_KEY` First log index and last log index key in configuration column family.

构造器概要

构造器
构造器和说明

RocksDBLogStorage(String path, RaftOptions raftOptions)

构造器
构造器和说明
`RocksDBLogStorage(String path, RaftOptions raftOptions)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`int`	`appendEntries(List<LogEntry> entries)` Append entries to log, return append success number.
`boolean`	`appendEntry(LogEntry entry)` Append entries to log.
`static org.rocksdb.ColumnFamilyOptions`	`createColumnFamilyOptions()`
`static org.rocksdb.DBOptions`	`createDBOptions()`
`void`	`describe(Describer.Printer out)`
`LogEntry`	`getEntry(long index)` Get logEntry by index.
`long`	`getFirstLogIndex()` Returns first log index in log.
`protected byte[]`	`getKeyBytes(long index)`
`long`	`getLastLogIndex()` Returns last log index in log.
`long`	`getTerm(long index)` Get logEntry's term by index.
`protected byte[]`	`getValueFromRocksDB(byte[] keyBytes)`
`boolean`	`init(LogStorageOptions opts)` Initialize the service.
`protected boolean`	`isSync()`
`protected RocksDBLogStorage.WriteContext`	`newWriteContext()`
`protected byte[]`	`onDataAppend(long logIndex, byte[] value, RocksDBLogStorage.WriteContext ctx)` Called before appending data entry.
`protected byte[]`	`onDataGet(long logIndex, byte[] value)` Called after getting data from rocksdb.
`protected boolean`	`onInitLoaded()` Called after opening RocksDB and loading configuration into conf manager.
`protected void`	`onReset(long nextLogIndex)` Called after resetting db.
`protected void`	`onShutdown()` Called after closing db.
`protected void`	`onSync()` Called when sync data into file system.
`protected void`	`onTruncatePrefix(long startIndex, long firstIndexKept)` Called after truncating prefix logs in rocksdb.
`protected void`	`onTruncateSuffix(long lastIndexKept)` Called after truncating suffix logs in rocksdb.
`boolean`	`reset(long nextLogIndex)` Drop all the existing logs and reset next log index to \|next_log_index\|.
`void`	`shutdown()` Dispose the resources for service.
`boolean`	`truncatePrefix(long firstIndexKept)` Delete logs from storage's head, [first_log_index, first_index_kept) will be discarded.
`boolean`	`truncateSuffix(long lastIndexKept)` Delete uncommitted logs from storage's tail, (last_index_kept, last_log_index] will be discarded.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - FIRST_LOG_IDX_KEY
```
public static final byte[] FIRST_LOG_IDX_KEY
```
    First log index and last log index key in configuration column family.
- 构造器详细资料
  - RocksDBLogStorage
```
public RocksDBLogStorage(String path,
                         RaftOptions raftOptions)
```
- 方法详细资料
  - createDBOptions
```
public static org.rocksdb.DBOptions createDBOptions()
```
  - createColumnFamilyOptions
```
public static org.rocksdb.ColumnFamilyOptions createColumnFamilyOptions()
```
  - init
```
public boolean init(LogStorageOptions opts)
```
    从接口复制的说明: Lifecycle
    
    Initialize the service.
    
    指定者:
    
    init 在接口中 Lifecycle<LogStorageOptions>
    
    返回:
    
    true when successes.
  - shutdown
```
public void shutdown()
```
    从接口复制的说明: Lifecycle
    
    Dispose the resources for service.
    
    指定者:
    
    shutdown 在接口中 Lifecycle<LogStorageOptions>
  - getFirstLogIndex
```
public long getFirstLogIndex()
```
    从接口复制的说明: LogStorage
    
    Returns first log index in log.
    
    指定者:
    
    getFirstLogIndex 在接口中 LogStorage
  - getLastLogIndex
```
public long getLastLogIndex()
```
    从接口复制的说明: LogStorage
    
    Returns last log index in log.
    
    指定者:
    
    getLastLogIndex 在接口中 LogStorage
  - getEntry
```
public LogEntry getEntry(long index)
```
    从接口复制的说明: LogStorage
    
    Get logEntry by index.
    
    指定者:
    
    getEntry 在接口中 LogStorage
  - getValueFromRocksDB
```
protected byte[] getValueFromRocksDB(byte[] keyBytes)
                              throws org.rocksdb.RocksDBException
```
    抛出:
    
    org.rocksdb.RocksDBException
  - getKeyBytes
```
protected byte[] getKeyBytes(long index)
```
  - getTerm
```
public long getTerm(long index)
```
    从接口复制的说明: LogStorage
    
    Get logEntry's term by index. This method is deprecated, you should use LogStorage.getEntry(long) to get the log id's term.
    
    指定者:
    
    getTerm 在接口中 LogStorage
  - appendEntry
```
public boolean appendEntry(LogEntry entry)
```
    从接口复制的说明: LogStorage
    
    Append entries to log.
    
    指定者:
    
    appendEntry 在接口中 LogStorage
  - appendEntries
```
public int appendEntries(List<LogEntry> entries)
```
    从接口复制的说明: LogStorage
    
    Append entries to log, return append success number.
    
    指定者:
    
    appendEntries 在接口中 LogStorage
  - truncatePrefix
```
public boolean truncatePrefix(long firstIndexKept)
```
    从接口复制的说明: LogStorage
    
    Delete logs from storage's head, [first_log_index, first_index_kept) will be discarded.
    
    指定者:
    
    truncatePrefix 在接口中 LogStorage
  - truncateSuffix
```
public boolean truncateSuffix(long lastIndexKept)
```
    从接口复制的说明: LogStorage
    
    Delete uncommitted logs from storage's tail, (last_index_kept, last_log_index] will be discarded.
    
    指定者:
    
    truncateSuffix 在接口中 LogStorage
  - reset
```
public boolean reset(long nextLogIndex)
```
    从接口复制的说明: LogStorage
    
    Drop all the existing logs and reset next log index to |next_log_index|. This function is called after installing snapshot from leader.
    
    指定者:
    
    reset 在接口中 LogStorage
  - onInitLoaded
```
protected boolean onInitLoaded()
```
    Called after opening RocksDB and loading configuration into conf manager.
  - onShutdown
```
protected void onShutdown()
```
    Called after closing db.
  - onReset
```
protected void onReset(long nextLogIndex)
```
    Called after resetting db.
    
    参数:
    
    nextLogIndex - next log index
  - onTruncatePrefix
```
protected void onTruncatePrefix(long startIndex,
                                long firstIndexKept)
                         throws org.rocksdb.RocksDBException,
                                IOException
```
    Called after truncating prefix logs in rocksdb.
    
    参数:
    
    startIndex - the start index
    
    firstIndexKept - the first index to kept
    
    抛出:
    
    org.rocksdb.RocksDBException
    
    IOException
  - onSync
```
protected void onSync()
               throws IOException,
                      InterruptedException
```
    Called when sync data into file system.
    
    抛出:
    
    IOException
    
    InterruptedException
  - isSync
```
protected boolean isSync()
```
  - onTruncateSuffix
```
protected void onTruncateSuffix(long lastIndexKept)
                         throws org.rocksdb.RocksDBException,
                                IOException
```
    Called after truncating suffix logs in rocksdb.
    
    参数:
    
    lastIndexKept - the last index to kept
    
    抛出:
    
    org.rocksdb.RocksDBException
    
    IOException
  - newWriteContext
```
protected RocksDBLogStorage.WriteContext newWriteContext()
```
  - onDataAppend
```
protected byte[] onDataAppend(long logIndex,
                              byte[] value,
                              RocksDBLogStorage.WriteContext ctx)
                       throws IOException,
                              InterruptedException
```
    Called before appending data entry.
    
    参数:
    
    logIndex - the log index
    
    value - the data value in log entry.
    
    返回:
    
    the new value
    
    抛出:
    
    IOException
    
    InterruptedException
  - onDataGet
```
protected byte[] onDataGet(long logIndex,
                           byte[] value)
                    throws IOException
```
    Called after getting data from rocksdb.
    
    参数:
    
    logIndex - the log index
    
    value - the value in rocksdb
    
    返回:
    
    the new value
    
    抛出:
    
    IOException
  - describe
```
public void describe(Describer.Printer out)
```
    指定者:
    
    describe 在接口中 Describer

类 RocksDBLogStorage

嵌套类概要

从接口继承的嵌套类/接口 com.alipay.sofa.jraft.util.Describer

字段概要

构造器概要

方法概要

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

字段详细资料

FIRST_LOG_IDX_KEY

构造器详细资料

RocksDBLogStorage

方法详细资料

createDBOptions

createColumnFamilyOptions

init

shutdown

getFirstLogIndex

getLastLogIndex

getEntry

getValueFromRocksDB

getKeyBytes

getTerm

appendEntry

appendEntries

truncatePrefix

truncateSuffix

reset

onInitLoaded

onShutdown

onReset

onTruncatePrefix

onSync

isSync

onTruncateSuffix

newWriteContext

onDataAppend

onDataGet

describe