com.day.cq.dam.commons.util

Class DamUtil

java.lang.Object

com.day.cq.dam.commons.util.DamUtil

public class DamUtil
extends java.lang.Object

This class provides various utility methods pertaining to DAM.

Since:

CQ 5.4.0

Constructor Summary

Constructors

Constructor and Description
DamUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	assetToBinaryPath(java.lang.String path) Translates the path of an asset to its congruent DAM binary path, by replacing the /content/dam path prefix with /var/dam.
static java.lang.String	binaryToAssetPath(java.lang.String path) Translates the path of a DAM binary to its congruent asset path, by replacing the /var/dam path prefix with /content/dam.
static java.util.List<java.lang.String>	findExpiringAssets(Session session, java.util.Calendar lowerBound, java.util.Calendar upperBound) Find all dam assets which are getting expired between lowerBound and upperBound.
static java.lang.String	getThumbnailName(int width, int height) Returns the name of a thumbnail in the DAM thumbnail name format, respecting the given dimensions of the thumbnail.
static java.lang.String	getThumbnailName(int width, int height, java.lang.String[] selectors) Behaves like getThumbnailName(int, int).
static java.lang.String	getThumbnailName(ThumbnailConfig config) Returns the expected rendition/thumbnail name based on the given thumbnail configuration.
static java.lang.String	getValue(Node n, java.lang.String name, java.lang.String defaultValue) Returns the single property value from the given node n with name.
static boolean	isAsset(Resource resource) Checks whether the given Resource represents a Asset.
static boolean	isRendition(Resource resource) Checks whether the given Resource represents a Rendition of an Asset.
static boolean	isSubAsset(Resource resource) Indicates whether the given resource is an Asset's sub-asset.
static boolean	isThumbnail(Node file) This method determines whether the given Node represents a thumbnail of an asset.
static Asset	resolveToAsset(Resource resource) Checks whether the given resource is an asset, and if not, travels upwards the resource hierarchy until a resource is an asset.
static void	setModified(Asset asset, java.lang.String user, java.util.Calendar date) This method updates the "last modified" information of the given Asset.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DamUtil

public DamUtil()

Method Detail

assetToBinaryPath

public static java.lang.String assetToBinaryPath(java.lang.String path)

Translates the path of an asset to its congruent DAM binary path, by replacing the /content/dam path prefix with /var/dam. If the given path does not start with DAM's asset mountpoint, null is returned.

   DamUtil.assetToBinaryPath("/content/dam/myfolder/test.jpg")    = "/var/dam/myfolder/test.jpg"
   DamUtil.assetToBinaryPath(null)                                = null
 

Parameters:

path - The path to translate.

Returns:

The binary equivalent path or null if the given path is not a DAM asset path.

See Also:

DamConstants.MOUNTPOINT_BINARIES, DamConstants.MOUNTPOINT_ASSETS

binaryToAssetPath

public static java.lang.String binaryToAssetPath(java.lang.String path)

Translates the path of a DAM binary to its congruent asset path, by replacing the /var/dam path prefix with /content/dam. If the given path does not start with DAM's binary mountpoint, null is returned.

   DamUtil.binaryToAssetPath("/var/dam/myfolder/test.jpg")        = "/content/dam/myfolder/test.jpg"
   DamUtil.binaryToAssetPath(null)                                = null
 

Parameters:

path - The path to translate.

Returns:

The metadata equivalent path or null if the given path is not a DAM binary path.

See Also:

DamConstants.MOUNTPOINT_BINARIES, DamConstants.MOUNTPOINT_ASSETS

isThumbnail

public static boolean isThumbnail(Node file)

This method determines whether the given Node represents a thumbnail of an asset.

Parameters:

file - The node to check.

Returns:

true if the node represent's an asset's thumbnail, false otherwise.

getThumbnailName

public static java.lang.String getThumbnailName(int width,
                                int height)

