com.lf.commons.lang

Class FactoryManager

java.lang.Object

com.lf.commons.lang.FactoryManager

public class FactoryManager
extends java.lang.Object

Manager class for registering managed factories and releasing factory resources/objects.

Since:

1.5

Version:

$Revision: 1.7 $, $Date: 2012/12/28 11:44:25 $

Author:

Axel Schwolow

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.Hashtable<java.lang.String,ManagedFactory>	cacheFactoryByClass Shared cacheFactoryByClass for managed factories.

Constructor Summary

Constructors

Constructor and Description
FactoryManager() Constructor method for i18n purposes only.

Method Summary

Methods

Modifier and Type	Method and Description
static ManagedFactory[]	getRegisteredFactories() Provides the currently managed factories.
static void	registerFactory(ManagedFactory factory) Registers a managed factory for release management.
static void	releaseByStrategy() Causes factory objects to release such managed resources/caches following a strategy.
static void	releaseForced() Implementations should release all managed resources or caches immediately.

Methods inherited from class java.lang.Object

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

Field Detail

cacheFactoryByClass

protected static final java.util.Hashtable<java.lang.String,ManagedFactory> cacheFactoryByClass

Shared cacheFactoryByClass for managed factories.

Constructor Detail

FactoryManager

public FactoryManager()
               throws java.lang.InstantiationException

Constructor method for i18n purposes only.

Can only be used if beans design time is set (e.g. by external tools like the I18NExtractor).

Throws:

java.lang.InstantiationException - Error indication

Since:

1.6

Method Detail

registerFactory

public static void registerFactory(ManagedFactory factory)

Registers a managed factory for release management.

Parameters:

factory - The managed factory to be added

Since:

1.5

getRegisteredFactories

public static ManagedFactory[] getRegisteredFactories()

Provides the currently managed factories.

Returns:

The array with registered factories

Since:

1.5

releaseForced

public static void releaseForced()

Implementations should release all managed resources or caches immediately.

This functionality can be used in order to make as much of occupied memory as possible available again. Normally this method calls the various release() methods of the factory class and is used always if the application reaches a certain amount of consumed memory. In critical situations the application can use this method in order to keep it running or at least store the current configurations or data portions safely (panic mode).

Since:

1.5

releaseByStrategy

public static void releaseByStrategy()

Causes factory objects to release such managed resources/caches following a strategy.

For applications it may be useful to release its caches but keep certain objects/resources untouched since they will be needed in the future or the recreation would be expensive (e.g. when contents must be loaded from a database or from the internet). Use the static identifiers RELEASE_NEVER etc. to mark the objects to follow a certain release strategy.

Since:

1.5