eraftpb

Class Eraftpb.ConfChangeV2

java.lang.Object

com.google.protobuf.AbstractMessageLite

com.google.protobuf.AbstractMessage

com.google.protobuf.GeneratedMessageV3

eraftpb.Eraftpb.ConfChangeV2

All Implemented Interfaces:

com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Eraftpb.ConfChangeV2OrBuilder, Serializable

Enclosing class:

Eraftpb

public static final class Eraftpb.ConfChangeV2
extends com.google.protobuf.GeneratedMessageV3
implements Eraftpb.ConfChangeV2OrBuilder

 ConfChangeV2 messages initiate configuration changes. They support both the
 simple "one at a time" membership change protocol and full Joint Consensus
 allowing for arbitrary changes in membership.
 The supplied context is treated as an opaque payload and can be used to
 attach an action on the state machine to the application of the config change
 proposal. Note that contrary to Joint Consensus as outlined in the Raft
 paper[1], configuration changes become active when they are *applied* to the
 state machine (not when they are appended to the log).
 The simple protocol can be used whenever only a single change is made.
 Non-simple changes require the use of Joint Consensus, for which two
 configuration changes are run. The first configuration change specifies the
 desired changes and transitions the Raft group into the joint configuration,
 in which quorum requires a majority of both the pre-changes and post-changes
 configuration. Joint Consensus avoids entering fragile intermediate
 configurations that could compromise survivability. For example, without the
 use of Joint Consensus and running across three availability zones with a
 replication factor of three, it is not possible to replace a voter without
 entering an intermediate configuration that does not survive the outage of
 one availability zone.
 The provided ConfChangeTransition specifies how (and whether) Joint Consensus
 is used, and assigns the task of leaving the joint configuration either to
 Raft or the application. Leaving the joint configuration is accomplished by
 proposing a ConfChangeV2 with only and optionally the Context field
 populated.
 For details on Raft membership changes, see:
 [1]: https://github.com/ongardie/dissertation/blob/master/online-trim.pdf
 

Protobuf type eraftpb.ConfChangeV2

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Eraftpb.ConfChangeV2.Builder ConfChangeV2 messages initiate configuration changes.

Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3

com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage,BuilderType extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType,BuilderType>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable, com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter

Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite

com.google.protobuf.AbstractMessageLite.InternalOneOfEnum

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHANGES_FIELD_NUMBER
static int	CONTEXT_FIELD_NUMBER
static int	TRANSITION_FIELD_NUMBER

Fields inherited from class com.google.protobuf.GeneratedMessageV3

alwaysUseFieldBuilders, unknownFields

Fields inherited from class com.google.protobuf.AbstractMessage

memoizedSize

Fields inherited from class com.google.protobuf.AbstractMessageLite

