Class Locale


  • @SupportedAll
    public class Locale
    extends Object
    This class Locale.java is a utility that provides functionality for applications and services to internationalize their messages.
    • Constructor Detail

      • Locale

        public Locale()
    • Method Detail

      • main

        public static void main​(String[] args)
      • getLocale

        public static Locale getLocale​(String stringformat)
        Gets the locale object for the specified localized string format.
        Parameters:
        stringformat - String representation of the locale. Examples: en_US, en_UK, ja_JP.
        Returns:
        the java.util.locale object.
      • getLocaleStringFromAcceptLangHeader

        public static String getLocaleStringFromAcceptLangHeader​(String langstr)
        Returns locale from accept-language header HTTP accept language header can have more than one language in the header, we honor the first language as locale
        Parameters:
        langstr - Value from Accept-Language header of HTTP
        Returns:
        locale string in this format en_US, fr
      • getLocaleObjFromAcceptLangHeader

        public static Locale getLocaleObjFromAcceptLangHeader​(String langStr)
        Gets locale from accept-language header HTTP accept language header can have more than one language in the header, we honor the first language as locale
        Parameters:
        langStr - Value from Accept-Language header of HTTP
        Returns:
        locale string in this format en_US, fr.
      • getResourceBundle

        public static ResourceBundle getResourceBundle​(String bundle,
                                                       String stringformat)
        Gets the resource bundle corresponding to the specified locale and the localized property file name.
        Parameters:
        bundle - Localized property file name.
        stringformat - String representation of the locale.
        Returns:
        java.util.ResourceBundle object.
      • getInstallResourceBundle

        public static ResourceBundle getInstallResourceBundle​(String bundle)
        Gets the default install resource bundle for the default locale
        Parameters:
        bundle - Localized property file name
        Returns:
        the install resource bundle object
      • getDefaultLocale

        public static Locale getDefaultLocale()
        Gets the default locale
        Returns:
        the default Locale object
      • formatMessage

        public static String formatMessage​(String formatStr,
                                           Object obj1)
        Formats messages using MessageFormat Class.
        Parameters:
        formatStr - string format template.
        obj1 - object to be added to the template.
        Returns:
        formatted message.
      • formatMessage

        public static String formatMessage​(String formatStr,
                                           Object[] objs)
        Formats to format messages using MessageFormat Class. given params to format them with
        Parameters:
        formatStr - string format template.
        objs - objects to be added to the template.
        Returns:
        formatted message.
      • parseNormalizedDateString

        public static Date parseNormalizedDateString​(String dateString)
        Returns the Date object from the date string in ISO-8601 format. OpenAM stores date in ISO-8601 format yyyy/MM/yy hh:mm
        Parameters:
        dateString - in the format 2002/12/31 23:59.
        Returns:
        Date object
      • parseDateString

        public static Date parseDateString​(String dateString,
                                           Locale locale,
                                           String dateSyntax)
        Gets Date object from date string with specified locale.
        Parameters:
        dateString - date string
        locale - Locale object
        dateSyntax - syntax of the date string.
        Returns:
        Date object returned if dateString matches the dateSyntax. If the syntax or date string is empty, or the string does not match the syntax, null will be returned.
      • parseDateString

        public static Date parseDateString​(String dateString,
                                           Locale locale)
        Gets Date object from date string with specified locale. Syntax of date string is defined in amUser_<locale> properties file.
        Parameters:
        dateString - date string
        locale - Locale object
        Returns:
        Date object. null will be returned if error happens
      • getNormalizedDateString

        public static String getNormalizedDateString​(Date date)
        Converts the Date object into ISO-8601 format yyyy/MM/dd HH:mm like 2002/12/23 20:40.
        Parameters:
        date - to be normalized.
        Returns:
        date in ISO8601 format 2002/12/31 11:59.
      • getDateString

        public static String getDateString​(Date date,
                                           Locale locale)
        Gets date string from date with specified locale.
        Parameters:
        date - Date object
        locale - Locale object
        Returns:
        date string. null will be returned if error happens
      • convertDateString

        public static String convertDateString​(String srcDateString,
                                               Locale srcLocale,
                                               Locale dstLocale)
        Converts date string from source locale to destination locale
        Parameters:
        srcDateString - source date string
        srcLocale - source Locale object
        dstLocale - destination Locale object
        Returns:
        converted date string. null will be returned if error happens
      • getString

        public static String getString​(ResourceBundle rb,
                                       String resource,
                                       Object[] params)
        Gets the localized string for the specified key formatted as per passed parameters.
        Parameters:
        rb - resource bundle.
        resource - the specified key.
        params - formatting done as per these parameters.
        Returns:
        the localized string representation formatted as per passed parameters.
      • getString

        public static String getString​(ResourceBundle rb,
                                       String resource,
                                       ResourceBundle defaultRb,
                                       Object[] params)
        Gets the localized string for the specified key from the specified Resource or from the specified default resource formatted as per provided parameters.
        Parameters:
        rb - resource bundle.
        resource - the specified key.
        defaultRb - Default resource bundle.
        params - formatting done as per these parameters.
        Returns:
        the localized string representation formatted as per passed parameters.
      • getString

        public static String getString​(ResourceBundle rb,
                                       String resource,
                                       org.slf4j.Logger debug,
                                       ResourceBundle defaultRb)
        Gets the localized string for the specified key from the specified Resource or from the specified default resource
        Parameters:
        rb - resource bundle.
        resource - the specified key.
        debug - the debug instance to which the debug messages need to be printed.
        defaultRb - Default resource bundle.
        Returns:
        the localized string representation
      • getString

        public static String getString​(ResourceBundle rb,
                                       String resource)
        Gets the localized string for the specified key.
        Parameters:
        rb - resource bundle.
        resource - the specified key.
        Returns:
        the localized string representation
      • getString

        public static String getString​(ResourceBundle rb,
                                       String resource,
                                       ResourceBundle defaultRb)
        Gets the localized string for the specified key from the specified Resource or from the specified default resource.
        Parameters:
        rb - resource bundle.
        resource - the specified key.
        defaultRb - Default resource bundle.
        Returns:
        the localized string representation
      • URLEncodeField

        public static String URLEncodeField​(String input,
                                            String enc)
                                     throws UnsupportedEncodingException
        This method is replacement function for URLEncoder Function URL encoder function converts input string into URLEncoded byte stream after converting Unicode string into bytes using native encoding. The URLEncoder does not work for OpenAM if default encoding is not UTF-8, hence this method was written.
        Parameters:
        input - the input string.
        enc - the encoding format.
        Returns:
        the encoded string.
        Throws:
        UnsupportedEncodingException - If the encoding is not supported.
      • URLEncodeField

        public static String URLEncodeField​(String input,
                                            String enc,
                                            org.slf4j.Logger debug)
        This method is replacement function for URLEncoder Function URL encoder function converts input string into URLencoded byte stream after converting Unicode string into bytes using native encoding. The URLEncoder does not work for Sun Java System OpenAM if default encoding is not UTF-8, hence this method was written.
        Parameters:
        input - the input string
        enc - the encoding format
        debug - the debug instance to which debug messages need to be printed
        Returns:
        the encoded string
      • URLDecodeField

        public static String URLDecodeField​(String strIn,
                                            org.slf4j.Logger debug)
      • URLDecodeField

        public static String URLDecodeField​(String strIn,
                                            String charset,
                                            org.slf4j.Logger debug)