public class LocaleConvertUtils extends Object
Utility methods for converting locale-sensitive String scalar values to objects of the specified Class, String arrays to arrays of the specified Class and object to locale-sensitive String scalar value.
The implementations for these method are provided by LocaleConvertUtilsBean
.
These static utility method use the default instance. More sophisticated can be provided
by using a LocaleConvertUtilsBean
instance.
Constructor and Description |
---|
LocaleConvertUtils() |
Modifier and Type | Method and Description |
---|---|
static String |
convert(Object value)
Convert the specified locale-sensitive value into a String.
|
static String |
convert(Object value,
Locale locale,
String pattern)
Convert the specified locale-sensitive value into a String
using the paticular convertion pattern.
|
static String |
convert(Object value,
String pattern)
Convert the specified locale-sensitive value into a String
using the conversion pattern.
|
static Object |
convert(String[] values,
Class<?> clazz)
Convert an array of specified values to an array of objects of the
specified class (if possible).
|
static Object |
convert(String[] values,
Class<?> clazz,
Locale locale,
String pattern)
Convert an array of specified values to an array of objects of the
specified class (if possible) using the convertion pattern.
|
static Object |
convert(String[] values,
Class<?> clazz,
String pattern)
Convert an array of specified values to an array of objects of the
specified class (if possible) using the convertion pattern.
|
static Object |
convert(String value,
Class<?> clazz)
Convert the specified value to an object of the specified class (if
possible).
|
static Object |
convert(String value,
Class<?> clazz,
Locale locale,
String pattern)
Convert the specified value to an object of the specified class (if
possible) using the convertion pattern.
|
static Object |
convert(String value,
Class<?> clazz,
String pattern)
Convert the specified value to an object of the specified class (if
possible) using the convertion pattern.
|
protected static org.apache.commons.collections.FastHashMap |
create(Locale locale)
Deprecated.
This method will be modified to return a Map in the next release.
|
static void |
deregister()
Remove any registered
LocaleConverter . |
static void |
deregister(Class<?> clazz,
Locale locale)
Remove any registered
LocaleConverter for the specified locale and Class. |
static void |
deregister(Locale locale)
Remove any registered
LocaleConverter for the specified locale. |
static boolean |
getApplyLocalized()
Gets applyLocalized.
|
static Locale |
getDefaultLocale()
Gets the
Locale which will be used when
no Locale is passed to a method. |
static LocaleConverter |
lookup(Class<?> clazz,
Locale locale)
Look up and return any registered
LocaleConverter for the specified
destination class and locale; if there is no registered Converter, return
null . |
protected static org.apache.commons.collections.FastHashMap |
lookup(Locale locale)
Deprecated.
This method will be modified to return a Map in the next release.
|
static void |
register(LocaleConverter converter,
Class<?> clazz,
Locale locale)
Register a custom
LocaleConverter for the specified destination
Class , replacing any previously registered converter. |
static void |
setApplyLocalized(boolean newApplyLocalized)
Sets applyLocalized.
|
static void |
setDefaultLocale(Locale locale)
Sets the
Locale which will be used when
no Locale is passed to a method. |
public LocaleConvertUtils()
public static Locale getDefaultLocale()
Gets the Locale
which will be used when
no Locale
is passed to a method.
For more details see LocaleConvertUtilsBean
LocaleConvertUtilsBean.getDefaultLocale()
public static void setDefaultLocale(Locale locale)
Sets the Locale
which will be used when
no Locale
is passed to a method.
For more details see LocaleConvertUtilsBean
locale
- the default localeLocaleConvertUtilsBean.setDefaultLocale(Locale)
public static boolean getApplyLocalized()
Gets applyLocalized.
For more details see LocaleConvertUtilsBean
true
if pattern is localized,
otherwise false
LocaleConvertUtilsBean.getApplyLocalized()
public static void setApplyLocalized(boolean newApplyLocalized)
Sets applyLocalized.
For more details see LocaleConvertUtilsBean
newApplyLocalized
- true
if pattern is localized,
otherwise false
LocaleConvertUtilsBean.setApplyLocalized(boolean)
public static String convert(Object value)
Convert the specified locale-sensitive value into a String.
For more details see LocaleConvertUtilsBean
value
- The Value to be convertedLocaleConvertUtilsBean.convert(Object)
public static String convert(Object value, String pattern)
Convert the specified locale-sensitive value into a String using the conversion pattern.
For more details see LocaleConvertUtilsBean
value
- The Value to be convertedpattern
- The convertion patternLocaleConvertUtilsBean.convert(Object, String)
public static String convert(Object value, Locale locale, String pattern)
Convert the specified locale-sensitive value into a String using the paticular convertion pattern.
For more details see LocaleConvertUtilsBean
value
- The Value to be convertedlocale
- The localepattern
- The convertion patternLocaleConvertUtilsBean.convert(Object, Locale, String)
public static Object convert(String value, Class<?> clazz)
Convert the specified value to an object of the specified class (if possible). Otherwise, return a String representation of the value.
For more details see LocaleConvertUtilsBean
value
- The String scalar value to be convertedclazz
- The Data type to which this value should be converted.LocaleConvertUtilsBean.convert(String, Class)
public static Object convert(String value, Class<?> clazz, String pattern)
Convert the specified value to an object of the specified class (if possible) using the convertion pattern. Otherwise, return a String representation of the value.
For more details see LocaleConvertUtilsBean
value
- The String scalar value to be convertedclazz
- The Data type to which this value should be converted.pattern
- The convertion patternLocaleConvertUtilsBean.convert(String, Class, String)
public static Object convert(String value, Class<?> clazz, Locale locale, String pattern)
Convert the specified value to an object of the specified class (if possible) using the convertion pattern. Otherwise, return a String representation of the value.
For more details see LocaleConvertUtilsBean
value
- The String scalar value to be convertedclazz
- The Data type to which this value should be converted.locale
- The localepattern
- The convertion patternLocaleConvertUtilsBean.convert(String, Class, Locale, String)
public static Object convert(String[] values, Class<?> clazz, String pattern)
Convert an array of specified values to an array of objects of the specified class (if possible) using the convertion pattern.
For more details see LocaleConvertUtilsBean
values
- Value to be converted (may be null)clazz
- Java array or element class to be converted topattern
- The convertion patternLocaleConvertUtilsBean.convert(String[], Class, String)
public static Object convert(String[] values, Class<?> clazz)
Convert an array of specified values to an array of objects of the specified class (if possible).
For more details see LocaleConvertUtilsBean
values
- Value to be converted (may be null)clazz
- Java array or element class to be converted toLocaleConvertUtilsBean.convert(String[], Class)
public static Object convert(String[] values, Class<?> clazz, Locale locale, String pattern)
Convert an array of specified values to an array of objects of the specified class (if possible) using the convertion pattern.
For more details see LocaleConvertUtilsBean
values
- Value to be converted (may be null)clazz
- Java array or element class to be converted tolocale
- The localepattern
- The convertion patternLocaleConvertUtilsBean.convert(String[], Class, Locale, String)
public static void register(LocaleConverter converter, Class<?> clazz, Locale locale)
Register a custom LocaleConverter
for the specified destination
Class
, replacing any previously registered converter.
For more details see LocaleConvertUtilsBean
converter
- The LocaleConverter to be registeredclazz
- The Destination class for conversions performed by this
Converterlocale
- The localeLocaleConvertUtilsBean.register(LocaleConverter, Class, Locale)
public static void deregister()
Remove any registered LocaleConverter
.
For more details see LocaleConvertUtilsBean
LocaleConvertUtilsBean.deregister()
public static void deregister(Locale locale)
Remove any registered LocaleConverter
for the specified locale.
For more details see LocaleConvertUtilsBean
locale
- The localeLocaleConvertUtilsBean.deregister(Locale)
public static void deregister(Class<?> clazz, Locale locale)
Remove any registered LocaleConverter
for the specified locale and Class.
For more details see LocaleConvertUtilsBean
clazz
- Class for which to remove a registered Converterlocale
- The localeLocaleConvertUtilsBean.deregister(Class, Locale)
public static LocaleConverter lookup(Class<?> clazz, Locale locale)
Look up and return any registered LocaleConverter
for the specified
destination class and locale; if there is no registered Converter, return
null
.
For more details see LocaleConvertUtilsBean
clazz
- Class for which to return a registered Converterlocale
- The LocaleLocaleConvertUtilsBean.lookup(Class, Locale)
@Deprecated protected static org.apache.commons.collections.FastHashMap lookup(Locale locale)
Look up and return any registered FastHashMap instance for the specified locale.
For more details see LocaleConvertUtilsBean
locale
- The LocaleLocaleConverter
types for
the specified locale.LocaleConvertUtilsBean.lookup(Locale)
@Deprecated protected static org.apache.commons.collections.FastHashMap create(Locale locale)
Create all LocaleConverter
types for specified locale.
For more details see LocaleConvertUtilsBean
locale
- The LocaleLocaleConverter
types
for the specified locale.LocaleConvertUtilsBean.create(Locale)
Copyright © 2000–2016 The Apache Software Foundation. All rights reserved.