memoizedHashCode

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
Eraftpb.ConfChangeSingle	getChanges(int index) repeated .eraftpb.ConfChangeSingle changes = 2;
int	getChangesCount() repeated .eraftpb.ConfChangeSingle changes = 2;
List<Eraftpb.ConfChangeSingle>	getChangesList() repeated .eraftpb.ConfChangeSingle changes = 2;
Eraftpb.ConfChangeSingleOrBuilder	getChangesOrBuilder(int index) repeated .eraftpb.ConfChangeSingle changes = 2;
List<? extends Eraftpb.ConfChangeSingleOrBuilder>	getChangesOrBuilderList() repeated .eraftpb.ConfChangeSingle changes = 2;
com.google.protobuf.ByteString	getContext() bytes context = 3;
static Eraftpb.ConfChangeV2	getDefaultInstance()
Eraftpb.ConfChangeV2	getDefaultInstanceForType()
static com.google.protobuf.Descriptors.Descriptor	getDescriptor()
com.google.protobuf.Parser<Eraftpb.ConfChangeV2>	getParserForType()
int	getSerializedSize()
Eraftpb.ConfChangeTransition	getTransition() .eraftpb.ConfChangeTransition transition = 1;
int	getTransitionValue() .eraftpb.ConfChangeTransition transition = 1;
com.google.protobuf.UnknownFieldSet	getUnknownFields()
int	hashCode()
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable	internalGetFieldAccessorTable()
boolean	isInitialized()
static Eraftpb.ConfChangeV2.Builder	newBuilder()
static Eraftpb.ConfChangeV2.Builder	newBuilder(Eraftpb.ConfChangeV2 prototype)
Eraftpb.ConfChangeV2.Builder	newBuilderForType()
protected Eraftpb.ConfChangeV2.Builder	newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
protected Object	newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
static Eraftpb.ConfChangeV2	parseDelimitedFrom(InputStream input)
static Eraftpb.ConfChangeV2	parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Eraftpb.ConfChangeV2	parseFrom(byte[] data)
static Eraftpb.ConfChangeV2	parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Eraftpb.ConfChangeV2	parseFrom(ByteBuffer data)
static Eraftpb.ConfChangeV2	parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Eraftpb.ConfChangeV2	parseFrom(com.google.protobuf.ByteString data)
static Eraftpb.ConfChangeV2	parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Eraftpb.ConfChangeV2	parseFrom(com.google.protobuf.CodedInputStream input)
static Eraftpb.ConfChangeV2	parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Eraftpb.ConfChangeV2	parseFrom(InputStream input)
static Eraftpb.ConfChangeV2	parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static com.google.protobuf.Parser<Eraftpb.ConfChangeV2>	parser()
Eraftpb.ConfChangeV2.Builder	toBuilder()
void	writeTo(com.google.protobuf.CodedOutputStream output)

Methods inherited from class com.google.protobuf.GeneratedMessageV3

canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof, internalGetMapField, isStringEmpty, makeExtensionsImmutable, mergeFromAndMakeImmutableInternal, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBooleanList, newBuilderForType, newDoubleList, newFloatList, newIntList, newLongList, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, writeReplace, writeString, writeStringNoTag

Methods inherited from class com.google.protobuf.AbstractMessage

findInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toString

Methods inherited from class com.google.protobuf.AbstractMessageLite

addAll, addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLite

toByteArray, toByteString, writeDelimitedTo, writeTo

Field Detail

TRANSITION_FIELD_NUMBER

public static final int TRANSITION_FIELD_NUMBER

See Also:

Constant Field Values

CHANGES_FIELD_NUMBER

public static final int CHANGES_FIELD_NUMBER

See Also:

Constant Field Values

CONTEXT_FIELD_NUMBER

public static final int CONTEXT_FIELD_NUMBER

See Also:

Constant Field Values

Method Detail

newInstance

protected Object newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)

Overrides:

newInstance in class com.google.protobuf.GeneratedMessageV3

getUnknownFields

public final com.google.protobuf.UnknownFieldSet getUnknownFields()

Specified by:

getUnknownFields in interface com.google.protobuf.MessageOrBuilder

Overrides:

getUnknownFields in class com.google.protobuf.GeneratedMessageV3

getDescriptor

public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

internalGetFieldAccessorTable

protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Specified by:

internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

getTransitionValue

public int getTransitionValue()

.eraftpb.ConfChangeTransition transition = 1;

Specified by:

getTransitionValue in interface Eraftpb.ConfChangeV2OrBuilder

Returns:

The enum numeric value on the wire for transition.

getTransition

public Eraftpb.ConfChangeTransition getTransition()

.eraftpb.ConfChangeTransition transition = 1;

Specified by:

getTransition in interface Eraftpb.ConfChangeV2OrBuilder

Returns:

The transition.

getChangesList

public List<Eraftpb.ConfChangeSingle> getChangesList()

repeated .eraftpb.ConfChangeSingle changes = 2;

Specified by:

getChangesList in interface Eraftpb.ConfChangeV2OrBuilder

getChangesOrBuilderList

public List<? extends Eraftpb.ConfChangeSingleOrBuilder> getChangesOrBuilderList()

repeated .eraftpb.ConfChangeSingle changes = 2;

Specified by:

getChangesOrBuilderList in interface Eraftpb.ConfChangeV2OrBuilder

getChangesCount

public int getChangesCount()

repeated .eraftpb.ConfChangeSingle changes = 2;

