X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-akka-raft%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fcluster%2Fraft%2Fmessages%2FAppendEntriesReply.java;h=033a19a7b26e758a30430b902085649af4c886ef;hb=HEAD;hp=d811464cba9ba3f6427f3bda972c3fc888190cbb;hpb=cf5be659d906cc80d52647cb516bbab435156742;p=controller.git diff --git a/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/messages/AppendEntriesReply.java b/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/messages/AppendEntriesReply.java index d811464cba..033a19a7b2 100644 --- a/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/messages/AppendEntriesReply.java +++ b/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/messages/AppendEntriesReply.java @@ -5,30 +5,174 @@ * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ - package org.opendaylight.controller.cluster.raft.messages; +import com.google.common.annotations.VisibleForTesting; +import java.io.Externalizable; +import java.io.IOException; +import java.io.ObjectInput; +import java.io.ObjectOutput; +import org.opendaylight.controller.cluster.raft.RaftVersions; + /** - * Reply for the AppendEntriesRpc message + * Reply for the AppendEntries message. */ -public class AppendEntriesReply { - // currentTerm, for leader to update itself - private final long term; +public final class AppendEntriesReply extends AbstractRaftRPC { + @java.io.Serial + private static final long serialVersionUID = -7487547356392536683L; // true if follower contained entry matching // prevLogIndex and prevLogTerm private final boolean success; - public AppendEntriesReply(long term, boolean success) { - this.term = term; - this.success = success; + // The index of the last entry in the followers log + // This will be used to set the matchIndex for the follower on the + // Leader + private final long logLastIndex; + + private final long logLastTerm; + + // The followerId - this will be used to figure out which follower is + // responding + private final String followerId; + + private final short payloadVersion; + + private final short raftVersion; + + private final boolean forceInstallSnapshot; + + private final boolean needsLeaderAddress; + + private final short recipientRaftVersion; + + @VisibleForTesting + public AppendEntriesReply(final String followerId, final long term, final boolean success, final long logLastIndex, + final long logLastTerm, final short payloadVersion) { + this(followerId, term, success, logLastIndex, logLastTerm, payloadVersion, false, false, + RaftVersions.CURRENT_VERSION); } - public long getTerm() { - return term; + public AppendEntriesReply(final String followerId, final long term, final boolean success, final long logLastIndex, + final long logLastTerm, final short payloadVersion, final boolean forceInstallSnapshot, + final boolean needsLeaderAddress, final short recipientRaftVersion) { + this(followerId, term, success, logLastIndex, logLastTerm, payloadVersion, forceInstallSnapshot, + needsLeaderAddress, RaftVersions.CURRENT_VERSION, recipientRaftVersion); + } + + AppendEntriesReply(final String followerId, final long term, final boolean success, final long logLastIndex, + final long logLastTerm, final short payloadVersion, final boolean forceInstallSnapshot, + final boolean needsLeaderAddress, final short raftVersion, final short recipientRaftVersion) { + super(term); + this.followerId = followerId; + this.success = success; + this.logLastIndex = logLastIndex; + this.logLastTerm = logLastTerm; + this.payloadVersion = payloadVersion; + this.forceInstallSnapshot = forceInstallSnapshot; + this.raftVersion = raftVersion; + this.needsLeaderAddress = needsLeaderAddress; + this.recipientRaftVersion = recipientRaftVersion; } public boolean isSuccess() { return success; } + + public long getLogLastIndex() { + return logLastIndex; + } + + public long getLogLastTerm() { + return logLastTerm; + } + + public String getFollowerId() { + return followerId; + } + + public short getPayloadVersion() { + return payloadVersion; + } + + public short getRaftVersion() { + return raftVersion; + } + + public boolean isForceInstallSnapshot() { + return forceInstallSnapshot; + } + + public boolean isNeedsLeaderAddress() { + return needsLeaderAddress; + } + + @Override + public String toString() { + return "AppendEntriesReply [term=" + getTerm() + ", success=" + success + ", followerId=" + followerId + + ", logLastIndex=" + logLastIndex + ", logLastTerm=" + logLastTerm + ", forceInstallSnapshot=" + + forceInstallSnapshot + ", needsLeaderAddress=" + needsLeaderAddress + + ", payloadVersion=" + payloadVersion + ", raftVersion=" + raftVersion + + ", recipientRaftVersion=" + recipientRaftVersion + "]"; + } + + @Override + Object writeReplace() { + return recipientRaftVersion <= RaftVersions.FLUORINE_VERSION ? new Proxy2(this) : new AR(this); + } + + /** + * Fluorine version that adds the needsLeaderAddress flag. + */ + private static class Proxy2 implements Externalizable { + @java.io.Serial + private static final long serialVersionUID = 1L; + + private AppendEntriesReply appendEntriesReply; + + // checkstyle flags the public modifier as redundant which really doesn't make sense since it clearly isn't + // redundant. It is explicitly needed for Java serialization to be able to create instances via reflection. + @SuppressWarnings("checkstyle:RedundantModifier") + public Proxy2() { + } + + Proxy2(final AppendEntriesReply appendEntriesReply) { + this.appendEntriesReply = appendEntriesReply; + } + + @Override + public void writeExternal(final ObjectOutput out) throws IOException { + out.writeShort(appendEntriesReply.raftVersion); + out.writeLong(appendEntriesReply.getTerm()); + out.writeObject(appendEntriesReply.followerId); + out.writeBoolean(appendEntriesReply.success); + out.writeLong(appendEntriesReply.logLastIndex); + out.writeLong(appendEntriesReply.logLastTerm); + out.writeShort(appendEntriesReply.payloadVersion); + out.writeBoolean(appendEntriesReply.forceInstallSnapshot); + out.writeBoolean(appendEntriesReply.needsLeaderAddress); + } + + @Override + public void readExternal(final ObjectInput in) throws IOException, ClassNotFoundException { + short raftVersion = in.readShort(); + long term = in.readLong(); + String followerId = (String) in.readObject(); + boolean success = in.readBoolean(); + long logLastIndex = in.readLong(); + long logLastTerm = in.readLong(); + short payloadVersion = in.readShort(); + boolean forceInstallSnapshot = in.readBoolean(); + boolean needsLeaderAddress = in.readBoolean(); + + appendEntriesReply = new AppendEntriesReply(followerId, term, success, logLastIndex, logLastTerm, + payloadVersion, forceInstallSnapshot, needsLeaderAddress, raftVersion, + RaftVersions.CURRENT_VERSION); + } + + @java.io.Serial + private Object readResolve() { + return appendEntriesReply; + } + } }