Package com.day.cq.dam.commons.handler

Class StandardImageHandler

java.lang.Object

com.day.cq.dam.commons.handler.AbstractAssetHandler

com.day.cq.dam.commons.handler.StandardImageHandler

All Implemented Interfaces:

AssetHandler

@Service
public class StandardImageHandler
extends AbstractAssetHandler

The StandardImageHandler supports currently following image types:

• gif
• png
• photoshop
• jpeg
• tiff
• bmp

Field Summary

Fields

Modifier and Type	Field	Description
static final String	BMP1_MIMETYPE
static final String	BMP2_MIMETYPE
static final String	CONFIG_LARGE_COMMENT_THRESHOLD
static final String	CONFIG_LARGE_FILE_THRESHOLD
static final String	DNG_MIMETYPE
static final String	GIF_MIMETYPE	Mime type
static final String	JPEG_MIMETYPE
static final String	METADATA_IGNORE_LIST
static final String	PJPEG_MIMETYPE
static final String	PNG1_MIMETYPE
static final String	PNG2_MIMETYPE
static final String	RAW1_MIMETYPE
static final String	RAW10_MIMETYPE
static final String	RAW11_MIMETYPE
static final String	RAW12_MIMETYPE
static final String	RAW13_MIMETYPE
static final String	RAW14_MIMETYPE
static final String	RAW15_MIMETYPE
static final String	RAW16_MIMETYPE
static final String	RAW17_MIMETYPE
static final String	RAW18_MIMETYPE
static final String	RAW19_MIMETYPE
static final String	RAW2_MIMETYPE
static final String	RAW20_MIMETYPE
static final String	RAW21_MIMETYPE
static final String	RAW22_MIMETYPE
static final String	RAW23_MIMETYPE
static final String	RAW3_MIMETYPE
static final String	RAW4_MIMETYPE
static final String	RAW5_MIMETYPE
static final String	RAW6_MIMETYPE
static final String	RAW7_MIMETYPE
static final String	RAW8_MIMETYPE
static final String	RAW9_MIMETYPE
static final String	TIFF_MIMETYPE
static final String	TIFF1_MIMETYPE

Fields inherited from class com.day.cq.dam.commons.handler.AbstractAssetHandler

PROPERTY_DEACTIVATED_MIME_TYPES

Constructor Summary

Constructors

Constructor	Description
StandardImageHandler()

Method Summary

Modifier and Type	Method	Description
ExtractedMetadata	extractMetadata(Asset asset)	This method is used by the ExtractMetadataProcess as part of the DAM Update Asset workflow during import or update of an asset.
BufferedImage	getImage(Rendition rendition)	This method retrieves the graphical representation of an Assets given Rendition.
BufferedImage	getImage(Rendition rendition, Dimension maxDimension)	This method retrieves the graphical representation of an Assets given Rendition.
String[]	getMimeTypes()	This method returns the mime types a particular AssetHandler supports.

Methods inherited from class com.day.cq.dam.commons.handler.AbstractAssetHandler

canHandleSubAssets, createThumbnails, createThumbnails, createThumbnails, exportAsset, processRelated, processSubAssets

Methods inherited from class java.lang.Object

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

Field Details

CONFIG_LARGE_FILE_THRESHOLD

public static final String CONFIG_LARGE_FILE_THRESHOLD

See Also:

• Constant Field Values

CONFIG_LARGE_COMMENT_THRESHOLD

public static final String CONFIG_LARGE_COMMENT_THRESHOLD

See Also:

• Constant Field Values

METADATA_IGNORE_LIST

public static final String METADATA_IGNORE_LIST

See Also:

• Constant Field Values

GIF_MIMETYPE

public static final String GIF_MIMETYPE

Mime type

See Also:

• Constant Field Values

PNG1_MIMETYPE

public static final String PNG1_MIMETYPE

See Also:

• Constant Field Values

PNG2_MIMETYPE

public static final String PNG2_MIMETYPE

See Also:

• Constant Field Values

JPEG_MIMETYPE

public static final String JPEG_MIMETYPE

See Also:

• Constant Field Values

PJPEG_MIMETYPE

public static final String PJPEG_MIMETYPE

See Also:

• Constant Field Values

TIFF_MIMETYPE

public static final String TIFF_MIMETYPE

See Also:

• Constant Field Values

TIFF1_MIMETYPE

public static final String TIFF1_MIMETYPE

See Also:

• Constant Field Values

BMP1_MIMETYPE

public static final String BMP1_MIMETYPE

See Also:

• Constant Field Values

BMP2_MIMETYPE

public static final String BMP2_MIMETYPE

See Also:

• Constant Field Values

RAW1_MIMETYPE

public static final String RAW1_MIMETYPE

See Also:

• Constant Field Values

RAW2_MIMETYPE

public static final String RAW2_MIMETYPE

See Also:

• Constant Field Values

RAW3_MIMETYPE

