opendaylight/md-sal/cds-access-api/src/main/java/org/opendaylight/controller/cluster/access/commands/ConnectClientSuccess.java

   1 /*
   2  * Copyright (c) 2016 Cisco Systems, Inc. and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8 package org.opendaylight.controller.cluster.access.commands;
   9
  10 import static com.google.common.base.Preconditions.checkArgument;
  11 import static java.util.Objects.requireNonNull;
  12
  13 import akka.actor.ActorRef;
  14 import akka.actor.ActorSelection;
  15 import com.google.common.base.MoreObjects.ToStringHelper;
  16 import com.google.common.collect.ImmutableList;
  17 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
  18 import java.util.List;
  19 import java.util.Optional;
  20 import org.eclipse.jdt.annotation.NonNull;
  21 import org.opendaylight.controller.cluster.access.ABIVersion;
  22 import org.opendaylight.controller.cluster.access.concepts.ClientIdentifier;
  23 import org.opendaylight.controller.cluster.access.concepts.RequestSuccess;
  24 import org.opendaylight.yangtools.yang.data.tree.api.ReadOnlyDataTree;
  25
  26 /**
  27  * Successful reply to an {@link ConnectClientRequest}. Client actor which initiated this connection should use
  28  * the version reported via {@link #getVersion()} of this message to communicate with this backend. Should this backend
  29  * fail, the client can try accessing the provided alternates.
  30  */
  31 public final class ConnectClientSuccess extends RequestSuccess<ClientIdentifier, ConnectClientSuccess> {
  32     private static final long serialVersionUID = 1L;
  33
  34     private final @NonNull ImmutableList<ActorSelection> alternates;
  35
  36     @SuppressFBWarnings(value = "SE_BAD_FIELD", justification = "See justification above.")
  37     private final ReadOnlyDataTree dataTree;
  38     private final @NonNull ActorRef backend;
  39     private final int maxMessages;
  40
  41     ConnectClientSuccess(final ClientIdentifier target, final long sequence, final ActorRef backend,
  42         final List<ActorSelection> alternates, final int maxMessages, final ReadOnlyDataTree dataTree) {
  43         super(target, sequence);
  44         this.backend = requireNonNull(backend);
  45         this.alternates = ImmutableList.copyOf(alternates);
  46         this.dataTree = dataTree;
  47         checkArgument(maxMessages > 0, "Maximum messages has to be positive, not %s", maxMessages);
  48         this.maxMessages = maxMessages;
  49     }
  50
  51     public ConnectClientSuccess(final @NonNull ClientIdentifier target, final long sequence,
  52             final @NonNull ActorRef backend, final @NonNull List<ActorSelection> alternates,
  53             final @NonNull ReadOnlyDataTree dataTree, final int maxMessages) {
  54         this(target, sequence, backend, alternates, maxMessages, requireNonNull(dataTree));
  55     }
  56
  57     /**
  58      * Return the list of known alternate backends. The client can use this list to perform recovery procedures.
  59      *
  60      * @return a list of known backend alternates
  61      */
  62     public @NonNull List<ActorSelection> getAlternates() {
  63         return alternates;
  64     }
  65
  66     public @NonNull ActorRef getBackend() {
  67         return backend;
  68     }
  69
  70     public Optional<ReadOnlyDataTree> getDataTree() {
  71         return Optional.ofNullable(dataTree);
  72     }
  73
  74     public int getMaxMessages() {
  75         return maxMessages;
  76     }
  77
  78     @Override
  79     protected ConnectClientSuccessProxyV1 externalizableProxy(final ABIVersion version) {
  80         return new ConnectClientSuccessProxyV1(this);
  81     }
  82
  83     @Override
  84     protected ConnectClientSuccess cloneAsVersion(final ABIVersion version) {
  85         return this;
  86     }
  87
  88     @Override
  89     protected ToStringHelper addToStringAttributes(final ToStringHelper toStringHelper) {
  90         return super.addToStringAttributes(toStringHelper).add("alternates", alternates)
  91                 .add("dataTree present", getDataTree().isPresent()).add("maxMessages", maxMessages);
  92     }
  93 }