Returns the name of a thumbnail in the DAM thumbnail name format, respecting the given dimensions of the thumbnail. E.g. providing a width of 100 and a height of 100 would return the thumbnail name cq5dam.thumbnail.100.100.png. As a thumbnail represents a rendition of an Asset, the name can be used for easy retrieval of the thumbnail:

   ...
   final String thumbnailName = DamUtil.getThumbnailName(100, 100);
   final Resource thumbnail = asset.getRendition(thumbnailName);
   ...
 

Parameters:

width - The width of the thumbnail.

height - The height of the thumbnail.

Returns:

The rendition name of the thumbnail.

getThumbnailName

public static java.lang.String getThumbnailName(ThumbnailConfig config)

Returns the expected rendition/thumbnail name based on the given thumbnail configuration.

Parameters:

config - The ThumbnailConfig

Returns:

The Rendition name.

getThumbnailName

public static java.lang.String getThumbnailName(int width,
                                int height,
                                java.lang.String[] selectors)

Behaves like getThumbnailName(int, int). Additionally and optionally a string array of selectors to be added to the thumbnail name can be specified. E.g. providing width = 100, height = 100 and selectors = {"a", "b", "c"} would return the thumbnail name cq5dam.thumbnail.100.100.a.b.c.png. Example:

   ...
   final String[] selectors = {"a", "b", "c"};
   final String thumbnailName = DamUtil.getThumbnailName(100, 100, selectors);
   final Resource thumbnail = asset.getRendition(thumbnailName);
   ...
 

Parameters:

width - The width of the thumbnail.

height - The height of the thumbnail.

selectors - An array of selectors to be added. May be null (ignored).

Returns:

The rendition name of the thumbnail.

isRendition

public static boolean isRendition(Resource resource)

Checks whether the given Resource represents a Rendition of an Asset. The requirements are that given resource is stored within the renditions folder of an asset and that it's node type is nt:file.

Parameters:

resource - The resource to check.

Returns:

true if the resource is a rendition.

isAsset

public static boolean isAsset(Resource resource)

Checks whether the given Resource represents a Asset. The requirements are that the given resource is of node type dam:Asset.

Parameters:

resource - The resource to check.

Returns:

true if the resource is an asset.

isSubAsset

public static boolean isSubAsset(Resource resource)

Indicates whether the given resource is an Asset's sub-asset.

Parameters:

resource - The Resource to check.

Returns:

true if this asset is a sub-asset.

resolveToAsset

public static Asset resolveToAsset(Resource resource)

Checks whether the given resource is an asset, and if not, travels upwards the resource hierarchy until a resource is an asset.

Parameters:

resource - The resource to check.

Returns:

The Asset or null if no asset was found.

setModified

public static void setModified(Asset asset,
               java.lang.String user,
               java.util.Calendar date)

This method updates the "last modified" information of the given Asset.

Parameters:

asset - The asset to update.

user - The username of who updated the asset.

date - The date/time the updated happened.

findExpiringAssets

public static java.util.List<java.lang.String> findExpiringAssets(Session session,
                                                  java.util.Calendar lowerBound,
                                                  java.util.Calendar upperBound)
                                                           throws RepositoryException

Find all dam assets which are getting expired between lowerBound and upperBound.

Parameters:

session -

expiryDatePropName - the property on which asset expiration is computed.

lowerBound - the lower bound of date where asset expiration is computed. If null it is not considered as query criterion

upperBound - the upper bound of date where asset expiration is computed. If null it is not considered as query criterion

Throws:

RepositoryException

getValue

public static java.lang.String getValue(Node n,
                        java.lang.String name,
                        java.lang.String defaultValue)
                                 throws RepositoryException

Returns the single property value from the given node n with name. If there is no single-valued property for the given name, then the defaultValue is returned.

Parameters:

n - a node.

name - a property name.

defaultValue - the default value.

Returns:

the value for the given property name or the default value.

Throws:

RepositoryException - if value cannot be retrieved