From: Robert Varga <rovarga@cisco.com>
Date: Sun, 14 Feb 2016 00:31:46 +0000 (+0100)
Subject: Add SendInstallSnapshot javadoc
X-Git-Tag: release/boron~361
X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=controller.git;a=commitdiff_plain;h=d89e839b36a664c32a40706afaa1a10ac5b64b3b;hp=fd29c6cd3e5c7b0fbfd5244f164473c72ced8f7b

Add SendInstallSnapshot javadoc

First cut at describing mechanics. Also make the class final and
annonate nullness.

Change-Id: I94119ab818713110dfab199b0e3f9e9608cfd583
Signed-off-by: Robert Varga <rovarga@cisco.com>
---

diff --git a/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/base/messages/SendInstallSnapshot.java b/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/base/messages/SendInstallSnapshot.java
index 21c65e6037..94e31846ee 100644
--- a/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/base/messages/SendInstallSnapshot.java
+++ b/opendaylight/md-sal/sal-akka-raft/src/main/java/org/opendaylight/controller/cluster/raft/base/messages/SendInstallSnapshot.java
@@ -8,16 +8,22 @@
 
 package org.opendaylight.controller.cluster.raft.base.messages;
 
+import com.google.common.base.Preconditions;
+import javax.annotation.Nonnull;
 import org.opendaylight.controller.cluster.raft.Snapshot;
 
-public class SendInstallSnapshot {
+/**
+ * Internal message sent from the SnapshotManager to its associated leader. The leader is expected to apply the
+ * {@link Snapshot} to its state.
+ */
+public final class SendInstallSnapshot {
     private final Snapshot snapshot;
 
-    public SendInstallSnapshot(Snapshot snapshot) {
-        this.snapshot = snapshot;
+    public SendInstallSnapshot(@Nonnull Snapshot snapshot) {
+        this.snapshot = Preconditions.checkNotNull(snapshot);
     }
 
-    public Snapshot getSnapshot() {
+    @Nonnull public Snapshot getSnapshot() {
         return snapshot;
     }
 }