com.lf.commons.i18n

Class I18NFactory

java.lang.Object

com.lf.commons.lang.ManagedFactory

com.lf.commons.i18n.I18NFactory

public class I18NFactory
extends ManagedFactory

Factory class for vending various internationalization objects.

Whenever possible, this factory will hand out references to shared instances. Use this if you need many, many LanguageCodes objects while running your application and it is acceptable for you to continously use a certain amount of memory for the cached object. If you only use instances once then you should either install an object as usual (by calling new), or let this factory create a shared instance and flush the factory after you're finished with the object. The garbage collector will then release memory on-the-fly as the objects are no longer referenced so the overall memory footprint can be very small. You should keep the shared instances created by this class if you make heavy use of the supported classes (currently LanguageCodes, IANACharsets, and CountryCodes.

Since:

1.5

Version:

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

Author:

Axel Schwolow

See Also:

LanguageCodes

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ID_CHARSETS Identifier for shared IANACharsets instance.
static java.lang.String	ID_COUNTRIES Identifier for shared CountryCodes instance.
static java.lang.String	ID_LANGUAGES Identifier for shared LanguageCodes instance.
protected static I18NFactory	sharedInstance Shared I18NFactory instance.

Fields inherited from class com.lf.commons.lang.ManagedFactory

cacheObjectByID

Constructor Summary

Constructors

Constructor and Description
I18NFactory() Constructs an instance of this factory.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canRelease(java.lang.String id) Checks whether a factory shared object can be released or not.
void	cleanup(java.lang.String id) Perform optional cleanup tasks like closing database connections or disposing dialogs.
static I18NFactory	getSharedInstance() Provides the shared instance of the factory implementation.
java.lang.Object	request(java.lang.String id) Create the factory shared object, recycle if already existing.

Methods inherited from class com.lf.commons.lang.ManagedFactory

getRegisteredObjects, hasSharedInstance, release, releaseByStrategy, releaseForced, set

Methods inherited from class java.lang.Object

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

Field Detail

sharedInstance

protected static I18NFactory sharedInstance

Shared I18NFactory instance.

ID_LANGUAGES

public static final java.lang.String ID_LANGUAGES

Identifier for shared LanguageCodes instance.

ID_CHARSETS

public static final java.lang.String ID_CHARSETS

Identifier for shared IANACharsets instance.

ID_COUNTRIES

public static final java.lang.String ID_COUNTRIES

Identifier for shared CountryCodes instance.

Constructor Detail

I18NFactory

public I18NFactory()

Constructs an instance of this factory.

Since:

1.5

Method Detail

getSharedInstance

public static I18NFactory getSharedInstance()

Provides the shared instance of the factory implementation.

Returns:

Shared instance of the factory

Since:

1.5

request

public java.lang.Object request(java.lang.String id)

Create the factory shared object, recycle if already existing.

This method can only be done by the sub classes since every shared object can have its own specialities needed for creation.

Specified by:

request in class ManagedFactory

Parameters:

id - The factory-unique identifier of the shared object

Returns:

The shared object, null if none could be created

Since:

1.5

canRelease

public boolean canRelease(java.lang.String id)

Checks whether a factory shared object can be released or not.

Specified by:

canRelease in class ManagedFactory

Parameters:

id - The factory-unique identifier of the shared object

Returns:

Can the object be released according to the factories needs?

Since:

1.5

cleanup

public void cleanup(java.lang.String id)

Perform optional cleanup tasks like closing database connections or disposing dialogs.

Specified by:

cleanup in class ManagedFactory

Parameters:

id - The factory-unique identifier of the shared object

Since:

1.5