Expand my Community achievements bar.

July 31st AEM Gems Webinar: Elevate your AEM development to master the integration of private GitHub repositories within AEM Cloud Manager.

Creation of Content Fragments through Rest client (Postman)


Community Advisor


AEM Discussions

Creation of Content Fragments through Rest client (Postman)

  by <Sivakumar Kanoori>


Creation of Content Fragments through Rest client (Postman)

Adobe Experience Manager (AEM) Content Fragments are text-based editorial content that may include some structured data elements associated but considered pure content without design or layout information. Content Fragments are typically created as channel-agnostic content, that is intended to be used and re-used across channels, which in turn wrap the content in a context-specific experience.


Content Fragments, independent of layout, can be used directly in AEM Sites with Core Components or can be delivered in a headless manner to downstream channels.

  1. Using Content Fragments on web pages
  2. Exposing Content Fragments as JSON using AEM Content Services

Manual Creation of content fragments :



Here, we can see how we can create the content fragments using existing Models through rest client :


  1. Develop the AEM Servlet : It Should be Post.
@component(service = { Servlet.class }, property = { “sling.servlet.paths=/bin/cfCreation”,“sling.servlet.methods=” + HttpConstants.METHOD_POST })

public class ContentFragmentCreationServlet extends SlingAllMethodsServlet
public void doPost(SlingHttpServletRequest request, SlingHttpServletResponse response) {

JsonElement createParams = null;
createParams = getPayloadFromRequest(request);
ResourceResolver resolver = request.getResourceResolver();

	private JsonElement getPayloadFromRequest(SlingHttpServletRequest request) throws InvalidParameterException {
		try (BufferedReader br = new BufferedReader(
				new InputStreamReader(request.getInputStream(), StandardCharsets.UTF_8))) {
			String requestParams = br.lines().collect(Collectors.joining());
			return new Gson().getAdapter(JsonElement.class).fromJson(new StringReader(requestParams));
		} catch (IOException exc) {
			LOG.error("Error Reading input Parameters", exc);
			throw new InvalidParameterException("Failed to read parameters from request");
		} catch (JsonSyntaxException exc) {
			LOG.error("Error Reading input Parameters: invalid json");
			throw new InvalidParameterException("Invalid json");

@component(service = { Servlet.class }, property = { “sling.servlet.paths=/bin/cfCreation”,“sling.servlet.methods=” + HttpConstants.METHOD_POST })

public class ContentFragmentCreationServlet extends SlingAllMethodsServlet

public void doPost(SlingHttpServletRequest request, SlingHttpServletResponse response) {





2. In the JSON body, you can send which model can be used , content properties, metadata .

contentModelPath : send as a JSON parameter as body.

3. Resource template = resolver.getResource(contentModelPath);

String contentModelPath = createParams.get("model");
Resource template = resolver.getResource(contentModelPath);
FragmentTemplate fragmentTemplate = getFragmentTemplate(template);
private FragmentTemplate getFragmentTemplate(Resource template) {
FragmentTemplate fragmentTemplate = template.adaptTo(FragmentTemplate.class);
if (null == fragmentTemplate) {
Resource jcrContentResource = template.getChild(JcrConstants.JCR_CONTENT);
if (null != jcrContentResource) {
fragmentTemplate = jcrContentResource.adaptTo(FragmentTemplate.class);
return fragmentTemplate;

 3. FragmentTemplate.createTemplate(resource,name,title) will create the content fragment.

//cfLocation:under which path, it should create the content fragment 
//you can send as JSON body paramter or create osgi config and get the content type location
Node path = JcrUtils.getOrCreateByPath(cfLocation, JcrResourceConstants.NT_SLING_FOLDER,
folderResource = resolver.getResource(path.getPath());

ContentFragment  contentFragment = fragmentTemplate.createFragment(folderResource , name, title);
//name , title can send as paramters in JSON body request


Once content fragment has been created , now update the metadata and content properties.

	updateMetadata(contentFragment, metadata);
	updateContentProperties(contentFragment, contentProperties, resolver);


private void updateMetadata(final ContentFragment contentFragment, JsonObject metadata) {
   Iterator<Entry<String, JsonElement>> entrySet = metadata.entrySet().iterator();
   entrySet.forEachRemaining(next -> {
   try {
  contentFragment.setMetaData(next.getKey(), next.getValue().getAsString());
   } catch (ContentFragmentException e) {

private void updateContentProperties(ContentFragment contentFragment, JsonObject, contentProperties,ResourceResolver resolver) throws Exception {
LOG.info("updateContentProperties:contentProperties::" + contentProperties);
Iterator<ElementTemplate> eleTemplates = contentFragment.getTemplate().getElements();
LOG.info("updateContentProperties eleTemplates" + eleTemplates);
while (eleTemplates.hasNext()) {
ElementTemplate nextEle = eleTemplates.next();
LOG.info("Processing NextEle - {}", nextEle.getName());
setElementValue(nextEle, contentFragment, contentProperties, resolver);

private void setElementValue(ElementTemplate nextEle, ContentFragment contentFragment, JsonObject contentObject,
ResourceResolver resolver) throws Exception {
if (null != contentObject && contentObject.has(nextEle.getName())) {
ContentElement contentElement = contentFragment.getElement(nextEle.getName());
FragmentData fragmentData = contentElement.getValue();
LOG.info("nextEle ::{}", nextEle.getName());
LOG.info("fragmentData Value::{}", fragmentData.getValue());
JsonElement propertyElement = contentObject.get(contentElement.getName());
String propertyValue = propertyElement.getAsString();
LOG.info("propertyValue:{}", propertyValue);
JsonArray arr = new JsonArray();
LOG.info("arr:{}", arr);
if (null == contentElement) {
try {
contentElement = contentFragment.createElement(nextEle);
} catch (ContentFragmentException exc) {
LOG.error("Exception while setting element value: " + nextEle.getName(), exc);
throw new Exception("Failed to set element value: " + nextEle.getName());
Now, you can see content fragment with updated properties and metadata values. 
Still you Can write your logic to publish, update the existing content fragments.


Please use this thread to ask questions relating to this article

1 Comment