Moving or Inserting Nodes | HCL Digital Experience
To move existing nodes or insert new nodes, use the insert() method of the controller.
About this task
- When you create a node, you must insert it into the topology of the model, for example, to make it visible and accessible for users.
- Operations that you defined on the controller itself, such as
hasChildren()orgetLayoutModelController(), work only after you insert the node.
Procedure
- Obtain an appropriate controller.
- Identify the target location in the topology. You must have that information in a later step.
- Identify the resource that you want to move or insert as
follows:
- For moving a resource, locate an existing node with the appropriate locators of the controller.
- For inserting a resource, create a modifiable instance that represents a new resource.
-
Insert the resource into the topology of the controller by using its
insert()method and by specifying its target location. This resource can be one of the following list:- A parent node. In this case, the resource is inserted as the last child of the parent node.
- A parent node and a sibling node. In this case, the resource is inserted as the child of the parent node in a position immediately before the sibling node.
- No location information at all. In this case, the resource is inserted as a new root.
Note: This insertion is not possible for all controllers. For example, you cannot insert a new root node into a
ContentModelControllerthat has a root node already.
-
Persist your modifications by using the
commit()method of the controller.
Example
Example 1 - Moving an existing portlet to a different container (error handling
omitted):
// obtain locator of LayoutModelController
final Locator locator = lmController.getLocator();
// locate portlet and target containers
final LayoutControl control = (LayoutControl) locator.findByUniqueName("MyControl");
final LayoutContainer parentContainer = (LayoutContainer) locator.findByUniqueName("MyParentContainer");
final LayoutContainer nextContainer = (LayoutContainer) locator.findByUniqueName("MyNextContainer");
// move portlet under parentContainer just before nextContainer
lmController.insert(control, parentContainer, nextContainer);