Teach sal-remoterpc-connector to route actions
[controller.git] / opendaylight / md-sal / sal-remoterpc-connector / src / main / java / org / opendaylight / controller / remote / rpc / registry / gossip / Gossiper.java
index d26bda1c25fa481f2cb13a37efc819ada1d550ac..e75bef24c7aa22e7758b430a6ca9aeba31f8f381 100644 (file)
@@ -12,34 +12,26 @@ import akka.actor.ActorRefProvider;
 import akka.actor.ActorSelection;
 import akka.actor.Address;
 import akka.actor.Cancellable;
+import akka.actor.Props;
 import akka.cluster.Cluster;
 import akka.cluster.ClusterActorRefProvider;
 import akka.cluster.ClusterEvent;
 import akka.cluster.Member;
-import akka.dispatch.Mapper;
-import akka.pattern.Patterns;
 import com.google.common.annotations.VisibleForTesting;
 import com.google.common.base.Preconditions;
+import com.google.common.base.Verify;
+import com.google.common.collect.Maps;
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
+import java.util.Map.Entry;
 import java.util.Set;
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.concurrent.TimeUnit;
 import org.opendaylight.controller.cluster.common.actor.AbstractUntypedActorWithMetering;
-import org.opendaylight.controller.remote.rpc.RemoteRpcProviderConfig;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.BucketStoreMessages.GetBucketVersions;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.BucketStoreMessages.GetBucketVersionsReply;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.BucketStoreMessages.GetBucketsByMembers;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.BucketStoreMessages.GetBucketsByMembersReply;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.BucketStoreMessages.UpdateRemoteBuckets;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipEnvelope;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipStatus;
-import org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipTick;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-import scala.concurrent.Future;
+import org.opendaylight.controller.remote.rpc.RemoteOpsProviderConfig;
 import scala.concurrent.duration.FiniteDuration;
 
 /**
@@ -61,41 +53,52 @@ import scala.concurrent.duration.FiniteDuration;
  * for update.
  */
 public class Gossiper extends AbstractUntypedActorWithMetering {
+    private static final Object GOSSIP_TICK = new Object() {
+        @Override
+        public String toString() {
+            return "gossip tick";
+        }
+    };
 
-    private final Logger log = LoggerFactory.getLogger(getClass());
+    private final boolean autoStartGossipTicks;
+    private final RemoteOpsProviderConfig config;
 
-    private Cluster cluster;
+    /**
+     * All known cluster members.
+     */
+    private final List<Address> clusterMembers = new ArrayList<>();
 
     /**
-     * ActorSystem's address for the current cluster node.
+     * Cached ActorSelections for remote peers.
      */
-    private Address selfAddress;
+    private final Map<Address, ActorSelection> peers = new HashMap<>();
 
     /**
-     * All known cluster members.
+     * ActorSystem's address for the current cluster node.
      */
-    private List<Address> clusterMembers = new ArrayList<>();
+    private Address selfAddress;
 
-    private Cancellable gossipTask;
+    private Cluster cluster;
 
-    private Boolean autoStartGossipTicks = true;
+    private Cancellable gossipTask;
 
-    private final RemoteRpcProviderConfig config;
+    private BucketStoreAccess bucketStore;
 
-    public Gossiper(RemoteRpcProviderConfig config) {
+    Gossiper(final RemoteOpsProviderConfig config, final Boolean autoStartGossipTicks) {
         this.config = Preconditions.checkNotNull(config);
+        this.autoStartGossipTicks = autoStartGossipTicks.booleanValue();
     }
 
-    /**
-     * Constructor for testing.
-     *
-     * @param autoStartGossipTicks used for turning off gossip ticks during testing.
-     *                             Gossip tick can be manually sent.
-     */
-    @VisibleForTesting
-    public Gossiper(Boolean autoStartGossipTicks, RemoteRpcProviderConfig config) {
-        this(config);
-        this.autoStartGossipTicks = autoStartGossipTicks;
+    Gossiper(final RemoteOpsProviderConfig config) {
+        this(config, Boolean.TRUE);
+    }
+
+    public static Props props(final RemoteOpsProviderConfig config) {
+        return Props.create(Gossiper.class, config);
+    }
+
+    static Props testProps(final RemoteOpsProviderConfig config) {
+        return Props.create(Gossiper.class, config, Boolean.FALSE);
     }
 
     @Override
@@ -103,11 +106,14 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
         ActorRefProvider provider = getContext().provider();
         selfAddress = provider.getDefaultAddress();
 
-        if ( provider instanceof ClusterActorRefProvider ) {
+        bucketStore = new BucketStoreAccess(getContext().parent(), getContext().dispatcher(), config.getAskDuration());
+
+        if (provider instanceof ClusterActorRefProvider) {
             cluster = Cluster.get(getContext().system());
             cluster.subscribe(getSelf(),
                     ClusterEvent.initialStateAsEvents(),
                     ClusterEvent.MemberEvent.class,
+                    ClusterEvent.ReachableMember.class,
                     ClusterEvent.UnreachableMember.class);
         }
 
@@ -115,10 +121,10 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
             gossipTask = getContext().system().scheduler().schedule(
                     new FiniteDuration(1, TimeUnit.SECONDS),        //initial delay
                     config.getGossipTickInterval(),                 //interval
-                    getSelf(),                                       //target
-                    new Messages.GossiperMessages.GossipTick(),      //message
-                    getContext().dispatcher(),                       //execution context
-                    getSelf()                                        //sender
+                    getSelf(),                                      //target
+                    GOSSIP_TICK,                                    //message
+                    getContext().dispatcher(),                      //execution context
+                    getSelf()                                       //sender
             );
         }
     }
@@ -133,12 +139,11 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
         }
     }
 
