Package org.zkoss.util

Class Locales

java.lang.Object
org.zkoss.util.Locales
public class Locales extends Object
The locale relevant utilities.
Author:
tomyeh

  • Constructor Details

    • Locales

      public Locales()

  • Method Details

    • getCurrent

      public static final Locale getCurrent()
      Returns the current locale; never null. This is the locale that every other objects shall use, unless they have special consideration.

      Default: If setThreadLocal(java.util.Locale) was called with non-null, the value is returned. Otherwise, Locale.getDefault() is returned,

    • testCurrent

      public static final boolean testCurrent(String lang, String country)
      Returns whether the current locale (getCurrent()) belongs to the specified language and/or country.
      Parameters:
      lang - the language code, e.g., en and zh. Ignored if null.
      country - the country code, e.g., US. Ignored if null. If empty, it means no country code at all.

    • setThreadLocal

      public static final Locale setThreadLocal(Locale locale)
      Sets the locale for the current thread only.

      Each thread could have an independent locale, called the thread locale.

      When Invoking this method under a thread that serves requests, remember to clean up the setting upon completing each request. 

      Locale old = Locales.setThreadLocal(newValue);
try { 
  ...
} finally {
  Locales.setThreadLocal(old);
}
      Parameters:
      locale - the thread locale; null to denote no thread locale
      Returns:
      the previous thread locale

    • getThreadLocal

      public static final Locale getThreadLocal()
      Returns the locale defined by setThreadLocal(java.util.Locale).
      Since:
      3.0.0
      See Also:

    • getLocale

      public static final Locale getLocale(String localeString, char separator)
      Converts a string that consists of language, country and variant to a locale.

      The separator between language, country and variant is customizable, and whitespaces are ignored, e.g., "zh_TW" and "zh, TW".

      Thus, locale.equals(Locales.getLocale(locale.toString(), '_')).

      Parameters:
      localeString - the locale in string; null is OK
      separator - the separator; ((char)0) means to decide automatically (either ',', '-' or '_')
      Returns:
      the locale or null if locale is null or empty

    • getLocale

      public static final Locale getLocale(String localeString)
      Converts a string that consists of language, country and variant to a locale.

      A shortcut: getLocale(localeString, (char)0).

    • getLocale

      public static final Locale getLocale(Locale locale)
      Converts a Locale to one of them being used before. To save memory (since locale is used frequently), it is suggested to pass thru this method after creating a new instance of Locale.
      Example, getLocale(new Locale(...)).

      This method first look for any locale

    • getByFallback

      public static Locale getByFallback(Collection<Locale> values, Locale locale)
      Returns any occurrence of the specified Locale or any its fallback in the value collection, or null if not found. By fallback, we mean will try without variant and country. Example, if locale is zh_TW, it will try zh_TW and then zh.

    • indexOfUnderline

      public static int indexOfUnderline(String s, int j)
      Returns the index of '_' preceding the country part, starting from j. It is similar to s.indexOf('_', j), except it detects country part (which must be only two letter in lower cases.

    • indexOfUnderline

      public static int indexOfUnderline(String s)
      Returns the index of '_' preceding the country part. It is similar to s.indexOf('_'), except it detects country part (which must be only two letter in lower cases.