public static Locale findLocale(Map objectModel,
    String attribute,
    Parameters parameters,
    Locale defaultLocale,
    boolean useLocale) 
{
        return findLocale(objectModel, attribute, parameters, defaultLocale, useLocale, false, false, null);
}

Find a suitable locale from an objectModel.

 public static Locale findLocale(Map objectModel,
    String attribute,
    Parameters parameters,
    Locale defaultLocale,
    boolean useLocale,
    boolean useLocales,
    boolean useBlankLocale,
    I18nUtils.LocaleValidator test) 
{
        String localeStr;
        Locale locale;
        Request request = ObjectModelHelper.getRequest(objectModel);
        // 1. Request parameter 'locale'
        localeStr = request.getParameter(attribute);
        if (localeStr != null) {
            locale = parseLocale(localeStr);
            if (test == null || test.test("request", locale)) {
                return locale;
            }
        }
        // 2. Session attribute 'locale'
        Session session = request.getSession(false);
        if (session != null &&
                ((localeStr = (String) session.getAttribute(attribute)) != null)) {
            locale = parseLocale(localeStr);
            if (test == null || test.test("session", locale)) {
                return locale;
            }
        }
        // 3. First matching cookie parameter 'locale' within each cookie sent
        Cookie[] cookies = request.getCookies();
        if (cookies != null) {
            for (int i = 0; i <  cookies.length; i++) {
                Cookie cookie = cookies[i];
                if (cookie.getName().equals(attribute)) {
                    localeStr = cookie.getValue();
                    locale = parseLocale(localeStr);
                    if (test == null || test.test("cookie", locale)) {
                        return locale;
                    }
                    break;
                }
            }
        }
        // 4. Sitemap parameter "locale"
        if (parameters != null) {
            localeStr = parameters.getParameter("locale", null);
            if (localeStr != null) {
                locale = parseLocale(localeStr);
                if (test == null || test.test("sitemap", locale)) {
                    return locale;
                }
            }
        }
        // 5. Locale setting of the requesting browser or server default
        if (useLocale && !useLocales) {
            locale = request.getLocale();
            if (test == null || test.test("request", locale)) {
                return locale;
            }
        }
        if (useLocales) {
            Enumeration locales = request.getLocales();
            while (locales.hasMoreElements()) {
                locale = (Locale)locales.nextElement();
                if (test == null || test.test("request", locale)) {
                    return locale;
                }
            }
        }
        // 6. Default
        if (defaultLocale != null) {
            locale = defaultLocale;
            if (test == null || test.test("default", locale)) {
                return locale;
            }
        }
        // 7. Blank
        if (useBlankLocale) {
            locale = new Locale("", ""); // Use JDK1.3 constructor
            if (test == null || test.test("blank", locale)) {
                return locale;
            }
        }
        // 8. Fail
        return null;
}

Find a suitable locale from an objectModel.

 public static boolean matchesI18nNamespace(String uri) 
{
        if (NAMESPACE_URI.equals(uri)) {
            return true;
        } else if (OLD_NAMESPACE_URI.equals(uri)) {
            if (!deprecationFound) {
                deprecationFound = true;
                Deprecation.logger.warn("The namespace < " + OLD_NAMESPACE_URI +
                                        " > is deprecated, use: < " + NAMESPACE_URI + " >");
            }
            return true;
        }
        return false;
}

 public static Locale parseLocale(String localeString) 
{
        return parseLocale(localeString, Locale.getDefault());
}

Parses given locale string to Locale object. If the string is null then the VM default locale is returned.

 public static Locale parseLocale(String localeString,
    Locale defaultLocale) 
{
        if (localeString != null && localeString.length()  > 0) {
            StringTokenizer st = new StringTokenizer(localeString, LOCALE_DELIMITER);
            String l = st.hasMoreElements() ? st.nextToken() : defaultLocale.getLanguage();
            String c = st.hasMoreElements() ? st.nextToken() : "";
            String v = st.hasMoreElements() ? st.nextToken() : "";
            return new Locale(l, c, v);
        }
        return defaultLocale;
}

Parses given locale string to Locale object. If the string is null or empty then the given locale is returned.

 public static  void storeLocale(Map objectModel,
    String attribute,
    String locale,
    boolean storeInRequest,
    boolean storeInSession,
    boolean storeInCookie,
    boolean createSession) 
{
        // store in a request if so configured
        if (storeInRequest) {
            Request request = ObjectModelHelper.getRequest(objectModel);
            request.setAttribute(attribute, locale);
        }
        // store in session if so configured
        if (storeInSession) {
            Request request = ObjectModelHelper.getRequest(objectModel);
            Session session = request.getSession(createSession);
            if (session != null) {
                session.setAttribute(attribute, locale);
            }
        }
        // store in a cookie if so configured
        if (storeInCookie) {
            Response response = ObjectModelHelper.getResponse(objectModel);
            response.addCookie(response.createCookie(attribute, locale));
        }
}

Store locale in request, session, or cookie.