Chapter 5. Tutorials

Important

It is recommended that you shut down and restart the GUI for each of the following tutorials, to ensure clean caches every time.

5.1. Caches and Nodes

For this tutorial, start a single instance of the GUI. In this tutorial, we will:
  • Create nodes under the root node.
  • Remove nodes under the root node, both individually and recursively.
  • Add and remove data from nodes.
1. Set up the Fqns you need. In the BeanShell pane, create 3 Fqn variables:
   childFqn1 = Fqn.fromString("/child1");
   childFqn2 = Fqn.fromString("/child2");
   childFqn3 = Fqn.fromString("/child2/child3");
2. Create child nodes under the root node.
   child1 = root.addChild(childFqn1);
   child2 = root.addChild(childFqn2);
   child3 = root.addChild(childFqn3);
3. Query the nodes.
   root.hasChild(childFqn1); // should return true
   child2.hasChild(childFqn3.getLastElement()); // should return true
   child3.getParent(); // should return child2
   child2.getParent(); // should return root
4. Put some data in the nodes. By selecting the nodes in the tree view, you should see the contents of each node.
   child1.put("key1", "value1");
   child1.put("key2", "value2");
   child2.put("key3", "value3");
   child2.put("key4", "value4");
   child3.put("key5", "value5");
   child3.put("key6", "value6");
5. Query some of the data.
   child1.getKeys();
   child2.getData();
6. Remove some data in the nodes.
   child1.remove("key1");
   child2.remove("key3");
   child3.clearData();
7. Delete nodes
root.removeChild(childFqn1); // will also remove any data held under child1
root.removeChild(childFqn2); // will recursively remove child3 as well