de.cismet.cids.custom.clientutils

Class StadtbilderUtils

java.lang.Object

de.cismet.cids.custom.clientutils.StadtbilderUtils

public class StadtbilderUtils
extends Object

DOCUMENT ME!

Version:

$Revision$, $Date$

Author:

Gilles Baatz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StadtbilderUtils.ConcurrentLRUCache<Key,Value> DOCUMENT ME!
static class	StadtbilderUtils.StadtbildInfo DOCUMENT ME!

Field Summary

Fields

Modifier and Type	Field and Description
static BufferedImage	ERROR_IMAGE
static int	HIGH_PRIORITY
static int	LOW_PRIORITY
static int	NORMAL_PRIORITY
static BufferedImage	PLACEHOLDER_IMAGE

Constructor Summary

Constructors

Constructor and Description
StadtbilderUtils()

Method Summary

Modifier and Type	Method and Description
static void	cacheImagesForStadtbilder(de.cismet.cids.dynamics.CidsBean stadtbildserie, List<de.cismet.cids.dynamics.CidsBean> stadtbilder, de.cismet.connectioncontext.ConnectionContext connectionContext) Checks if the Stadtbilder are in the cache.
static BufferedImage	downloadImageForBildnummer(StadtbilderUtils.StadtbildInfo stadtbildInfo) Fetches an image of a bildnummer.
static Object	fetchImageForBildnummer(de.cismet.cids.dynamics.CidsBean statdbildserie, StadtbilderUtils.StadtbildInfo stadtbildInfo, int priority, de.cismet.connectioncontext.ConnectionContext connectionContext) Fetches an image of a bildnummer.
static String	getArcUrlPath(String bildnummer) DOCUMENT ME!
static String	getErrorMessageForFailedImage(StadtbilderUtils.StadtbildInfo stadtbildInfo) DOCUMENT ME!
static String	getFormatOfHighResPicture(StadtbilderUtils.StadtbildInfo stadtbildInfo) Gets a Stadtbild-imageNumber as argument and checks if a high-res image for that number exists.
static de.cismet.cids.dynamics.CidsBean	getR102(de.cismet.connectioncontext.ConnectionContext connectionContext) Get the CidsBean of the Sb_Lager with the name 'R102'.
static URL	getURLOfLowResPicture(StadtbilderUtils.StadtbildInfo stadtbildInfo) DOCUMENT ME!
static de.cismet.cids.dynamics.CidsBean	getWuppertal(de.cismet.connectioncontext.ConnectionContext connectionContext) Get the CidsBean of the Sb_Ort with the name 'Wuppertal'.
static boolean	isBildnummerInCacheOrFailed(StadtbilderUtils.StadtbildInfo stadtbildInfo) Checks if the bildnummer has an entry in the image cache, or if the bildnummer could not be loaded.
static boolean	isBildnummerInFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo) Checks if the bildnummer could not be loaded.
static void	removeBildnummerFromFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo) Removes a bildnummer from the failed set.
static void	removeBildnummerFromImageCacheAndFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo) Removes a bildnummer from the image cache, and also its entry in the failed set.
static Image	scaleImage(Image toScale, int dimension, boolean showWholePicture) Scales the image such that it fits in an element of the jGrid.
static void	setModelForComboBoxesAndDecorateIt(JComboBox combobox, String className, de.cismet.connectioncontext.ConnectionContext connectionContext) Fills the model of combobox with the LightweightMetaObjects for all elements of a certain cids-class.
static void	simulateGC() DOCUMENT ME!

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_IMAGE

public static BufferedImage ERROR_IMAGE

PLACEHOLDER_IMAGE

public static BufferedImage PLACEHOLDER_IMAGE

HIGH_PRIORITY

public static final int HIGH_PRIORITY

See Also:

Constant Field Values

NORMAL_PRIORITY

public static final int NORMAL_PRIORITY

See Also:

Constant Field Values

LOW_PRIORITY

public static final int LOW_PRIORITY

See Also:

Constant Field Values

Constructor Detail

StadtbilderUtils

public StadtbilderUtils()

Method Detail

getWuppertal

public static de.cismet.cids.dynamics.CidsBean getWuppertal(de.cismet.connectioncontext.ConnectionContext connectionContext)

Get the CidsBean of the Sb_Ort with the name 'Wuppertal'. Might be null.

Parameters:

connectionContext - DOCUMENT ME!

Returns:

DOCUMENT ME!

simulateGC

public static void simulateGC()

DOCUMENT ME!

getArcUrlPath

public static String getArcUrlPath(String bildnummer)

DOCUMENT ME!

Parameters:

bildnummer - DOCUMENT ME!

Returns:

DOCUMENT ME!

getR102

public static de.cismet.cids.dynamics.CidsBean getR102(de.cismet.connectioncontext.ConnectionContext connectionContext)

Get the CidsBean of the Sb_Lager with the name 'R102'. Might be null.

Parameters:

connectionContext - DOCUMENT ME!

Returns:

DOCUMENT ME!

setModelForComboBoxesAndDecorateIt

