Package com.day.cq.commons.inherit

Class HierarchyNodeInheritanceValueMap

java.lang.Object
com.day.cq.commons.ValueMapWrapper
com.day.cq.commons.inherit.HierarchyNodeInheritanceValueMap
All Implemented Interfaces:
InheritanceValueMap, Map<String,Object>, ValueMap
public class HierarchyNodeInheritanceValueMap extends ValueMapWrapper implements InheritanceValueMap
An InheritanceValueMap for a given Resource that will inherit values from ancestral pages.

For example, given: /content/parent/page/jcr:content/footer/image/@width, the HierarchyNodeInheritanceValueMap will search for a footer/image/@width property in:

  • /content/parent/page/jcr:content/footer/image/@width
  • /content/parent/jcr:content/footer/image/@width
  • /content/jcr:content/footer/image/@width
Having not found it in any of those locations, it will then return null.

Note that HierarchyNodeInheritanceValueMap searches only the page hierarchy. It will not (for instance), look in:

  • /content/parent/page/jcr:content/footer/@width
See ComponentInheritanceValueMap for that functionality.

  • Constructor Details

    • HierarchyNodeInheritanceValueMap

      public HierarchyNodeInheritanceValueMap(Resource resource)
      Will wrap the ValueMap returned by resource.adaptTo(ValueMap.class), or use an empty map if resource is null or if it doesn't adapt to a ValueMap. The inheritance is internally resolved by fetching the parent resource and wrapping it into an HierarchyNodeInheritanceValueMap as well.
      Parameters:
      resource - the resource to start from

    • HierarchyNodeInheritanceValueMap

      public HierarchyNodeInheritanceValueMap(ValueMap map)
      Use this if the underlying Resource for a ValueMap is not available and no inheritance is needed. Using the inheritance-enabled getter methods will behave exactly like the normal ValueMap getters.
      Parameters:
      map - a ValueMap to wrap

  • Method Details

    • get

      public <T> T get(String name, Class<T> type)
      Description copied from interface: ValueMap
      Get a named property and convert it into the given type. This method does not support conversion into a primitive type or an array of a primitive type. It should return null in this case.
      Specified by:
      get in interface ValueMap
      Overrides:
      get in class ValueMapWrapper
      Type Parameters:
      T - The class of the type
      Parameters:
      name - The name of the property
      type - The class of the type
      Returns:
      Return named value converted to type T or null if non existing or can't be converted.

    • getInherited

      public <T> T getInherited(String name, Class<T> type)
      Description copied from interface: InheritanceValueMap
      Get a named property and convert it into the given type, and take the properties of parent resources / pages into account, if the property is not found locally.

      The exact inheritance mechanism depends on the implementation.

      Specified by:
      getInherited in interface InheritanceValueMap
      Type Parameters:
      T - type parameter
      Parameters:
      name - The name of the property
      type - The class of the type
      Returns:
      Return named value converted to type T or null if non existing or can't be converted.

    • getInherited

      public <T> T getInherited(String name, T defaultValue)
      Description copied from interface: InheritanceValueMap
      Get a named property and convert it into the given type, and take the properties of parent resources / pages into account, if the property is not found locally.

      The exact inheritance mechanism depends on the implementation.

      Specified by:
      getInherited in interface InheritanceValueMap
      Type Parameters:
      T - type parameter
      Parameters:
      name - The name of the property
      defaultValue - The default value to use if the named property does not exist or cannot be converted to the requested type. The default value is also used to define the type to convert the value to. If this is null any existing property is not converted.
      Returns:
      Return named value converted to type T or the default value if non existing or can't be converted.