ome.services

Class ThumbnailBeanReadOnly

java.lang.Object

ome.logic.AbstractLevel2Service

ome.services.ThumbnailBean

ome.services.ThumbnailBeanReadOnly

All Implemented Interfaces:

java.io.Serializable, ServiceInterface, StatefulServiceInterface, ThumbnailStore, SelfConfigurableService, org.springframework.context.ApplicationContextAware

@Transactional(readOnly=true)
public class ThumbnailBeanReadOnly
extends ThumbnailBean

Provides methods for directly querying object graphs. This read-only variant of the service does not support rendering engine lazy object creation where rendering settings are missing.

Author:

Chris Allan callan@blackcat.ca

See Also:

ThumbnailBean, Serialized Form

Field Summary

Fields inherited from class ome.services.ThumbnailBean

DEFAULT_COMPRESSION_QUALITY, DEFAULT_MIME_TYPE, DEFAULT_X_WIDTH, DEFAULT_Y_WIDTH

Fields inherited from class ome.logic.AbstractLevel2Service

iQuery, iUpdate, metadata, queryFactory, readOnlyStatus, sec

Constructor Summary

Constructors

Constructor and Description
ThumbnailBeanReadOnly(boolean checking) overridden to allow Spring to set boolean

Method Summary

Modifier and Type	Method and Description
byte[]	getThumbnail(java.lang.Integer sizeX, java.lang.Integer sizeY) Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef).
byte[]	getThumbnailByLongestSide(java.lang.Integer size) Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef).
java.util.Map<java.lang.Long,byte[]>	getThumbnailByLongestSideSet(java.lang.Integer size, java.util.Set<java.lang.Long> pixelsIds) Retrieves a number of thumbnails for pixels sets using given sets of rendering settings (RenderingDef).
boolean	setPixelsId(long id) This method manages the state of the service; it must be invoked before using any other methods.

Methods inherited from class ome.services.ThumbnailBean

activate, close, createThumbnail, createThumbnails, createThumbnailsByLongestSideSet, errorIfInvalidState, errorIfNullPixels, errorIfNullPixelsAndRenderingDef, errorIfNullRenderingDef, getCurrentEventContext, getRenderingDefId, getServiceInterface, getThumbnailByLongestSideDirect, getThumbnailDirect, getThumbnailForSectionByLongestSideDirect, getThumbnailForSectionDirect, getThumbnailSet, isDiskSpaceChecking, isInProgress, passivate, resetDefaults, setApplicationContext, setCompressionService, setDiskSpaceChecking, setInProgressImageResource, setIoService, setIPixels, setIRepositoryInfo, setLutProvider, setPixelDataService, setRenderingDefId, setScaleService, setSettingsService, thumbnailExists

Methods inherited from class ome.logic.AbstractLevel2Service

getBeanHelper, getExtendedMetadata, getQueryFactory, getSecuritySystem, selfConfigure, setExtendedMetadata, setQueryFactory, setQueryService, setReadOnlyStatus, setSecuritySystem, setUpdateService

Methods inherited from class java.lang.Object

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

Constructor Detail

ThumbnailBeanReadOnly

public ThumbnailBeanReadOnly(boolean checking)

overridden to allow Spring to set boolean

Method Detail

setPixelsId

public boolean setPixelsId(long id)

Description copied from interface: ThumbnailStore

This method manages the state of the service; it must be invoked before using any other methods. As the

ThumbnailStore

relies on the

RenderingEngine

, a valid rendering definition must be available for it to work.

Specified by:

setPixelsId in interface ThumbnailStore

Overrides:

setPixelsId in class ThumbnailBean

Parameters:

id - an Pixels id.

Returns:

true if a RenderingDef exists for the Pixels set, otherwise false

getThumbnailByLongestSideSet

public java.util.Map<java.lang.Long,byte[]> getThumbnailByLongestSideSet(java.lang.Integer size,
                                                                         java.util.Set<java.lang.Long> pixelsIds)

Description copied from interface: ThumbnailStore

Retrieves a number of thumbnails for pixels sets using given sets of rendering settings (RenderingDef). If the Thumbnails exist in the on-disk cache they will be returned directly, otherwise they will be created as in ThumbnailStore.getThumbnailByLongestSideDirect(java.lang.Integer). The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image. Unlike the other thumbnail retrieval methods, this method may be called without first calling ThumbnailStore.setPixelsId(long).

Specified by:

getThumbnailByLongestSideSet in interface ThumbnailStore

Overrides:

getThumbnailByLongestSideSet in class ThumbnailBean

Parameters:

size - the size of the longest side of the thumbnail requested. null specifies the default size of 48.

pixelsIds - the Pixels sets to retrieve thumbnails for.

Returns:

a Map whose keys are pixels ids and values are JPEG thumbnail byte buffers or null if an exception was thrown while attempting to retrieve the thumbnail for that particular Pixels set.

See Also:

ThumbnailStore.getThumbnailSet(Integer, Integer, Set)

getThumbnail

public byte[] getThumbnail(java.lang.Integer sizeX,
                           java.lang.Integer sizeY)

Description copied from interface: ThumbnailStore

Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). If the thumbnail exists in the on-disk cache it will be returned directly, otherwise it will be created as in ThumbnailStore.getThumbnailDirect(Integer, Integer), placed in the on-disk cache and returned.

Specified by:

getThumbnail in interface ThumbnailStore

Overrides:

getThumbnail in class ThumbnailBean

Parameters:

sizeX - the X-axis width of the thumbnail. null specifies the default size of 48.

sizeY - the Y-axis width of the thumbnail. null specifies the default size of 48.

Returns:

a JPEG thumbnail byte buffer.

See Also:

ThumbnailStore.getThumbnailDirect(Integer, Integer)

getThumbnailByLongestSide

public byte[] getThumbnailByLongestSide(java.lang.Integer size)

Description copied from interface: ThumbnailStore

Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). If the thumbnail exists in the on-disk cache it will bereturned directly, otherwise it will be created as in ThumbnailStore.getThumbnailDirect(Integer, Integer), placed in the on-disk cache and returned. The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image.

Specified by:

getThumbnailByLongestSide in interface ThumbnailStore

Overrides:

getThumbnailByLongestSide in class ThumbnailBean

Parameters:

size - the size of the longest side of the thumbnail requested. null specifies the default size of 48.

Returns:

a JPEG thumbnail byte buffer.

See Also:

ThumbnailStore.getThumbnail(Integer, Integer)