public static final String RAW3_MIMETYPE

See Also:

• Constant Field Values

RAW4_MIMETYPE

public static final String RAW4_MIMETYPE

See Also:

• Constant Field Values

RAW5_MIMETYPE

public static final String RAW5_MIMETYPE

See Also:

• Constant Field Values

RAW6_MIMETYPE

public static final String RAW6_MIMETYPE

See Also:

• Constant Field Values

RAW7_MIMETYPE

public static final String RAW7_MIMETYPE

See Also:

• Constant Field Values

RAW8_MIMETYPE

public static final String RAW8_MIMETYPE

See Also:

• Constant Field Values

RAW9_MIMETYPE

public static final String RAW9_MIMETYPE

See Also:

• Constant Field Values

RAW10_MIMETYPE

public static final String RAW10_MIMETYPE

See Also:

• Constant Field Values

RAW11_MIMETYPE

public static final String RAW11_MIMETYPE

See Also:

• Constant Field Values

RAW12_MIMETYPE

public static final String RAW12_MIMETYPE

See Also:

• Constant Field Values

RAW13_MIMETYPE

public static final String RAW13_MIMETYPE

See Also:

• Constant Field Values

RAW14_MIMETYPE

public static final String RAW14_MIMETYPE

See Also:

• Constant Field Values

RAW15_MIMETYPE

public static final String RAW15_MIMETYPE

See Also:

• Constant Field Values

RAW16_MIMETYPE

public static final String RAW16_MIMETYPE

See Also:

• Constant Field Values

RAW17_MIMETYPE

public static final String RAW17_MIMETYPE

See Also:

• Constant Field Values

RAW18_MIMETYPE

public static final String RAW18_MIMETYPE

See Also:

• Constant Field Values

RAW19_MIMETYPE

public static final String RAW19_MIMETYPE

See Also:

• Constant Field Values

RAW20_MIMETYPE

public static final String RAW20_MIMETYPE

See Also:

• Constant Field Values

RAW21_MIMETYPE

public static final String RAW21_MIMETYPE

See Also:

• Constant Field Values

RAW22_MIMETYPE

public static final String RAW22_MIMETYPE

See Also:

• Constant Field Values

RAW23_MIMETYPE

public static final String RAW23_MIMETYPE

See Also:

• Constant Field Values

DNG_MIMETYPE

public static final String DNG_MIMETYPE

See Also:

• Constant Field Values

Constructor Details

StandardImageHandler

public StandardImageHandler()

Method Details

getMimeTypes

public String[] getMimeTypes()

Description copied from interface: AssetHandler

This method returns the mime types a particular AssetHandler supports.

Returns:

mime type, e.g. image/jpg

See Also:

• AssetHandler.getMimeTypes()

extractMetadata

public ExtractedMetadata extractMetadata(Asset asset)

Description copied from interface: AssetHandler

This method is used by the ExtractMetadataProcess as part of the DAM Update Asset workflow during import or update of an asset. Implementations must return an ExtractedMetadata object, which may be empty if no metadata is extracted, or contains the metadata values extracted from the binary being imported/updated at the time. The ExtractMetadataProcess will later save the metadata contained in ExtractedMetadata to the asset's metadata node (e.g. /content/dam/geometrixx/banners/banner-mono.png/jcr:content/metadata). Implementations are free to decide which and how many metadata values are extracted.

The method argument represents the Node of type nt:file holding the binary content or the DAM Asset node (type dam:Asset), for which its original rendition would be retrieved.

Parameters:

asset - The Asset, from whose original binary metadata will extracted.

Returns:

The extracted metadata.

getImage

public BufferedImage getImage(Rendition rendition)
                       throws IOException

This method retrieves the graphical representation of an Assets given Rendition. For images the BufferedImage of the original image is returned, for other formats the first page is retrieved as BufferedImage

Specified by:

getImage in interface AssetHandler

Overrides:

getImage in class AbstractAssetHandler

Parameters:

rendition - The rendition for which to retrieve its graphical representation.

Returns:

BufferedImage if a graphical representation exists, otherwise null

Throws:

IOException - in case an error is thrown while fetching the buffered image

getImage

public BufferedImage getImage(Rendition rendition,
 Dimension maxDimension)
                       throws IOException

This method retrieves the graphical representation of an Assets given Rendition. For images the BufferedImage of the original image is returned, for other formats the first page is retrieved as BufferedImage.

If maxDimension is given, the handler should return an image where no dimension extends the given value. This can be used to reduce the memory footprint of large buffered images if the full resolution is not needed.

Specified by:

getImage in interface AssetHandler

Overrides:

getImage in class AbstractAssetHandler

Parameters:

rendition - The rendition for which to retrieve its graphical representation.

maxDimension - optional constraint for the maximal dimension of the image.

Returns:

BufferedImage if a graphical representation exists, otherwise null

Throws:

IOException - in case an error is thrown while fetching the buffered image