Package com.oorian.i18n

Class LocaleConfiguration

java.lang.Object
com.oorian.i18n.LocaleConfiguration
public final class LocaleConfiguration extends Object
Application-level locale configuration.

Provides a central point for configuring the default locale and the active LocaleResolver strategy. Settings are typically configured once during application startup in Application.initialize().

The resolveLocale(OorianHttpRequest) convenience method delegates to the configured resolver and applies the default locale as a fallback.

Usage in Application.initialize():


 // Set a default locale for the application
 LocaleConfiguration.setDefaultLocale(Locale.US);

 // Use session-based locale resolution (allows per-user overrides)
 CompositeLocaleResolver resolver = new CompositeLocaleResolver();
 resolver.addResolver(new SessionLocaleResolver());
 resolver.addResolver(new AcceptLanguageLocaleResolver());
 LocaleConfiguration.setLocaleResolver(resolver);

Resolving during request processing:


 Locale locale = LocaleConfiguration.resolveLocale(request);
 OorianLocale.set(locale);
Since:
2.1
Version:
1.0
Author:
Marvin P. Warble Jr.
See Also:

  • Method Details

    • setDefaultLocale

      public static void setDefaultLocale(Locale locale)
      Sets the application's default locale.

      This locale is used as the final fallback when the configured LocaleResolver returns null. If no default locale is set, Locale.getDefault() is used.

      Parameters:
      locale - the default locale

    • getDefaultLocale

      public static Locale getDefaultLocale()
      Returns the application's default locale.
      Returns:
      the default locale, or Locale.getDefault() if none has been configured

    • setLocaleResolver

      public static void setLocaleResolver(LocaleResolver resolver)
      Sets the active locale resolver strategy.

      The default resolver is AcceptLanguageLocaleResolver.

      Parameters:
      resolver - the resolver to use

    • getLocaleResolver

      public static LocaleResolver getLocaleResolver()
      Returns the active locale resolver.
      Returns:
      the current locale resolver

    • resolveLocale

      public static Locale resolveLocale(OorianHttpRequest request)
      Resolves the locale for the given request using the configured resolver.

      Delegates to the active LocaleResolver. If the resolver returns null, the configured default locale is returned.

      Parameters:
      request - the current HTTP request
      Returns:
      the resolved locale, never null