Interface DAMContentFragment
-
- All Superinterfaces:
ComponentExporter
- All Known Subinterfaces:
ContentFragment
@ConsumerType public interface DAMContentFragment extends ComponentExporter
Defines the API for a DAM content fragment used by thecontent fragment componentand thecontent fragment list component. The model provides information about the referenced content fragment and access to representations of its elements.- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interfaceDAMContentFragment.DAMContentElementRepresents a content element of a content fragment.
-
Field Summary
Fields Modifier and Type Field Description static StringJSON_PN_ELEMENTSName of the property (in JSON export) that provides an object containing the elements of the content fragment; the keys of the object properties refer to the element namesstatic StringJSON_PN_ELEMENTS_ORDERName of the property (in JSON export) that provides an array containing the names of the elements of the content fragment in the correct orderstatic StringJSON_PN_MODELName of the property (in JSON export) that provides the path to the model of the content fragment
-
Method Summary
All Methods Instance Methods Default Methods Modifier and Type Method Description default @Nullable List<Resource>getAssociatedContent()Returns a list of resources representing the collections that are associated to this content fragment.default @Nullable StringgetDescription()Returns the description of the content fragment.default @NotNull StringgetEditorJSON()Returns a JSON format string containing information about this fragment.default @Nullable List<DAMContentFragment.DAMContentElement>getElements()Returns a list of content fragment elements.default @NotNull Map<String,DAMContentFragment.DAMContentElement>getExportedElements()Returns a map of elements that are used for creating the JSON export.default @NotNull String[]getExportedElementsOrder()Returns the names of the elements in the correct order.default @NotNull StringgetExportedType()Returns the type of the resource for which the export is performed.default @NotNull StringgetName()Returns the technical name of the content fragment.default @Nullable StringgetTitle()Returns the title of the content fragment.default @Nullable StringgetType()Returns the type of the content fragment.
-
-
-
Field Detail
-
JSON_PN_MODEL
static final String JSON_PN_MODEL
Name of the property (in JSON export) that provides the path to the model of the content fragment- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
- Constant Field Values
-
JSON_PN_ELEMENTS
static final String JSON_PN_ELEMENTS
Name of the property (in JSON export) that provides an object containing the elements of the content fragment; the keys of the object properties refer to the element names- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
- Constant Field Values
-
JSON_PN_ELEMENTS_ORDER
static final String JSON_PN_ELEMENTS_ORDER
Name of the property (in JSON export) that provides an array containing the names of the elements of the content fragment in the correct order- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
- Constant Field Values
-
-
Method Detail
-
getTitle
@Nullable default @Nullable String getTitle()
Returns the title of the content fragment.- Returns:
- the title of the content fragment
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
ContentFragment.getTitle()
-
getName
@NotNull default @NotNull String getName()
Returns the technical name of the content fragment.- Returns:
- the technical name of the content fragment
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.3.0
- See Also:
ContentFragment.getName()
-
getDescription
@Nullable default @Nullable String getDescription()
Returns the description of the content fragment.- Returns:
- the description of the content fragment
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
ContentFragment.getDescription()
-
getType
@Nullable default @Nullable String getType()
Returns the type of the content fragment. The type is a string that uniquely identifies the model or template of the content fragment (e.g. "my-project/models/my-model" for a structured or "/content/dam/my-cf/jcr:content/model" for a text-only content fragment).- Returns:
- the type of the content fragment
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
getElements
@Nullable default @Nullable List<DAMContentFragment.DAMContentElement> getElements()
Returns a list of content fragment elements. The list contains the elements whose names are specified in the propertyContentFragment.PN_ELEMENT_NAMES(in that order, and skipping non-existing elements). IfContentFragment.PN_ELEMENT_NAMESis not set, then all elements are returned, in the order in which they occur in the content fragment.- Returns:
- a selection or all of the content fragment's elements
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
ContentFragment.getElements()
-
getExportedElements
@NotNull default @NotNull Map<String,DAMContentFragment.DAMContentElement> getExportedElements()
Returns a map of elements that are used for creating the JSON export. The keys of the map determine the name of the element. The value holds the Sling Model that is used for the export. The map only contains elements that are configured through the propertyContentFragment.PN_ELEMENT_NAMESor all elements if the property is not set.- Returns:
- a map containing the elements that are subject to be exported
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
getExportedElementsOrder
@NotNull default @NotNull String[] getExportedElementsOrder()
Returns the names of the elements in the correct order. The names correspond to the keys of the map returned bygetExportedElements().- Returns:
- Array that determines the order of the elements
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
getAssociatedContent
@Nullable default @Nullable List<Resource> getAssociatedContent()
Returns a list of resources representing the collections that are associated to this content fragment.- Returns:
- a list of collection resources
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
- See Also:
getAssociatedContent()
-
getExportedType
@NotNull default @NotNull String getExportedType()
Returns the type of the resource for which the export is performed.- Specified by:
getExportedTypein interfaceComponentExporter- Returns:
- the type of the resource
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
getEditorJSON
@NotNull default @NotNull String getEditorJSON()
Returns a JSON format string containing information about this fragment.- Returns:
- JSON string
- Since:
- com.adobe.cq.wcm.core.components.models.contentfragment 1.0.0
-
-