Sling Resource merger in aem is one of the most commonly and frequently used feature of sling after aem 6.0. Due to limited functionality of touch ui components, we often are required to overlay/ override a component from /libs to /apps. Earlier (before aem 6.0) in case of overlay we need to copy paste entire component structure with node type and properties and then we make our changes which indirectly increases the overhead on /apps folder.
But as adobe is promoting to use its new touch optimized ui for granite components , it have changed the definition of overlay for Touch ui (Granite) components where you need to create only similar skeleton structure (where nodes can be of type nt:unstructured) and you can add, remove or modify existing node.
After Completing this tutorial you will have a clear understanding of:-
- What is Sling Resource Merger.
- Whats the difference between overlay, override and sling resource merger
- How to overlay a component using sling resource merger.
Sling resource merger in aem provide us the flexibility to have merged view of multiple other resources. The exact merging mechanism will depends on the resource picker implementation that we are using (i.e. Overlay or Override). It is a part of sling framework and available under Felix console by name (org.apache.sling.resourcemerger). To understand in detail how sling handles resource merging you can visit Sling Resource Merger.
By using Sling Resource Merger we can:-
- remove existing resource/properties from the underlying resources.
- modify existing properties/child resources of the underlying resources.
- add new properties/child resources.
With AEM 6.0 onwards for Non Granite Overlay(Classic UI) and Before AEM 6.0 Overlay is used in below manner as only classic UI was supported:-
Usually when you have to overlay a component in AEM, then you copy component from /libs/ folder to /apps/ folder. And you can write your own customization on it like changing title,add or remove node or change layout of newly copied components under /apps/.
As per the default OSGI preferences AEM uses a search path to find a resource, searching first the /apps/ branch and then the /libs branch so your newly copied components under /apps/ gets priority over /libs/. But you change this preference any time from Felix console by modifying Apache Sling Resource Resolver Factory configuration(not recommended). Overlay works on the principle of search path.
One more important thing to note about overlay is that when you overlay a component your both component that is apps and libs will be displayed in side kick.
With AEM 6.0 onwards, after introduction of Touch UI for Granite related overlay we are using Sling Resource Merger:-
Now if we have to overlay a component or use sling resource merger for a component then we need not required to copy paste entire component structure with node properties from libs to apps. We only need to recreate the skeleton structure. To simplify the recreation of the structure all intermediary nodes can be of type nt:unstructured (they do not have to reflect the original node type; for example, in /libs).
Note:- Sling Resource Merger and its related methods can only be used with granite(touch ui) components.
The advantages of using the Sling Resource Merger in AEM is to:
- ensure that customization changes are not made in /libs.
- reduce the structure that is replicated from /libs.
Override a component in AEM:-
Overriding a component is basically extending or inheriting the component using sling:resourceSuperType property. You can override a component from /libs by creating a custom component under apps manually and adding all necessary nodes and setting value of sling:superResourceType property to that component will inherit all the feature from /libs/ component, even after upgrade you still inherit the features of image component.
Here we can use the sling:superResourceType for any component that you want to inherit functionality (example from projectA component to ProjectB etc., not only restricted to libs).
When to use overlay/sling resource merger and when to use override totally depends upon your requirement.
In this section we are going to see how to overlay a component using sling resource merger in aem.
Example -1 Suppose we have to overlay the Project related node jcr:title value which is under /libs/ to /apps
- Login to Crxde.
- Go to /libs/cq/core/content/nav/projects.
- Right click on Projects Node.
- Select Overlay Node.
- For safer side always select Match Node Types.
- Click Ok.
- Go to /apps/cq/core/content/nav/projects
- Select project node and add below property
- Name – jcr:title
- type – String
- Value – Test-Project
- Click SaveAll.
- Now go to http://localhost:4502/projects.html/content/projects
Congratulations You have used Sling Resource Merger in AEM 6.2.
Note:- This is a very basic example of Sling resource merger. Some times it might happen that after overlaying the node changes are not getting reflected, means if you change in libs changes are working but not from apps. That means sling resource merger is not working properly.
In such chance you might need to add url = url.replace(“/libs/”,”/mnt/overlay/”); to tell sling explicitly to merge resource. The location of this line that you have to add depends on which component is not working usually it is in your foundation component js file. This i think is a sling resource merger bug and they will fix it soon.