io.openmessaging.storage.dledger.statemachine

接口 StateMachine

public interface StateMachine

Finite state machine, which should be implemented by user.

方法概要

限定符和类型	方法和说明
default java.lang.String	generateDLedgerId(java.lang.String dLedgerGroupId, java.lang.String dLedgerSelfId) User must create DLedgerId by this method, it will generate the DLedgerId with format like that: 'dLedgerGroupId#dLedgerSelfId'
java.lang.String	getBindDLedgerId() User should return the DLedgerId which can be created by the method 'StateMachine#generateDLedgerId'
void	onApply(CommittedEntryIterator iter) Update the user statemachine with a batch a tasks that can be accessed through |iterator|.
void	onShutdown() Invoked once when the raft node was shut down.
boolean	onSnapshotLoad(SnapshotReader reader) User defined snapshot load function.
void	onSnapshotSave(SnapshotWriter writer, java.util.concurrent.CompletableFuture<java.lang.Boolean> done) User defined snapshot generate function, this method will block StateMachine#onApply(Iterator).

方法详细资料

onApply

void onApply(CommittedEntryIterator iter)

Update the user statemachine with a batch a tasks that can be accessed through |iterator|.

参数:

iter - iterator of committed entry

onSnapshotSave

void onSnapshotSave(SnapshotWriter writer,
                    java.util.concurrent.CompletableFuture<java.lang.Boolean> done)

User defined snapshot generate function, this method will block StateMachine#onApply(Iterator). Call done.run(status) when snapshot finished.

参数:

writer - snapshot writer

done - callback

onSnapshotLoad

boolean onSnapshotLoad(SnapshotReader reader)

User defined snapshot load function.

参数:

reader - snapshot reader

返回:

true on success

onShutdown

void onShutdown()

Invoked once when the raft node was shut down. Default do nothing

generateDLedgerId

default java.lang.String generateDLedgerId(java.lang.String dLedgerGroupId,
                                           java.lang.String dLedgerSelfId)

User must create DLedgerId by this method, it will generate the DLedgerId with format like that: 'dLedgerGroupId#dLedgerSelfId'

参数:

dLedgerGroupId - the group id of the DLedgerServer

dLedgerSelfId - the self id of the DLedgerServer

返回:

generated unique DLedgerId

getBindDLedgerId

java.lang.String getBindDLedgerId()

User should return the DLedgerId which can be created by the method 'StateMachine#generateDLedgerId'

返回:

DLedgerId