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