You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@curator.apache.org by ra...@apache.org on 2017/10/04 14:02:04 UTC

[4/8] curator git commit: Abstracted the TreeCache public API and then an alternate implementation that uses the new CuratorCache instead of TreeCache. This should make porting older code much easier

http://git-wip-us.apache.org/repos/asf/curator/blob/02073a71/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapper.java
----------------------------------------------------------------------
diff --git a/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapper.java b/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapper.java
new file mode 100644
index 0000000..cfb897d
--- /dev/null
+++ b/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapper.java
@@ -0,0 +1,500 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.curator.framework.recipes.cache;
+
+import com.google.common.collect.ImmutableSet;
+import org.apache.curator.framework.recipes.cache.TreeCacheEvent.Type;
+import org.apache.curator.framework.recipes.watch.CacheSelectors;
+import org.apache.curator.framework.recipes.watch.CuratorCache;
+import org.apache.curator.framework.recipes.watch.CuratorCacheBuilder;
+import org.apache.curator.test.compatibility.KillSession2;
+import org.apache.zookeeper.CreateMode;
+import org.testng.Assert;
+import org.testng.annotations.Test;
+
+public class TestTreeCacheBridgeWrapper extends BaseTestTreeCache<CuratorCache>
+{
+    @Test
+    public void testSelector() throws Exception
+    {
+        client.create().forPath("/root");
+        client.create().forPath("/root/n1-a");
+        client.create().forPath("/root/n1-b");
+        client.create().forPath("/root/n1-b/n2-a");
+        client.create().forPath("/root/n1-b/n2-b");
+        client.create().forPath("/root/n1-b/n2-b/n3-a");
+        client.create().forPath("/root/n1-c");
+        client.create().forPath("/root/n1-d");
+
+        TreeCacheSelector selector = new TreeCacheSelector()
+        {
+            @Override
+            public boolean traverseChildren(String fullPath)
+            {
+                return !fullPath.equals("/root/n1-b/n2-b");
+            }
+
+            @Override
+            public boolean acceptChild(String fullPath)
+            {
+                return !fullPath.equals("/root/n1-c");
+            }
+        };
+        cache = buildCacheWithListeners(CuratorCacheBuilder.builder(client, "/root").withCacheSelector(SelectorBridge.wrap(selector)));
+        cache.start();
+
+        assertEvent(Type.NODE_ADDED, "/root");
+        assertEvent(Type.NODE_ADDED, "/root/n1-a");
+        assertEvent(Type.NODE_ADDED, "/root/n1-b");
+        assertEvent(Type.NODE_ADDED, "/root/n1-d");
+        assertEvent(Type.NODE_ADDED, "/root/n1-b/n2-a");
+        assertEvent(Type.NODE_ADDED, "/root/n1-b/n2-b");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testStartup() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/1", "one".getBytes());
+        client.create().forPath("/test/2", "two".getBytes());
+        client.create().forPath("/test/3", "three".getBytes());
+        client.create().forPath("/test/2/sub", "two-sub".getBytes());
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/1", "one".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/2", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/3", "three".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/2/sub", "two-sub".getBytes());
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("1", "2", "3"));
+        Assert.assertEquals(cache.childrenAtPath("/test/1").keySet(), ImmutableSet.of());
+        Assert.assertEquals(cache.childrenAtPath("/test/2").keySet(), ImmutableSet.of("sub"));
+        Assert.assertNull(cache.get("/test/non_exist"));
+    }
+
+    @Test
+    public void testStartEmpty() throws Exception
+    {
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test");
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testStartEmptyDeeper() throws Exception
+    {
+        cache = newCacheWithListeners(client, "/test/foo/bar");
+        cache.start();
+        assertEvent(Type.INITIALIZED);
+
+        client.create().creatingParentsIfNeeded().forPath("/test/foo");
+        assertNoMoreEvents();
+        client.create().forPath("/test/foo/bar");
+        assertEvent(Type.NODE_ADDED, "/test/foo/bar");
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testDepth0() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/1", "one".getBytes());
+        client.create().forPath("/test/2", "two".getBytes());
+        client.create().forPath("/test/3", "three".getBytes());
+        client.create().forPath("/test/2/sub", "two-sub".getBytes());
+
+        CuratorCacheBuilder builder = CuratorCacheBuilder.builder(client, "/test").withCacheSelector(CacheSelectors.maxDepth(0));
+        cache = buildCacheWithListeners(builder);
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of());
+        Assert.assertNull(cache.get("/test/1"));
+        Assert.assertNull(cache.get("/test/1"));
+        Assert.assertNull(cache.get("/test/non_exist"));
+    }
+
+    @Test
+    public void testDepth1() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/1", "one".getBytes());
+        client.create().forPath("/test/2", "two".getBytes());
+        client.create().forPath("/test/3", "three".getBytes());
+        client.create().forPath("/test/2/sub", "two-sub".getBytes());
+
+        CuratorCacheBuilder builder = CuratorCacheBuilder.builder(client, "/test").withCacheSelector(CacheSelectors.maxDepth(1));
+        cache = buildCacheWithListeners(builder);
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/1", "one".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/2", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/3", "three".getBytes());
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("1", "2", "3"));
+        Assert.assertEquals(cache.childrenAtPath("/test/1").keySet(), ImmutableSet.of());
+        Assert.assertEquals(cache.childrenAtPath("/test/2").keySet(), ImmutableSet.of());
+        Assert.assertNull(cache.get("/test/1/sub"));
+        Assert.assertNull(cache.get("/test/2/sub"));
+        Assert.assertNull(cache.get("/test/non_exist"));
+    }
+
+    @Test
+    public void testDepth1Deeper() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/foo");
+        client.create().forPath("/test/foo/bar");
+        client.create().forPath("/test/foo/bar/1", "one".getBytes());
+        client.create().forPath("/test/foo/bar/2", "two".getBytes());
+        client.create().forPath("/test/foo/bar/3", "three".getBytes());
+        client.create().forPath("/test/foo/bar/2/sub", "two-sub".getBytes());
+
+        CuratorCacheBuilder builder = CuratorCacheBuilder.builder(client, "/test/foo/bar").withCacheSelector(CacheSelectors.maxDepth(1));
+        cache = buildCacheWithListeners(builder);
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test/foo/bar");
+        assertEvent(Type.NODE_ADDED, "/test/foo/bar/1", "one".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo/bar/2", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo/bar/3", "three".getBytes());
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testAsyncInitialPopulation() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/one", "hey there".getBytes());
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testFromRoot() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/one", "hey there".getBytes());
+
+        cache = newCacheWithListeners(client, "/");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/");
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertTrue(cache.childrenAtPath("/").keySet().contains("test"));
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("one"));
+        Assert.assertEquals(cache.childrenAtPath("/test/one").keySet(), ImmutableSet.of());
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "hey there");
+    }
+
+    @Test
+    public void testFromRootWithDepth() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/one", "hey there".getBytes());
+
+        CuratorCacheBuilder builder = CuratorCacheBuilder.builder(client, "/").withCacheSelector(CacheSelectors.maxDepth(1));
+        cache = buildCacheWithListeners(builder);
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/");
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertTrue(cache.childrenAtPath("/").keySet().contains("test"));
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of());
+        Assert.assertNull(cache.get("/test/one"));
+        Assert.assertNull(cache.get("/test/one"));
+    }
+
+    @Test
+    public void testWithNamespace() throws Exception
+    {
+        client.create().forPath("/outer");
+        client.create().forPath("/outer/foo");
+        client.create().forPath("/outer/test");
+        client.create().forPath("/outer/test/one", "hey there".getBytes());
+
+        cache = newCacheWithListeners(client.usingNamespace("outer"), "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("one"));
+        Assert.assertEquals(cache.childrenAtPath("/test/one").keySet(), ImmutableSet.of());
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "hey there");
+    }
+
+    @Test
+    public void testWithNamespaceAtRoot() throws Exception
+    {
+        client.create().forPath("/outer");
+        client.create().forPath("/outer/foo");
+        client.create().forPath("/outer/test");
+        client.create().forPath("/outer/test/one", "hey there".getBytes());
+
+        cache = newCacheWithListeners(client.usingNamespace("outer"), "/");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/");
+        assertEvent(Type.NODE_ADDED, "/foo");
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+        Assert.assertEquals(cache.childrenAtPath("/").keySet(), ImmutableSet.of("foo", "test"));
+        Assert.assertEquals(cache.childrenAtPath("/foo").keySet(), ImmutableSet.of());
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("one"));
+        Assert.assertEquals(cache.childrenAtPath("/test/one").keySet(), ImmutableSet.of());
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "hey there");
+    }
+
+    @Test
+    public void testSyncInitialPopulation() throws Exception
+    {
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test");
+        client.create().forPath("/test/one", "hey there".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testChildrenInitialized() throws Exception
+    {
+        client.create().forPath("/test", "".getBytes());
+        client.create().forPath("/test/1", "1".getBytes());
+        client.create().forPath("/test/2", "2".getBytes());
+        client.create().forPath("/test/3", "3".getBytes());
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/1");
+        assertEvent(Type.NODE_ADDED, "/test/2");
+        assertEvent(Type.NODE_ADDED, "/test/3");
+        assertEvent(Type.INITIALIZED);
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testUpdateWhenNotCachingData() throws Exception
+    {
+        client.create().forPath("/test");
+
+        cache = buildCacheWithListeners(CuratorCacheBuilder.builder(client, "/test").withCacheSelector(CacheSelectors.statOnly()));
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test/foo", "first".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+
+        client.setData().forPath("/test/foo", "something new".getBytes());
+        assertEvent(Type.NODE_UPDATED, "/test/foo");
+        assertNoMoreEvents();
+
+        Assert.assertNotNull(cache.get("/test/foo"));
+        // No byte data querying the tree because we're not caching data.
+        Assert.assertEquals(cache.get("/test/foo").getData().length, 0);
+    }
+
+    @Test
+    public void testDeleteThenCreate() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/foo", "one".getBytes());
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+        assertEvent(Type.INITIALIZED);
+
+        client.delete().forPath("/test/foo");
+        assertEvent(Type.NODE_REMOVED, "/test/foo", "one".getBytes());
+        client.create().forPath("/test/foo", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+
+        client.delete().forPath("/test/foo");
+        assertEvent(Type.NODE_REMOVED, "/test/foo", "two".getBytes());
+        client.create().forPath("/test/foo", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testDeleteThenCreateRoot() throws Exception
+    {
+        client.create().forPath("/test");
+        client.create().forPath("/test/foo", "one".getBytes());
+
+        cache = newCacheWithListeners(client, "/test/foo");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+        assertEvent(Type.INITIALIZED);
+
+        client.delete().forPath("/test/foo");
+        assertEvent(Type.NODE_REMOVED, "/test/foo");
+        client.create().forPath("/test/foo", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+
+        client.delete().forPath("/test/foo");
+        assertEvent(Type.NODE_REMOVED, "/test/foo");
+        client.create().forPath("/test/foo", "two".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testKilledSession() throws Exception
+    {
+        client.create().forPath("/test");
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test/foo", "foo".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/foo");
+        client.create().withMode(CreateMode.EPHEMERAL).forPath("/test/me", "data".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/me");
+
+        KillSession2.kill(client.getZookeeperClient().getZooKeeper());
+        assertEvent(Type.CONNECTION_LOST);
+        assertEvent(Type.CONNECTION_RECONNECTED);
+        assertEvent(Type.INITIALIZED);
+        assertEvent(Type.NODE_REMOVED, "/test/me", "data".getBytes());
+
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testBasics() throws Exception
+    {
+        client.create().forPath("/test");
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of());
+        Assert.assertNull(cache.get("/t"));
+        Assert.assertNull(cache.get("/testing"));
+
+        client.create().forPath("/test/one", "hey there".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("one"));
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "hey there");
+        Assert.assertEquals(cache.childrenAtPath("/test/one").keySet(), ImmutableSet.of());
+        Assert.assertNull(cache.get("/test/o"));
+        Assert.assertNull(cache.get("/test/onely"));
+
+        client.setData().forPath("/test/one", "sup!".getBytes());
+        assertEvent(Type.NODE_UPDATED, "/test/one");
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of("one"));
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "sup!");
+
+        client.delete().forPath("/test/one");
+        assertEvent(Type.NODE_REMOVED, "/test/one", "sup!".getBytes());
+        Assert.assertEquals(cache.childrenAtPath("/test").keySet(), ImmutableSet.of());
+
+        assertNoMoreEvents();
+    }
+
+    @Test
+    public void testDeleteNodeAfterCloseDoesntCallExecutor() throws Exception
+    {
+        client.create().forPath("/test");
+
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test/one", "hey there".getBytes());
+        assertEvent(Type.NODE_ADDED, "/test/one");
+        Assert.assertEquals(new String(cache.get("/test/one").getData()), "hey there");
+
+        cache.close();
+        assertNoMoreEvents();
+
+        client.delete().forPath("/test/one");
+        assertNoMoreEvents();
+    }
+
+    /**
+     * Make sure TreeCache gets to a sane state when we can't initially connect to server.
+     */
+    @Test
+    public void testServerNotStartedYet() throws Exception
+    {
+        // Stop the existing server.
+        server.stop();
+
+        // Shutdown the existing client and re-create it started.
+        client.close();
+        initCuratorFramework();
+
+        // Start the client disconnected.
+        cache = newCacheWithListeners(client, "/test");
+        cache.start();
+        assertNoMoreEvents();
+
+        // Now restart the server.
+        server.restart();
+        assertEvent(Type.INITIALIZED);
+
+        client.create().forPath("/test");
+
+        assertEvent(Type.NODE_ADDED, "/test");
+        assertNoMoreEvents();
+    }
+}

http://git-wip-us.apache.org/repos/asf/curator/blob/02073a71/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapperRandomTree.java
----------------------------------------------------------------------
diff --git a/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapperRandomTree.java b/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapperRandomTree.java
new file mode 100644
index 0000000..03d0999
--- /dev/null
+++ b/curator-recipes/src/test/java/org/apache/curator/framework/recipes/cache/TestTreeCacheBridgeWrapperRandomTree.java
@@ -0,0 +1,224 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.curator.framework.recipes.cache;
+
+import com.google.common.collect.Iterables;
+import org.apache.curator.framework.CuratorFramework;
+import org.apache.curator.framework.recipes.watch.CachedNode;
+import org.apache.curator.framework.recipes.watch.CuratorCache;
+import org.apache.curator.utils.ZKPaths;
+import org.testng.Assert;
+import org.testng.annotations.Test;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Random;
+
+public class TestTreeCacheBridgeWrapperRandomTree extends BaseTestTreeCache<CuratorCache>
+{
+    /**
+     * A randomly generated source-of-truth node for {@link #testGiantRandomDeepTree()}
+     */
+    private static final class TestNode
+    {
+        String fullPath;
+        byte[] data;
+        Map<String, TestNode> children = new HashMap<String, TestNode>();
+
+        TestNode(String fullPath, byte[] data)
+        {
+            this.fullPath = fullPath;
+            this.data = data;
+        }
+    }
+
+    // These constants will produce a tree about 10 levels deep.
+    private static final int ITERATIONS = 1000;
+    private static final double DIVE_CHANCE = 0.9;
+    private static final int TEST_DEPTH = 5;
+
+    private final Random random = new Random();
+    private boolean withDepth = false;
+
+    /**
+     * Randomly construct a large tree of test data in memory, mirror it into ZK, and then use
+     * a TreeCache to follow the changes.  At each step, assert that TreeCache matches our
+     * source-of-truth test data, and that we see exactly the set of events we expect to see.
+     */
+
+    @Test
+    public void testGiantRandomDeepTree() throws Exception {
+        client.create().forPath("/tree", null);
+        CuratorFramework cl = client.usingNamespace("tree");
+        cache = newCacheWithListeners(cl, "/");
+        cache.start();
+        assertEvent(TreeCacheEvent.Type.NODE_ADDED, "/");
+        assertEvent(TreeCacheEvent.Type.INITIALIZED);
+
+        TestNode root = new TestNode("/", new byte[0]);
+        int maxDepth = 0;
+        int adds = 0;
+        int removals = 0;
+        int updates = 0;
+
+        for ( int i = 0; i < ITERATIONS; ++i )
+        {
+            // Select a node to update, randomly navigate down through the tree
+            int depth = 0;
+            TestNode last = null;
+            TestNode node = root;
+            while ( !node.children.isEmpty() && random.nextDouble() < DIVE_CHANCE )
+            {
+                // Go down a level in the tree.  Select a random child for the next iteration.
+                last = node;
+                node = Iterables.get(node.children.values(), random.nextInt(node.children.size()));
+                ++depth;
+            }
+            maxDepth = Math.max(depth, maxDepth);
+
+            // Okay we found a node, let's do something interesting with it.
+            switch ( random.nextInt(3) )
+            {
+            case 0:
+                // Try a removal if we have no children and we're not the root node.
+                if ( node != root && node.children.isEmpty() )
+                {
+                    // Delete myself from parent.
+                    TestNode removed = last.children.remove(ZKPaths.getNodeFromPath(node.fullPath));
+                    Assert.assertSame(node, removed);
+
+                    // Delete from ZK
+                    cl.delete().forPath(node.fullPath);
+
+                    // TreeCache should see the delete.
+                    if (shouldSeeEventAt(node.fullPath))
+                    {
+                        assertEvent(TreeCacheEvent.Type.NODE_REMOVED, node.fullPath);
+                    }
+                    ++removals;
+                }
+                break;
+            case 1:
+                // Do an update.
+                byte[] newData = new byte[10];
+                random.nextBytes(newData);
+
+                if ( Arrays.equals(node.data, newData) )
+                {
+                    // Randomly generated the same data! Very small chance, just skip.
+                    continue;
+                }
+
+                // Update source-of-truth.
+                node.data = newData;
+
+                // Update in ZK.
+                cl.setData().forPath(node.fullPath, node.data);
+
+                // TreeCache should see the update.
+                if (shouldSeeEventAt(node.fullPath))
+                {
+                    assertEvent(TreeCacheEvent.Type.NODE_UPDATED, node.fullPath, node.data);
+                }
+
+                ++updates;
+                break;
+            case 2:
+                // Add a new child.
+                String name = Long.toHexString(random.nextLong());
+                if ( node.children.containsKey(name) )
+                {
+                    // Randomly generated the same name! Very small chance, just skip.
+                    continue;
+                }
+
+                // Add a new child to our test tree.
+                byte[] data = new byte[10];
+                random.nextBytes(data);
+                TestNode child = new TestNode(ZKPaths.makePath(node.fullPath, name), data);
+                node.children.put(name, child);
+
+                // Add to ZK.
+                cl.create().forPath(child.fullPath, child.data);
+
+                // TreeCache should see the add.
+                if (shouldSeeEventAt(child.fullPath))
+                {
+                    assertEvent(TreeCacheEvent.Type.NODE_ADDED, child.fullPath, child.data);
+                }
+
+                ++adds;
+                break;
+            }
+
+            // Each iteration, ensure the cached state matches our source-of-truth tree.
+            assertNodeEquals(ListenerBridge.toData("/", cache.get("/")), root);
+            assertTreeEquals(cache, root, 0);
+        }
+
+        // Typical stats for this test: maxDepth: 10, adds: 349, removals: 198, updates: 320
+        // We get more adds than removals because removals only happen if we're at a leaf.
+        System.out.println(String.format("maxDepth: %s, adds: %s, removals: %s, updates: %s", maxDepth, adds, removals, updates));
+        assertNoMoreEvents();
+    }
+
+    /**
+     * Returns true we should see an event at this path based on maxDepth, false otherwise.
+     */
+    private boolean shouldSeeEventAt(String fullPath)
+    {
+        return !withDepth || ZKPaths.split(fullPath).size() <= TEST_DEPTH;
+    }
+
+    /**
+     * Recursively assert that current children equal expected children.
+     */
+    private void assertTreeEquals(CuratorCache cache, TestNode expectedNode, int depth)
+    {
+        String path = expectedNode.fullPath;
+        Map<String, CachedNode> cacheChildren = cache.childrenAtPath(path);
+        Assert.assertNotNull(cacheChildren, path);
+
+        if (withDepth && depth == TEST_DEPTH) {
+            return;
+        }
+
+        Assert.assertEquals(cacheChildren.keySet(), expectedNode.children.keySet(), path);
+
+        for ( Map.Entry<String, TestNode> entry : expectedNode.children.entrySet() )
+        {
+            String nodeName = entry.getKey();
+            CachedNode childData = cacheChildren.get(nodeName);
+            TestNode expectedChild = entry.getValue();
+            assertNodeEquals(ListenerBridge.toData(expectedChild.fullPath, childData), expectedChild);
+            assertTreeEquals(cache, expectedChild, depth + 1);
+        }
+    }
+
+    /**
+     * Assert that the given node data matches expected test node data.
+     */
+    private static void assertNodeEquals(ChildData actualChild, TestNode expectedNode)
+    {
+        String path = expectedNode.fullPath;
+        Assert.assertNotNull(actualChild, path);
+        Assert.assertEquals(actualChild.getData(), expectedNode.data, path);
+    }
+}