-    @SuppressWarnings({ "rawtypes", "unchecked" })
     @Override
-    protected void handleReceive(Object message) throws Exception {
+    protected void handleReceive(final Object message) {
         //Usually sent by self via gossip task defined above. But its not enforced.
         //These ticks can be sent by another actor as well which is esp. useful while testing
-        if (message instanceof GossipTick) {
+        if (GOSSIP_TICK.equals(message)) {
             receiveGossipTick();
         } else if (message instanceof GossipStatus) {
             // Message from remote gossiper with its bucket versions
@@ -149,12 +154,15 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
             // comparing the GossipStatus message with its local versions.
             receiveGossip((GossipEnvelope) message);
         } else if (message instanceof ClusterEvent.MemberUp) {
-            receiveMemberUp(((ClusterEvent.MemberUp) message).member());
+            receiveMemberUpOrReachable(((ClusterEvent.MemberUp) message).member());
+
+        } else if (message instanceof ClusterEvent.ReachableMember) {
+            receiveMemberUpOrReachable(((ClusterEvent.ReachableMember) message).member());
 
         } else if (message instanceof ClusterEvent.MemberRemoved) {
             receiveMemberRemoveOrUnreachable(((ClusterEvent.MemberRemoved) message).member());
 
-        } else if ( message instanceof ClusterEvent.UnreachableMember) {
+        } else if (message instanceof ClusterEvent.UnreachableMember) {
             receiveMemberRemoveOrUnreachable(((ClusterEvent.UnreachableMember) message).member());
 
         } else {
@@ -167,15 +175,31 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param member who went down
      */
-    void receiveMemberRemoveOrUnreachable(Member member) {
+    private void receiveMemberRemoveOrUnreachable(final Member member) {
+        LOG.debug("Received memberDown or Unreachable: {}", member);
+
         //if its self, then stop itself
         if (selfAddress.equals(member.address())) {
             getContext().stop(getSelf());
             return;
         }
 
-        clusterMembers.remove(member.address());
-        log.debug("Removed member [{}], Active member list [{}]", member.address(), clusterMembers);
+        removePeer(member.address());
+        LOG.debug("Removed member [{}], Active member list [{}]", member.address(), clusterMembers);
+    }
+
+    private void addPeer(final Address address) {
+        if (!clusterMembers.contains(address)) {
+            clusterMembers.add(address);
+        }
+        peers.computeIfAbsent(address, input -> getContext().system()
+            .actorSelection(input.toString() + getSelf().path().toStringWithoutAddress()));
+    }
+
+    private void removePeer(final Address address) {
+        clusterMembers.remove(address);
+        peers.remove(address);
+        bucketStore.removeRemoteBucket(address);
     }
 
     /**
@@ -183,17 +207,16 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param member the member to add
      */
-    void receiveMemberUp(Member member) {
+    private void receiveMemberUpOrReachable(final Member member) {
+        LOG.debug("Received memberUp or reachable: {}", member);
 
+        //ignore up notification for self
         if (selfAddress.equals(member.address())) {
-            return; //ignore up notification for self
-        }
-
-        if (!clusterMembers.contains(member.address())) {
-            clusterMembers.add(member.address());
+            return;
         }
 
-        log.debug("Added member [{}], Active member list [{}]", member.address(), clusterMembers);
+        addPeer(member.address());
+        LOG.debug("Added member [{}], Active member list [{}]", member.address(), clusterMembers);
     }
 
     /**
@@ -203,22 +226,24 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      * 2. If there's only 1 member, send gossip status (bucket versions) to it. <br>
      * 3. If there are more than one member, randomly pick one and send gossip status (bucket versions) to it.
      */
+    @VisibleForTesting
     void receiveGossipTick() {
-        if (clusterMembers.size() == 0) {
-            return; //no members to send gossip status to
-        }
-
-        Address remoteMemberToGossipTo;
-
-        if (clusterMembers.size() == 1) {
-            remoteMemberToGossipTo = clusterMembers.get(0);
-        } else {
-            Integer randomIndex = ThreadLocalRandom.current().nextInt(0, clusterMembers.size());
-            remoteMemberToGossipTo = clusterMembers.get(randomIndex);
+        final Address address;
+        switch (clusterMembers.size()) {
+            case 0:
+                //no members to send gossip status to
+                return;
+            case 1:
+                address = clusterMembers.get(0);
+                break;
+            default:
+                final int randomIndex = ThreadLocalRandom.current().nextInt(0, clusterMembers.size());
+                address = clusterMembers.get(randomIndex);
+                break;
         }
 
-        log.trace("Gossiping to [{}]", remoteMemberToGossipTo);
-        getLocalStatusAndSendTo(remoteMemberToGossipTo);
+        LOG.trace("Gossiping to [{}]", address);
+        getLocalStatusAndSendTo(Verify.verifyNotNull(peers.get(address)));
     }
 
     /**
@@ -234,18 +259,56 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param status bucket versions from a remote member
      */
-    void receiveGossipStatus(GossipStatus status) {
-        //Don't accept messages from non-members
-        if (!clusterMembers.contains(status.from())) {
-            return;
+    @VisibleForTesting
+    void receiveGossipStatus(final GossipStatus status) {
+        // Don't accept messages from non-members
+        if (peers.containsKey(status.from())) {
+            // FIXME: sender should be part of GossipStatus
+            final ActorRef sender = getSender();
+            bucketStore.getBucketVersions(versions ->  processRemoteStatus(sender, status, versions));
         }
+    }
+
+    private void processRemoteStatus(final ActorRef remote, final GossipStatus status,
+            final Map<Address, Long> localVersions) {
+        final Map<Address, Long> remoteVersions = status.versions();
 
-        final ActorRef sender = getSender();
-        Future<Object> futureReply =
-                Patterns.ask(getContext().parent(), new GetBucketVersions(), config.getAskDuration());
+        //diff between remote list and local
+        final Set<Address> localIsOlder = new HashSet<>(remoteVersions.keySet());
+        localIsOlder.removeAll(localVersions.keySet());
 
-        futureReply.map(getMapperToProcessRemoteStatus(sender, status), getContext().dispatcher());
+        //diff between local list and remote
+        final Set<Address> localIsNewer = new HashSet<>(localVersions.keySet());
+        localIsNewer.removeAll(remoteVersions.keySet());
 
+
+        for (Entry<Address, Long> entry : remoteVersions.entrySet()) {
+            Address address = entry.getKey();
+            Long remoteVersion = entry.getValue();
+            Long localVersion = localVersions.get(address);
+            if (localVersion == null || remoteVersion == null) {
+                //this condition is taken care of by above diffs
+                continue;
+            }
+
+            if (localVersion < remoteVersion) {
+                localIsOlder.add(address);
+            } else if (localVersion > remoteVersion) {
+                localIsNewer.add(address);
+            }
+        }
+
+        if (!localIsOlder.isEmpty()) {
+            remote.tell(new GossipStatus(selfAddress, localVersions), getSelf());
+        }
+
+        if (!localIsNewer.isEmpty()) {
+            //send newer buckets to remote
+            bucketStore.getBucketsByMembers(localIsNewer, buckets -> {
+                LOG.trace("Buckets to send from {}: {}", selfAddress, buckets);
+                remote.tell(new GossipEnvelope(selfAddress, remote.path().address(), buckets), getSelf());
+            });
+        }
     }
 
     /**
@@ -253,18 +316,15 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param envelope contains buckets from a remote gossiper
      */
-    <T extends Copier<T>> void receiveGossip(GossipEnvelope<T> envelope) {
+    @VisibleForTesting
+    void receiveGossip(final GossipEnvelope envelope) {
         //TODO: Add more validations
         if (!selfAddress.equals(envelope.to())) {
-            if (log.isTraceEnabled()) {
-                log.trace("Ignoring message intended for someone else. From [{}] to [{}]", envelope.from(),
-                        envelope.to());
-            }
+            LOG.trace("Ignoring message intended for someone else. From [{}] to [{}]", envelope.from(), envelope.to());
             return;
         }
 
-        updateRemoteBuckets(envelope.getBuckets());
-
+        updateRemoteBuckets(envelope.buckets());
     }
 
     /**
@@ -272,22 +332,10 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param buckets map of Buckets to update
      */
-    <T extends Copier<T>> void updateRemoteBuckets(Map<Address, Bucket<T>> buckets) {
-        UpdateRemoteBuckets<T> updateRemoteBuckets = new UpdateRemoteBuckets<>(buckets);
-        getContext().parent().tell(updateRemoteBuckets, getSelf());
-    }
-
-    /**
-     * Gets the buckets from bucket store for the given node addresses and sends them to remote gossiper.
-     *
-     * @param remote     remote node to send Buckets to
-     * @param addresses  node addresses whose buckets needs to be sent
-     */
-    void sendGossipTo(final ActorRef remote, final Set<Address> addresses) {
-
-        Future<Object> futureReply =
-                Patterns.ask(getContext().parent(), new GetBucketsByMembers(addresses), config.getAskDuration());
-        futureReply.map(getMapperToSendGossip(remote), getContext().dispatcher());
+    @VisibleForTesting
+    void updateRemoteBuckets(final Map<Address, ? extends Bucket<?>> buckets) {
+        // filter this so we only handle buckets for known peers
+        bucketStore.updateRemoteBuckets(Maps.filterKeys(buckets, peers::containsKey));
     }
 
     /**
@@ -295,175 +343,29 @@ public class Gossiper extends AbstractUntypedActorWithMetering {
      *
      * @param remoteActorSystemAddress remote gossiper to send to
      */
-    void getLocalStatusAndSendTo(Address remoteActorSystemAddress) {
-
-        //Get local status from bucket store and send to remote
-        Future<Object> futureReply =
-                Patterns.ask(getContext().parent(), new GetBucketVersions(), config.getAskDuration());
-
-        //Find gossiper on remote system
-        ActorSelection remoteRef = getContext().system().actorSelection(
-                remoteActorSystemAddress.toString() + getSelf().path().toStringWithoutAddress());
-
-        log.trace("Sending bucket versions to [{}]", remoteRef);
-
-        futureReply.map(getMapperToSendLocalStatus(remoteRef), getContext().dispatcher());
-
-    }
-
-    /**
-     * Helper to send bucket versions received from local store.
-     *
-     * @param remote        remote gossiper to send versions to
-     * @param localVersions bucket versions received from local store
-     */
-    void sendGossipStatusTo(ActorRef remote, Map<Address, Long> localVersions) {
-
-        GossipStatus status = new GossipStatus(selfAddress, localVersions);
-        remote.tell(status, getSelf());
-    }
-
-    void sendGossipStatusTo(ActorSelection remote, Map<Address, Long> localVersions) {
-
-        GossipStatus status = new GossipStatus(selfAddress, localVersions);
-        remote.tell(status, getSelf());
-    }
-
-    ///
-    /// Private factories to create mappers
-    ///
-
-    private Mapper<Object, Void> getMapperToSendLocalStatus(final ActorSelection remote) {
-
-        return new Mapper<Object, Void>() {
-            @Override
-            public Void apply(Object replyMessage) {
-                if (replyMessage instanceof GetBucketVersionsReply) {
-                    GetBucketVersionsReply reply = (GetBucketVersionsReply) replyMessage;
-                    Map<Address, Long> localVersions = reply.getVersions();
-
-                    sendGossipStatusTo(remote, localVersions);
-
-                }
-                return null;
-            }
-        };
-    }
-
-    /**
-     * Process bucket versions received from
-     * {@link org.opendaylight.controller.remote.rpc.registry.gossip.BucketStore}.
-     * Then this method compares remote bucket versions with local bucket versions.
-     * <ul>
-     *     <li>The buckets that are newer locally, send
-     *     {@link org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipEnvelope}
-     *     to remote
-     *     <li>The buckets that are older locally, send
-     *     {@link org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipStatus}
-     *     to remote so that remote sends GossipEnvelop.
-     * </ul>
-     *
-     * @param sender the remote member
-     * @param status bucket versions from a remote member
-     * @return a {@link akka.dispatch.Mapper} that gets evaluated in future
-     *
-     */
-    private Mapper<Object, Void> getMapperToProcessRemoteStatus(final ActorRef sender, final GossipStatus status) {
-
-        final Map<Address, Long> remoteVersions = status.getVersions();
-
-        return new Mapper<Object, Void>() {
-            @Override
-            public Void apply(Object replyMessage) {
-                if (replyMessage instanceof GetBucketVersionsReply) {
-                    GetBucketVersionsReply reply = (GetBucketVersionsReply) replyMessage;
-                    Map<Address, Long> localVersions = reply.getVersions();
-
-                    //diff between remote list and local
-                    Set<Address> localIsOlder = new HashSet<>();
-                    localIsOlder.addAll(remoteVersions.keySet());
-                    localIsOlder.removeAll(localVersions.keySet());
-
-                    //diff between local list and remote
-                    Set<Address> localIsNewer = new HashSet<>();
-                    localIsNewer.addAll(localVersions.keySet());
-                    localIsNewer.removeAll(remoteVersions.keySet());
-
-
-                    for (Map.Entry<Address, Long> entry : remoteVersions.entrySet()) {
-                        Address address = entry.getKey();
-                        Long remoteVersion = entry.getValue();
-                        Long localVersion = localVersions.get(address);
-                        if (localVersion == null || remoteVersion == null) {
-                            continue; //this condition is taken care of by above diffs
-                        }
-
-                        if (localVersion < remoteVersion) {
-                            localIsOlder.add(address);
-                        } else if (localVersion > remoteVersion) {
-                            localIsNewer.add(address);
-                        }
-                    }
-
-                    if (!localIsOlder.isEmpty()) {
-                        sendGossipStatusTo(sender, localVersions );
-                    }
-
-                    if (!localIsNewer.isEmpty()) {
-                        sendGossipTo(sender, localIsNewer);//send newer buckets to remote
-                    }
-
-                }
-                return null;
-            }
-        };
-    }
-
-    /**
-     * Processes the message from {@link org.opendaylight.controller.remote.rpc.registry.gossip.BucketStore}
-     * that contains {@link org.opendaylight.controller.remote.rpc.registry.gossip.Bucket}.
-     * These buckets are sent to a remote member encapsulated in
-     * {@link org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipEnvelope}
-     *
-     * @param sender the remote member that sent
-     *           {@link org.opendaylight.controller.remote.rpc.registry.gossip.Messages.GossiperMessages.GossipStatus}
-     *           in reply to which bucket is being sent back
-     * @return a {@link akka.dispatch.Mapper} that gets evaluated in future
-     *
-     */
-    private Mapper<Object, Void> getMapperToSendGossip(final ActorRef sender) {
-
-        return new Mapper<Object, Void>() {
-            @SuppressWarnings({ "rawtypes", "unchecked" })
-            @Override
-            public Void apply(Object msg) {
-                if (msg instanceof GetBucketsByMembersReply) {
-                    Map<Address, Bucket<?>> buckets = ((GetBucketsByMembersReply) msg).getBuckets();
-                    log.trace("Buckets to send from {}: {}", selfAddress, buckets);
-                    GossipEnvelope envelope = new GossipEnvelope(selfAddress, sender.path().address(), buckets);
-                    sender.tell(envelope, getSelf());
-                }
-                return null;
-            }
-        };
+    @VisibleForTesting
+    void getLocalStatusAndSendTo(final ActorSelection remoteGossiper) {
+        bucketStore.getBucketVersions(versions -> {
+            LOG.trace("Sending bucket versions to [{}]", remoteGossiper);
+            /*
+             * XXX: we are leaking our reference here. That may be useful for establishing buckets monitoring,
+             *      but can we identify which bucket is the local one?
+             */
+            remoteGossiper.tell(new GossipStatus(selfAddress, versions), getSelf());
+        });
     }
 
     ///
     ///Getter Setters
     ///
-    List<Address> getClusterMembers() {
-        return clusterMembers;
-    }
-
-    void setClusterMembers(List<Address> clusterMembers) {
-        this.clusterMembers = clusterMembers;
-    }
 
-    Address getSelfAddress() {
-        return selfAddress;
-    }
+    @VisibleForTesting
+    void setClusterMembers(final Address... members) {
+        clusterMembers.clear();
+        peers.clear();
 
-    void setSelfAddress(Address selfAddress) {
-        this.selfAddress = selfAddress;
+        for (Address addr : members) {
+            addPeer(addr);
+        }
     }
 }