You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.4 KiB
Go
41 lines
1.4 KiB
Go
7 years ago
|
package raft
|
||
|
|
||
|
import (
|
||
|
"io"
|
||
|
)
|
||
|
|
||
|
// FSM provides an interface that can be implemented by
|
||
|
// clients to make use of the replicated log.
|
||
|
type FSM interface {
|
||
|
// Apply log is invoked once a log entry is committed.
|
||
|
// It returns a value which will be made available in the
|
||
|
// ApplyFuture returned by Raft.Apply method if that
|
||
|
// method was called on the same Raft node as the FSM.
|
||
|
Apply(*Log) interface{}
|
||
|
|
||
|
// Snapshot is used to support log compaction. This call should
|
||
|
// return an FSMSnapshot which can be used to save a point-in-time
|
||
|
// snapshot of the FSM. Apply and Snapshot are not called in multiple
|
||
|
// threads, but Apply will be called concurrently with Persist. This means
|
||
|
// the FSM should be implemented in a fashion that allows for concurrent
|
||
|
// updates while a snapshot is happening.
|
||
|
Snapshot() (FSMSnapshot, error)
|
||
|
|
||
|
// Restore is used to restore an FSM from a snapshot. It is not called
|
||
|
// concurrently with any other command. The FSM must discard all previous
|
||
|
// state.
|
||
|
Restore(io.ReadCloser) error
|
||
|
}
|
||
|
|
||
|
// FSMSnapshot is returned by an FSM in response to a Snapshot
|
||
|
// It must be safe to invoke FSMSnapshot methods with concurrent
|
||
|
// calls to Apply.
|
||
|
type FSMSnapshot interface {
|
||
|
// Persist should dump all necessary state to the WriteCloser 'sink',
|
||
|
// and call sink.Close() when finished or call sink.Cancel() on error.
|
||
|
Persist(sink SnapshotSink) error
|
||
|
|
||
|
// Release is invoked when we are finished with the snapshot.
|
||
|
Release()
|
||
|
}
|