org.apache.ratis.statemachine

接口 TransactionContext

public interface TransactionContext

Context for a transaction. The transaction might have originated from a client request, or it maybe coming from another replica of the state machine through the RAFT log. TransactionContext can be created from either the StateMachine or the state machine updater. In the first case, the StateMachine is a leader. When it receives a StateMachine.startTransaction(RaftClientRequest) request, it returns a TransactionContext with the changes from the StateMachine. The same context will be passed back to the StateMachine via the StateMachine.applyTransaction(TransactionContext) call. In the second case, the StateMachine is a follower. The TransactionContext will be a committed entry coming from the RAFT log from the leader.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	TransactionContext.Builder

方法概要

限定符和类型	方法和说明
TransactionContext	cancelTransaction() Called to notify the state machine that the Transaction passed cannot be appended (or synced).
RaftClientRequest	getClientRequest() Returns the original request from the RaftClientRequest
Exception	getException() Returns the exception from the StateMachine or the log
org.apache.ratis.proto.RaftProtos.LogEntryProto	getLogEntry() Returns the committed log entry
org.apache.ratis.proto.RaftProtos.RaftPeerRole	getServerRole()
Object	getStateMachineContext() Returns the StateMachine the current TransactionContext specific to
org.apache.ratis.proto.RaftProtos.StateMachineLogEntryProto	getStateMachineLogEntry() Returns the data from the StateMachine
org.apache.ratis.proto.RaftProtos.LogEntryProto	initLogEntry(long term, long index) Initialize RaftProtos.LogEntryProto using the internal RaftProtos.StateMachineLogEntryProto.
static TransactionContext.Builder	newBuilder()
TransactionContext	preAppendTransaction() This is called before the transaction passed from the StateMachine is appended to the raft log.
TransactionContext	setException(Exception exception) Set exception in case of failure.
TransactionContext	setShouldCommit(boolean shouldCommit) Sets whether to commit the transaction to the RAFT log or not
TransactionContext	setStateMachineContext(Object stateMachineContext) Sets the StateMachine the TransactionContext is specific to, the method would not create a new transaction context, it updates the StateMachine it associates with
boolean	shouldCommit() It indicates if the transaction should be committed to the RAFT log

方法详细资料

getServerRole

org.apache.ratis.proto.RaftProtos.RaftPeerRole getServerRole()

返回:

the role of the server when this context is created.

getClientRequest

RaftClientRequest getClientRequest()

Returns the original request from the RaftClientRequest

返回:

the original request from the RaftClientRequest

getStateMachineLogEntry

org.apache.ratis.proto.RaftProtos.StateMachineLogEntryProto getStateMachineLogEntry()

Returns the data from the StateMachine

返回:

the data from the StateMachine

setException

TransactionContext setException(Exception exception)

Set exception in case of failure.

getException

Exception getException()

Returns the exception from the StateMachine or the log

返回:

the exception from the StateMachine or the log

setStateMachineContext

TransactionContext setStateMachineContext(Object stateMachineContext)

Sets the StateMachine the TransactionContext is specific to, the method would not create a new transaction context, it updates the StateMachine it associates with

参数:

stateMachineContext - state machine context

返回:

transaction context specific to the given StateMachine

getStateMachineContext

Object getStateMachineContext()

Returns the StateMachine the current TransactionContext specific to

返回:

the StateMachine the current TransactionContext specific to

initLogEntry

org.apache.ratis.proto.RaftProtos.LogEntryProto initLogEntry(long term,
                                                             long index)

Initialize RaftProtos.LogEntryProto using the internal RaftProtos.StateMachineLogEntryProto.

参数:

term - The current term.

index - The index of the log entry.

返回:

the result RaftProtos.LogEntryProto

getLogEntry

org.apache.ratis.proto.RaftProtos.LogEntryProto getLogEntry()

Returns the committed log entry

返回:

the committed log entry

setShouldCommit

TransactionContext setShouldCommit(boolean shouldCommit)

Sets whether to commit the transaction to the RAFT log or not

参数:

shouldCommit - true if the transaction is supposed to be committed to the RAFT log

返回:

the current TransactionContext itself

shouldCommit

boolean shouldCommit()

It indicates if the transaction should be committed to the RAFT log

返回:

true if it commits the transaction to the RAFT log, otherwise, false

preAppendTransaction

TransactionContext preAppendTransaction()
                                 throws IOException

This is called before the transaction passed from the StateMachine is appended to the raft log. This method will be called from log append and having the same strict serial order that the Transactions will have in the RAFT log. Since this is called serially in the critical path of log append, it is important to do only required operations here.

返回:

The Transaction context.

抛出:

IOException

cancelTransaction

TransactionContext cancelTransaction()
                              throws IOException

Called to notify the state machine that the Transaction passed cannot be appended (or synced). The exception field will indicate whether there was an exception or not.

返回:

cancelled transaction

抛出:

IOException

newBuilder

static TransactionContext.Builder newBuilder()