Package com.sun.identity.shared.locale

Class Locale

java.lang.Object
com.sun.identity.shared.locale.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.

  • Field Details

  • Constructor Details

    • Locale

      public Locale()

  • Method Details

    • 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.

    • getResourceBundle

      protected static ResourceBundle getResourceBundle(String bundle)

    • 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)