org.openmrs.util

Class LocaleUtility

java.lang.Object

org.openmrs.util.LocaleUtility

All Implemented Interfaces:

GlobalPropertyListener

public class LocaleUtility
extends java.lang.Object
implements GlobalPropertyListener

A utility class for working with Locales.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Locale	DEFAULT_LOCALE Deprecated. use getDefaultLocale() now

Constructor Summary

Constructors

Constructor and Description
LocaleUtility()

Method Summary

Modifier and Type	Method and Description
static boolean	areCompatible(java.util.Locale lhs, java.util.Locale rhs) Compatible is a looser matching than that provided by Locale.equals().
static java.util.Locale	fromSpecification(java.lang.String localeSpecification) Creates a locale based on a string specification.
static java.util.Locale	getDefaultLocale() Gets the default locale specified as a global property.
static java.util.Set<java.util.Locale>	getLocalesInOrder() Utility method that returns a collection of all openmrs system locales, the set includes the current logged in user's preferred locale if any is set, the default locale, allowed locales in the order they are specified in the 'allowed.locale.list' global property and 'en' at the very end of the set if it isn't yet among them.
void	globalPropertyChanged(GlobalProperty newValue) Called after a global property is created or updated
void	globalPropertyDeleted(java.lang.String propertyName) Called after a global property is deleted
static boolean	isValid(java.util.Locale locale) Checks if specified locale object is valid
boolean	supportsPropertyName(java.lang.String propertyName) Asks this listener whether it wants to be notified about the given property name

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LOCALE

@Deprecated
public static final java.util.Locale DEFAULT_LOCALE

Deprecated. use getDefaultLocale() now

Default internal locale.

Constructor Detail

LocaleUtility

public LocaleUtility()

Method Detail

getDefaultLocale

public static java.util.Locale getDefaultLocale()

Gets the default locale specified as a global property.

Returns:

default locale object.

Since:

1.5

areCompatible

public static boolean areCompatible(java.util.Locale lhs,
                                    java.util.Locale rhs)

Compatible is a looser matching than that provided by Locale.equals(). Two locales are considered equal if they are equal, or if either does not have a country specified and the languages match.

Parameters:

lhs - left hand side Locale

rhs - right hand side Locale

Returns:

true if the two locales are compatible, false otherwise

fromSpecification

public static java.util.Locale fromSpecification(java.lang.String localeSpecification)

Creates a locale based on a string specification. The specification must be conform with the following format: ll_CC_vv

• ll: two-character lowercase ISO-639 language code
• CC: two-character uppercase ISO-3166 country code optional
• vv: arbitrary length variant code

For example: en_US_Traditional_WIN ...represents English language in the United States with the traditional collation for windows.

Parameters:

localeSpecification - encoded locale specification

Returns:

the representative Locale, or null if the specification is invalid

getLocalesInOrder

public static java.util.Set<java.util.Locale> getLocalesInOrder()

Utility method that returns a collection of all openmrs system locales, the set includes the current logged in user's preferred locale if any is set, the default locale, allowed locales in the order they are specified in the 'allowed.locale.list' global property and 'en' at the very end of the set if it isn't yet among them.

Since:

1.7

globalPropertyChanged

public void globalPropertyChanged(GlobalProperty newValue)

Description copied from interface: GlobalPropertyListener

Called after a global property is created or updated

Specified by:

globalPropertyChanged in interface GlobalPropertyListener

Parameters:

newValue - the new value of the property that was just saved

globalPropertyDeleted

public void globalPropertyDeleted(java.lang.String propertyName)

Description copied from interface: GlobalPropertyListener

Called after a global property is deleted

Specified by:

globalPropertyDeleted in interface GlobalPropertyListener

Parameters:

propertyName - the name of the property that was just deleted

supportsPropertyName

public boolean supportsPropertyName(java.lang.String propertyName)

Description copied from interface: GlobalPropertyListener

Asks this listener whether it wants to be notified about the given property name

Specified by:

supportsPropertyName in interface GlobalPropertyListener

Returns:

whether this listener wants its action methods to be notified of properties with the given name

isValid

public static boolean isValid(java.util.Locale locale)

Checks if specified locale object is valid

Parameters:

locale - object for validation

Returns:

true if locale is available