com.jamonapi.utils

Class LocaleContext

java.lang.Object

com.jamonapi.utils.LocaleContext

public final class LocaleContext
extends Object

Provides a context for localized parameters, mainly formatters, in thread local scope. Note normally the Formatting classes are not thread safe. This class uses ThreadLocal to return a unique object to each thread, so the getFloatingPointFormatter returns the same object in one thread, and getIntegerFormatter returns another one in the same thread. By using only LocaleContext to get Format objects instead of constructing Format objects otherwise, thread-safety is ensured. This class is tuned for performance: constructing a Format object is rather expensive, this class only creates them when really needed.

Method Summary

Modifier and Type	Method and Description
static DecimalFormat	getCurrencyFormatter()
static DateFormat	getDateFormatter()
static char	getDecimalGroupSeparator()
static DecimalFormat	getFloatingPointFormatter()
static DecimalFormat	getIntegerFormatter()
static DecimalFormat	getPercentFormatter()
static void	reset() Reset thread local variables.
static void	setLocale(Locale locale) Sets the locale to apply for formatting.

Methods inherited from class java.lang.Object

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

Method Detail

getFloatingPointFormatter

public static DecimalFormat getFloatingPointFormatter()

Returns:

the thread local storage for the fixed-point number formatting specific for the locale

getIntegerFormatter

public static DecimalFormat getIntegerFormatter()

Returns:

the thread local storage for the integral number formatting specific for the locale

getPercentFormatter

public static DecimalFormat getPercentFormatter()

Returns:

the thread local storage for the percent number formatting specific for the locale

getCurrencyFormatter

public static DecimalFormat getCurrencyFormatter()

Returns:

the thread local storage for the currency formatting specific for the locale

getDecimalGroupSeparator

public static char getDecimalGroupSeparator()

Returns:

the thread local storage for the number formatting decimal grouping separator specific for the locale

getDateFormatter

public static DateFormat getDateFormatter()

Returns:

the locale specific date time formatter

setLocale

public static void setLocale(Locale locale)

Sets the locale to apply for formatting.

Parameters:

locale - the locale to apply for formatting.

reset

public static void reset()

Reset thread local variables. For example this can be called when an application is 'undeployed'. This was done to fix a memory leak in tomcat that happened when the app context was destroyed. The context couldn't be properly destroyed as objects were still in the threadlocal map.