Specified by:

getChangesCount in interface Eraftpb.ConfChangeV2OrBuilder

getChanges

public Eraftpb.ConfChangeSingle getChanges(int index)

repeated .eraftpb.ConfChangeSingle changes = 2;

Specified by:

getChanges in interface Eraftpb.ConfChangeV2OrBuilder

getChangesOrBuilder

public Eraftpb.ConfChangeSingleOrBuilder getChangesOrBuilder(int index)

repeated .eraftpb.ConfChangeSingle changes = 2;

Specified by:

getChangesOrBuilder in interface Eraftpb.ConfChangeV2OrBuilder

getContext

public com.google.protobuf.ByteString getContext()

bytes context = 3;

Specified by:

getContext in interface Eraftpb.ConfChangeV2OrBuilder

Returns:

The context.

isInitialized

public final boolean isInitialized()

Specified by:

isInitialized in interface com.google.protobuf.MessageLiteOrBuilder

Overrides:

isInitialized in class com.google.protobuf.GeneratedMessageV3

writeTo

public void writeTo(com.google.protobuf.CodedOutputStream output)
             throws IOException

Specified by:

writeTo in interface com.google.protobuf.MessageLite

Overrides:

writeTo in class com.google.protobuf.GeneratedMessageV3

Throws:

IOException

getSerializedSize

public int getSerializedSize()

Specified by:

getSerializedSize in interface com.google.protobuf.MessageLite

Overrides:

getSerializedSize in class com.google.protobuf.GeneratedMessageV3

equals

public boolean equals(Object obj)

Specified by:

equals in interface com.google.protobuf.Message

Overrides:

equals in class com.google.protobuf.AbstractMessage

hashCode

public int hashCode()

Specified by:

hashCode in interface com.google.protobuf.Message

Overrides:

hashCode in class com.google.protobuf.AbstractMessage

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(ByteBuffer data)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(ByteBuffer data,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(com.google.protobuf.ByteString data)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(com.google.protobuf.ByteString data,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(byte[] data)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(byte[] data,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(InputStream input)
                                      throws IOException

Throws:

IOException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(InputStream input,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws IOException

Throws:

IOException

parseDelimitedFrom

public static Eraftpb.ConfChangeV2 parseDelimitedFrom(InputStream input)
                                               throws IOException

Throws:

IOException

parseDelimitedFrom

public static Eraftpb.ConfChangeV2 parseDelimitedFrom(InputStream input,
                                                      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                               throws IOException

Throws:

IOException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(com.google.protobuf.CodedInputStream input)
                                      throws IOException

Throws:

IOException

parseFrom

public static Eraftpb.ConfChangeV2 parseFrom(com.google.protobuf.CodedInputStream input,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws IOException

Throws:

IOException

newBuilderForType

public Eraftpb.ConfChangeV2.Builder newBuilderForType()

Specified by:

newBuilderForType in interface com.google.protobuf.Message

Specified by:

newBuilderForType in interface com.google.protobuf.MessageLite

newBuilder

public static Eraftpb.ConfChangeV2.Builder newBuilder()

newBuilder

public static Eraftpb.ConfChangeV2.Builder newBuilder(Eraftpb.ConfChangeV2 prototype)

toBuilder

public Eraftpb.ConfChangeV2.Builder toBuilder()

Specified by:

toBuilder in interface com.google.protobuf.Message

Specified by:

toBuilder in interface com.google.protobuf.MessageLite

newBuilderForType

protected Eraftpb.ConfChangeV2.Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)

Specified by:

newBuilderForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstance

public static Eraftpb.ConfChangeV2 getDefaultInstance()

parser

public static com.google.protobuf.Parser<Eraftpb.ConfChangeV2> parser()

getParserForType

public com.google.protobuf.Parser<Eraftpb.ConfChangeV2> getParserForType()

Specified by:

getParserForType in interface com.google.protobuf.Message

Specified by:

getParserForType in interface com.google.protobuf.MessageLite

Overrides:

getParserForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstanceForType

public Eraftpb.ConfChangeV2 getDefaultInstanceForType()

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder