2 * Copyright (c) 2016 Cisco Systems, Inc. and others. All rights reserved.
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
8 package org.opendaylight.controller.cluster.datastore;
10 import static com.google.common.base.Verify.verify;
12 import com.google.common.base.Preconditions;
13 import com.google.common.collect.Collections2;
14 import com.google.common.collect.Maps;
15 import java.util.HashMap;
17 import javax.annotation.Nonnull;
18 import javax.annotation.concurrent.NotThreadSafe;
19 import org.opendaylight.controller.cluster.access.concepts.ClientIdentifier;
20 import org.opendaylight.controller.cluster.access.concepts.FrontendIdentifier;
21 import org.opendaylight.controller.cluster.access.concepts.LocalHistoryIdentifier;
22 import org.opendaylight.controller.cluster.access.concepts.TransactionIdentifier;
23 import org.opendaylight.controller.cluster.datastore.persisted.FrontendClientMetadata;
24 import org.opendaylight.controller.cluster.datastore.persisted.FrontendShardDataTreeSnapshotMetadata;
25 import org.slf4j.Logger;
26 import org.slf4j.LoggerFactory;
29 * Frontend state as observed by a shard follower. This class is responsible for maintaining metadata state
30 * so that this can be used to seed {@link LeaderFrontendState} with proper state so that the frontend/backend
31 * conversation can continue where it left off.
33 * @author Robert Varga
36 final class FrontendMetadata extends ShardDataTreeMetadata<FrontendShardDataTreeSnapshotMetadata> {
37 private static final Logger LOG = LoggerFactory.getLogger(FrontendMetadata.class);
39 private final Map<FrontendIdentifier, FrontendClientMetadataBuilder> clients = new HashMap<>();
40 private final String shardName;
42 FrontendMetadata(final String shardName) {
43 this.shardName = Preconditions.checkNotNull(shardName);
47 Class<FrontendShardDataTreeSnapshotMetadata> getSupportedType() {
48 return FrontendShardDataTreeSnapshotMetadata.class;
53 LOG.debug("{}: clearing clients {}", shardName, clients);
58 void doApplySnapshot(final FrontendShardDataTreeSnapshotMetadata snapshot) {
59 LOG.debug("{}: applying snapshot {} over clients {}", shardName, snapshot, clients);
62 for (FrontendClientMetadata m : snapshot.getClients()) {
63 LOG.debug("{}: applying metadata {}", shardName, m);
64 final FrontendClientMetadataBuilder b = FrontendClientMetadataBuilder.of(shardName, m);
65 final FrontendIdentifier client = m.getIdentifier().getFrontendId();
67 LOG.debug("{}: client {} updated to {}", shardName, client, b);
68 clients.put(client, b);
73 FrontendShardDataTreeSnapshotMetadata toSnapshot() {
74 return new FrontendShardDataTreeSnapshotMetadata(Collections2.transform(clients.values(),
75 FrontendClientMetadataBuilder::build));
78 private FrontendClientMetadataBuilder ensureClient(final ClientIdentifier id) {
79 final FrontendClientMetadataBuilder existing = clients.get(id.getFrontendId());
80 if (existing != null && id.equals(existing.getIdentifier())) {
84 final FrontendClientMetadataBuilder client = new FrontendClientMetadataBuilder.Enabled(shardName, id);
85 final FrontendClientMetadataBuilder previous = clients.put(id.getFrontendId(), client);
86 if (previous != null) {
87 LOG.debug("{}: Replaced client {} with {}", shardName, previous, client);
89 LOG.debug("{}: Added client {}", shardName, client);
95 void onHistoryCreated(final LocalHistoryIdentifier historyId) {
96 ensureClient(historyId.getClientId()).onHistoryCreated(historyId);
100 void onHistoryClosed(final LocalHistoryIdentifier historyId) {
101 ensureClient(historyId.getClientId()).onHistoryClosed(historyId);
105 void onHistoryPurged(final LocalHistoryIdentifier historyId) {
106 ensureClient(historyId.getClientId()).onHistoryPurged(historyId);
110 void onTransactionAborted(final TransactionIdentifier txId) {
111 ensureClient(txId.getHistoryId().getClientId()).onTransactionAborted(txId);
115 void onTransactionCommitted(final TransactionIdentifier txId) {
116 ensureClient(txId.getHistoryId().getClientId()).onTransactionCommitted(txId);
120 void onTransactionPurged(final TransactionIdentifier txId) {
121 ensureClient(txId.getHistoryId().getClientId()).onTransactionPurged(txId);
125 * Transform frontend metadata into an active leader state map.
127 * @return Leader frontend state
129 @Nonnull Map<FrontendIdentifier, LeaderFrontendState> toLeaderState(@Nonnull final Shard shard) {
130 return new HashMap<>(Maps.transformValues(clients, meta -> meta.toLeaderState(shard)));
133 void disableTracking(final ClientIdentifier clientId) {
134 final FrontendIdentifier frontendId = clientId.getFrontendId();
135 final FrontendClientMetadataBuilder client = clients.get(frontendId);
136 if (client == null) {
137 // When we havent seen the client before, we still need to disable tracking for him since this only gets
139 LOG.debug("{}: disableTracking {} does not match any client, pre-disabling client.", shardName, clientId);
140 clients.put(frontendId, new FrontendClientMetadataBuilder.Disabled(shardName, clientId));
143 if (!clientId.equals(client.getIdentifier())) {
144 LOG.debug("{}: disableTracking {} does not match client {}, ignoring", shardName, clientId, client);
147 if (client instanceof FrontendClientMetadataBuilder.Disabled) {
148 LOG.debug("{}: client {} is has already disabled tracking", shardName, client);
152 verify(clients.replace(frontendId, client, new FrontendClientMetadataBuilder.Disabled(shardName, clientId)));