com.iplanet.am.util
Class Locale

java.lang.Object
  com.iplanet.am.util.Locale

public class Locale

extends java.lang.Object

This class Locale.java is a utility that provides functionality for applications and services to internationalize their messages.

Constructor Summary

Locale()

Method Summary

static java.lang.String	convertDateString(java.lang.String srcDateString, java.util.Locale srcLocale, java.util.Locale dstLocale) Converts date string from source locale to destination locale
static java.lang.String	formatMessage(java.lang.String formatStr, java.lang.Object obj1) Formats messages using MessageFormat Class.
static java.lang.String	formatMessage(java.lang.String formatStr, java.lang.Object[] objs) Formats to format messages using MessageFormat Class.
static java.lang.String	getDateString(java.util.Date date, java.util.Locale locale) Gets date string from date with specified locale.
static java.util.Locale	getDefaultLocale() Gets the default locale
static java.util.ResourceBundle	getInstallResourceBundle(java.lang.String bundle) Gets the default install resource bundle for the default locale
static java.util.Locale	getLocale(java.lang.String stringformat) Gets the locale object for the specified localized string format.
static java.util.Locale	getLocaleObjFromAcceptLangHeader(java.lang.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
static java.lang.String	getLocaleStringFromAcceptLangHeader(java.lang.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
static java.lang.String	getNormalizedDateString(java.util.Date date) Converts the Date object into ISO-8601 format yyyy/MM/dd HH:mm like 2002/12/23 20:40.
static java.util.ResourceBundle	getResourceBundle(java.lang.String bundle, java.lang.String stringformat) Gets the resource bundle corresponding to the specified locale and the localized property file name.
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource) Gets the localized string for the specified key.
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource, Debug debug) Gets the localized string for the specified key
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource, Debug debug, java.util.ResourceBundle defaultRb) Gets the localized string for the specified key from the specified Resource or from the specified default resource
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource, java.lang.Object[] params) Gets the localized string for the specified key formatted as per passed parameters.
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource, java.util.ResourceBundle defaultRb) Gets the localized string for the specified key from the specified Resource or from the specified default resource.
static java.lang.String	getString(java.util.ResourceBundle rb, java.lang.String resource, java.util.ResourceBundle defaultRb, java.lang.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.
static void	main(java.lang.String[] args)
static java.util.Date	parseDateString(java.lang.String dateString, java.util.Locale locale) Gets Date object from date string with specified locale.
static java.util.Date	parseDateString(java.lang.String dateString, java.util.Locale locale, java.lang.String dateSyntax) Gets Date object from date string with specified locale.
static java.util.Date	parseNormalizedDateString(java.lang.String dateString) Returns the Date object from the date string in ISO-8601 format.
static java.lang.String	URLDecodeField(java.lang.String strIn, Debug debug)
static java.lang.String	URLDecodeField(java.lang.String strIn, java.lang.String charset, Debug debug)
static java.lang.String	URLEncodeField(java.lang.String input, java.lang.String enc) 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.
static java.lang.String	URLEncodeField(java.lang.String input, java.lang.String enc, Debug 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.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Locale

public Locale()

Method Detail

main

public static void main(java.lang.String[] args)

getLocale

public static java.util.Locale getLocale(java.lang.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 java.lang.String getLocaleStringFromAcceptLangHeader(java.lang.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 java.util.Locale getLocaleObjFromAcceptLangHeader(java.lang.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 java.util.ResourceBundle getResourceBundle(java.lang.String bundle,
                                                         java.lang.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 java.util.ResourceBundle getInstallResourceBundle(java.lang.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 java.util.Locale getDefaultLocale()

Gets the default locale

Returns:

the default Locale object

formatMessage

public static java.lang.String formatMessage(java.lang.String formatStr,
                                             java.lang.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 java.lang.String formatMessage(java.lang.String formatStr,
                                             java.lang.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 java.util.Date parseNormalizedDateString(java.lang.String dateString)

Returns the Date object from the date string in ISO-8601 format. Access Manager 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 java.util.Date parseDateString(java.lang.String dateString,
                                             java.util.Locale locale,
                                             java.lang.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 java.util.Date parseDateString(java.lang.String dateString,
                                             java.util.Locale locale)

Gets Date object from date string with specified locale. Syntax of date string is defined in amUser_ properties file.

Parameters:

dateString - date string

locale - Locale object

Returns:

Date object. null will be returned if error happens

getNormalizedDateString

public static java.lang.String getNormalizedDateString(java.util.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 java.lang.String getDateString(java.util.Date date,
                                             java.util.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 java.lang.String convertDateString(java.lang.String srcDateString,
                                                 java.util.Locale srcLocale,
                                                 java.util.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 java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.String resource,
                                         java.lang.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 java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.String resource,
                                         java.util.ResourceBundle defaultRb,
                                         java.lang.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 java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.String resource,
                                         Debug debug)

Gets the localized string for the specified key

Parameters:

rb - resource bundle.

resource - the specified key.

debug - the debug instance to which the debug messages need to be printed.

Returns:

the localized string representation

getString

public static java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.String resource,
                                         Debug debug,
                                         java.util.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 java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.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 java.lang.String getString(java.util.ResourceBundle rb,
                                         java.lang.String resource,
                                         java.util.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 java.lang.String URLEncodeField(java.lang.String input,
                                              java.lang.String enc)
                                       throws java.io.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 Sun Java System Access Manager 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:

java.io.UnsupportedEncodingException

URLEncodeField

public static java.lang.String URLEncodeField(java.lang.String input,
                                              java.lang.String enc,
                                              Debug 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 Access Manager 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 java.lang.String URLDecodeField(java.lang.String strIn,
                                              Debug debug)

URLDecodeField

public static java.lang.String URLDecodeField(java.lang.String strIn,
                                              java.lang.String charset,
                                              Debug debug)