2 * Copyright (c) 2015 Brocade Communications 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 org.junit.Assert.assertEquals;
11 import static org.junit.Assert.assertNotNull;
12 import static org.junit.Assert.assertTrue;
13 import static org.junit.Assert.fail;
14 import static org.mockito.Mockito.doAnswer;
15 import static org.mockito.Mockito.mock;
16 import akka.actor.ActorRef;
17 import akka.actor.PoisonPill;
18 import akka.actor.Props;
19 import akka.dispatch.Dispatchers;
20 import akka.japi.Creator;
21 import akka.testkit.TestActorRef;
22 import com.google.common.base.Function;
23 import com.google.common.base.Optional;
24 import com.google.common.util.concurrent.ListenableFuture;
25 import com.google.common.util.concurrent.Uninterruptibles;
26 import java.util.Collections;
28 import java.util.concurrent.CountDownLatch;
29 import java.util.concurrent.ExecutionException;
30 import java.util.concurrent.TimeUnit;
31 import java.util.concurrent.atomic.AtomicInteger;
32 import org.junit.After;
33 import org.junit.Assert;
34 import org.junit.Before;
35 import org.mockito.invocation.InvocationOnMock;
36 import org.mockito.stubbing.Answer;
37 import org.opendaylight.controller.cluster.datastore.DatastoreContext.Builder;
38 import org.opendaylight.controller.cluster.datastore.identifiers.ShardIdentifier;
39 import org.opendaylight.controller.cluster.datastore.modification.MutableCompositeModification;
40 import org.opendaylight.controller.cluster.datastore.modification.WriteModification;
41 import org.opendaylight.controller.cluster.raft.utils.InMemoryJournal;
42 import org.opendaylight.controller.cluster.raft.utils.InMemorySnapshotStore;
43 import org.opendaylight.controller.md.cluster.datastore.model.TestModel;
44 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
45 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument;
46 import org.opendaylight.yangtools.yang.data.api.schema.DataContainerChild;
47 import org.opendaylight.yangtools.yang.data.api.schema.MapEntryNode;
48 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
49 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTree;
50 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidate;
51 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidateTip;
52 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeModification;
53 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeSnapshot;
54 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataValidationFailedException;
55 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
58 * Abstract base for shard unit tests.
60 * @author Thomas Pantelis
62 public abstract class AbstractShardTest extends AbstractActorTest{
63 protected static final SchemaContext SCHEMA_CONTEXT = TestModel.createTestContext();
65 private static final AtomicInteger NEXT_SHARD_NUM = new AtomicInteger();
67 protected final ShardIdentifier shardID = ShardIdentifier.builder().memberName("member-1")
68 .shardName("inventory").type("config" + NEXT_SHARD_NUM.getAndIncrement()).build();
70 protected final Builder dataStoreContextBuilder = DatastoreContext.newBuilder().
71 shardJournalRecoveryLogBatchSize(3).shardSnapshotBatchCount(5000).
72 shardHeartbeatIntervalInMillis(100);
76 InMemorySnapshotStore.clear();
77 InMemoryJournal.clear();
81 public void tearDown() {
82 InMemorySnapshotStore.clear();
83 InMemoryJournal.clear();
86 protected DatastoreContext newDatastoreContext() {
87 return dataStoreContextBuilder.build();
90 protected Props newShardProps() {
91 return Shard.props(shardID, Collections.<String,String>emptyMap(),
92 newDatastoreContext(), SCHEMA_CONTEXT);
95 protected void testRecovery(Set<Integer> listEntryKeys) throws Exception {
96 // Create the actor and wait for recovery complete.
98 int nListEntries = listEntryKeys.size();
100 final CountDownLatch recoveryComplete = new CountDownLatch(1);
102 @SuppressWarnings("serial")
103 Creator<Shard> creator = new Creator<Shard>() {
105 public Shard create() throws Exception {
106 return new Shard(shardID, Collections.<String,String>emptyMap(),
107 newDatastoreContext(), SCHEMA_CONTEXT) {
109 protected void onRecoveryComplete() {
111 super.onRecoveryComplete();
113 recoveryComplete.countDown();
120 TestActorRef<Shard> shard = TestActorRef.create(getSystem(),
121 Props.create(new DelegatingShardCreator(creator)).withDispatcher(Dispatchers.DefaultDispatcherId()), "testRecovery");
123 assertEquals("Recovery complete", true, recoveryComplete.await(5, TimeUnit.SECONDS));
125 // Verify data in the data store.
127 NormalizedNode<?, ?> outerList = readStore(shard, TestModel.OUTER_LIST_PATH);
128 assertNotNull(TestModel.OUTER_LIST_QNAME.getLocalName() + " not found", outerList);
129 assertTrue(TestModel.OUTER_LIST_QNAME.getLocalName() + " value is not Iterable",
130 outerList.getValue() instanceof Iterable);
131 for(Object entry: (Iterable<?>) outerList.getValue()) {
132 assertTrue(TestModel.OUTER_LIST_QNAME.getLocalName() + " entry is not MapEntryNode",
133 entry instanceof MapEntryNode);
134 MapEntryNode mapEntry = (MapEntryNode)entry;
135 Optional<DataContainerChild<? extends PathArgument, ?>> idLeaf =
136 mapEntry.getChild(new YangInstanceIdentifier.NodeIdentifier(TestModel.ID_QNAME));
137 assertTrue("Missing leaf " + TestModel.ID_QNAME.getLocalName(), idLeaf.isPresent());
138 Object value = idLeaf.get().getValue();
139 assertTrue("Unexpected value for leaf "+ TestModel.ID_QNAME.getLocalName() + ": " + value,
140 listEntryKeys.remove(value));
143 if(!listEntryKeys.isEmpty()) {
144 fail("Missing " + TestModel.OUTER_LIST_QNAME.getLocalName() + " entries with keys: " +
148 assertEquals("Last log index", nListEntries,
149 shard.underlyingActor().getShardMBean().getLastLogIndex());
150 assertEquals("Commit index", nListEntries,
151 shard.underlyingActor().getShardMBean().getCommitIndex());
152 assertEquals("Last applied", nListEntries,
153 shard.underlyingActor().getShardMBean().getLastApplied());
155 shard.tell(PoisonPill.getInstance(), ActorRef.noSender());
158 protected void verifyLastApplied(TestActorRef<Shard> shard, long expectedValue) {
159 long lastApplied = -1;
160 for(int i = 0; i < 20 * 5; i++) {
161 lastApplied = shard.underlyingActor().getShardMBean().getLastApplied();
162 if(lastApplied == expectedValue) {
165 Uninterruptibles.sleepUninterruptibly(50, TimeUnit.MILLISECONDS);
168 Assert.fail(String.format("Expected last applied: %d, Actual: %d", expectedValue, lastApplied));
171 protected ShardDataTreeCohort setupMockWriteTransaction(final String cohortName,
172 final ShardDataTree dataStore, final YangInstanceIdentifier path, final NormalizedNode<?, ?> data,
173 final MutableCompositeModification modification) {
174 return setupMockWriteTransaction(cohortName, dataStore, path, data, modification, null);
177 protected ShardDataTreeCohort setupMockWriteTransaction(final String cohortName,
178 final ShardDataTree dataStore, final YangInstanceIdentifier path, final NormalizedNode<?, ?> data,
179 final MutableCompositeModification modification,
180 final Function<ShardDataTreeCohort, ListenableFuture<Void>> preCommit) {
182 ReadWriteShardDataTreeTransaction tx = dataStore.newReadWriteTransaction("setup-mock-" + cohortName, null);
183 tx.getSnapshot().write(path, data);
184 ShardDataTreeCohort cohort = createDelegatingMockCohort(cohortName, dataStore.finishTransaction(tx), preCommit);
186 modification.addModification(new WriteModification(path, data));
191 protected ShardDataTreeCohort createDelegatingMockCohort(final String cohortName,
192 final ShardDataTreeCohort actual) {
193 return createDelegatingMockCohort(cohortName, actual, null);
196 protected ShardDataTreeCohort createDelegatingMockCohort(final String cohortName,
197 final ShardDataTreeCohort actual,
198 final Function<ShardDataTreeCohort, ListenableFuture<Void>> preCommit) {
199 ShardDataTreeCohort cohort = mock(ShardDataTreeCohort.class, cohortName);
201 doAnswer(new Answer<ListenableFuture<Boolean>>() {
203 public ListenableFuture<Boolean> answer(final InvocationOnMock invocation) {
204 return actual.canCommit();
206 }).when(cohort).canCommit();
208 doAnswer(new Answer<ListenableFuture<Void>>() {
210 public ListenableFuture<Void> answer(final InvocationOnMock invocation) throws Throwable {
211 if(preCommit != null) {
212 return preCommit.apply(actual);
214 return actual.preCommit();
217 }).when(cohort).preCommit();
219 doAnswer(new Answer<ListenableFuture<Void>>() {
221 public ListenableFuture<Void> answer(final InvocationOnMock invocation) throws Throwable {
222 return actual.commit();
224 }).when(cohort).commit();
226 doAnswer(new Answer<ListenableFuture<Void>>() {
228 public ListenableFuture<Void> answer(final InvocationOnMock invocation) throws Throwable {
229 return actual.abort();
231 }).when(cohort).abort();
233 doAnswer(new Answer<DataTreeCandidateTip>() {
235 public DataTreeCandidateTip answer(final InvocationOnMock invocation) {
236 return actual.getCandidate();
238 }).when(cohort).getCandidate();
243 public static NormalizedNode<?,?> readStore(final TestActorRef<Shard> shard, final YangInstanceIdentifier id)
244 throws ExecutionException, InterruptedException {
245 return readStore(shard.underlyingActor().getDataStore().getDataTree(), id);
248 public static NormalizedNode<?,?> readStore(final DataTree store, final YangInstanceIdentifier id) {
249 DataTreeSnapshot transaction = store.takeSnapshot();
251 Optional<NormalizedNode<?, ?>> optional = transaction.readNode(id);
252 NormalizedNode<?, ?> node = optional.isPresent()? optional.get() : null;
257 public static void writeToStore(final TestActorRef<Shard> shard, final YangInstanceIdentifier id,
258 final NormalizedNode<?,?> node) throws InterruptedException, ExecutionException {
259 writeToStore(shard.underlyingActor().getDataStore(), id, node);
262 public static void writeToStore(final ShardDataTree store, final YangInstanceIdentifier id,
263 final NormalizedNode<?,?> node) throws InterruptedException, ExecutionException {
264 ReadWriteShardDataTreeTransaction transaction = store.newReadWriteTransaction("writeToStore", null);
266 transaction.getSnapshot().write(id, node);
267 ShardDataTreeCohort cohort = transaction.ready();
268 cohort.canCommit().get();
269 cohort.preCommit().get();
273 public static void writeToStore(final DataTree store, final YangInstanceIdentifier id,
274 final NormalizedNode<?,?> node) throws DataValidationFailedException {
275 DataTreeModification transaction = store.takeSnapshot().newModification();
277 transaction.write(id, node);
279 store.validate(transaction);
280 final DataTreeCandidate candidate = store.prepare(transaction);
281 store.commit(candidate);
284 @SuppressWarnings("serial")
285 public static final class DelegatingShardCreator implements Creator<Shard> {
286 private final Creator<Shard> delegate;
288 DelegatingShardCreator(final Creator<Shard> delegate) {
289 this.delegate = delegate;
293 public Shard create() throws Exception {
294 return delegate.create();