public static void setModelForComboBoxesAndDecorateIt(JComboBox combobox,
                                                      String className,
                                                      de.cismet.connectioncontext.ConnectionContext connectionContext)

Fills the model of combobox with the LightweightMetaObjects for all elements of a certain cids-class. The method creates a temporary FastBindableReferenceCombo and set its MetaClass to the class given as argument. Then the model of the FastBindableReferenceCombo is set as the model of the combobox. Finally the combobox is decorated with the AutoCompleteDecorator.

Parameters:

combobox - The model of that combobox will be replaced

className - the cids class name. The elements of this class will be fetched.

connectionContext - DOCUMENT ME!

getURLOfLowResPicture

public static URL getURLOfLowResPicture(StadtbilderUtils.StadtbildInfo stadtbildInfo)

DOCUMENT ME!

Parameters:

stadtbildInfo - imageNumber DOCUMENT ME!

Returns:

DOCUMENT ME!

getFormatOfHighResPicture

public static String getFormatOfHighResPicture(StadtbilderUtils.StadtbildInfo stadtbildInfo)

Gets a Stadtbild-imageNumber as argument and checks if a high-res image for that number exists. This check is done by sending a HEAD-request to different URLS, whose difference is the file ending. The file endings are taken from IMAGE_FILE_FORMATS.

Parameters:

stadtbildInfo - DOCUMENT ME!

Returns:

if a high-res image exists, then its file ending. Otherwise null.

downloadImageForBildnummer

public static BufferedImage downloadImageForBildnummer(StadtbilderUtils.StadtbildInfo stadtbildInfo)
                                                throws Exception

Fetches an image of a bildnummer. Receives an image number as argument and checks if its image is already in the cache. If this is the case the cached image is returned. If not the image corresponding to the number is downloaded and returned.

Parameters:

stadtbildInfo - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

Exception - java.lang.Exception

fetchImageForBildnummer

public static Object fetchImageForBildnummer(de.cismet.cids.dynamics.CidsBean statdbildserie,
                                             StadtbilderUtils.StadtbildInfo stadtbildInfo,
                                             int priority,
                                             de.cismet.connectioncontext.ConnectionContext connectionContext)

Fetches an image of a bildnummer. Receives an image number as argument and checks if its image is already in the cache. If this is the case the cached image is returned. If not the image corresponding to the number is downloaded. In that case a Future<Image> is returned.

Parameters:

statdbildserie - DOCUMENT ME!

stadtbildInfo - bildnummer DOCUMENT ME!

priority - DOCUMENT ME!

connectionContext - DOCUMENT ME!

Returns:

DOCUMENT ME!

isBildnummerInCacheOrFailed

public static boolean isBildnummerInCacheOrFailed(StadtbilderUtils.StadtbildInfo stadtbildInfo)

Checks if the bildnummer has an entry in the image cache, or if the bildnummer could not be loaded.

Parameters:

stadtbildInfo - DOCUMENT ME!

Returns:

DOCUMENT ME!

isBildnummerInFailedSet

public static boolean isBildnummerInFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo)

Checks if the bildnummer could not be loaded.

Parameters:

stadtbildInfo - DOCUMENT ME!

Returns:

DOCUMENT ME!

getErrorMessageForFailedImage

public static String getErrorMessageForFailedImage(StadtbilderUtils.StadtbildInfo stadtbildInfo)

DOCUMENT ME!

Parameters:

stadtbildInfo - DOCUMENT ME!

Returns:

DOCUMENT ME!

cacheImagesForStadtbilder

public static void cacheImagesForStadtbilder(de.cismet.cids.dynamics.CidsBean stadtbildserie,
                                             List<de.cismet.cids.dynamics.CidsBean> stadtbilder,
                                             de.cismet.connectioncontext.ConnectionContext connectionContext)

Checks if the Stadtbilder are in the cache. If not they will be downloaded. Returns immediately.

Parameters:

stadtbildserie - DOCUMENT ME!

stadtbilder - DOCUMENT ME!

connectionContext - DOCUMENT ME!

removeBildnummerFromImageCacheAndFailedSet

public static void removeBildnummerFromImageCacheAndFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo)

Removes a bildnummer from the image cache, and also its entry in the failed set.

Parameters:

stadtbildInfo - cidsBean DOCUMENT ME!

removeBildnummerFromFailedSet

public static void removeBildnummerFromFailedSet(StadtbilderUtils.StadtbildInfo stadtbildInfo)

Removes a bildnummer from the failed set.

Parameters:

stadtbildInfo - DOCUMENT ME!

scaleImage

public static Image scaleImage(Image toScale,
                               int dimension,
                               boolean showWholePicture)

Scales the image such that it fits in an element of the jGrid. If showWholePicture is true, then the image will be scaled such that it will be shown completely in the element, thus a border may be there. If showWholePicture is false the element of the grid will be filled up completely with the image, but the image may be cut off. This is due to that the ratio of the image is preserved.

Tries to use GraphicsUtilities.createThumbnail(), as it works only if the image is smaller.

Parameters:

toScale - DOCUMENT ME!

dimension - DOCUMENT ME!

showWholePicture - DOCUMENT ME!

Returns:

a scaled image