Class BaseLocaleConverter
- java.lang.Object
-
- org.apache.commons.beanutils.locale.BaseLocaleConverter
-
- All Implemented Interfaces:
Converter
,LocaleConverter
- Direct Known Subclasses:
DateLocaleConverter
,DecimalLocaleConverter
,StringLocaleConverter
public abstract class BaseLocaleConverter extends java.lang.Object implements LocaleConverter
The base class for all standart type locale-sensitive converters. It has
LocaleConverter
andConverter
implementations, that convert an incoming locale-sensitive Object into an object of correspond type, optionally using a default value or throwing aConversionException
if a conversion error occurs.- Version:
- $Id$
-
-
Field Summary
Fields Modifier and Type Field Description protected java.util.Locale
locale
The locale specified to our Constructor, by default - system locale.protected boolean
locPattern
The flag indicating whether the given pattern string is localized or not.protected java.lang.String
pattern
The default pattern specified to our Constructor, if any.protected boolean
useDefault
Should we return the default value on conversion errors?
-
Constructor Summary
Constructors Modifier Constructor Description protected
BaseLocaleConverter(java.lang.Object defaultValue, java.util.Locale locale, java.lang.String pattern)
Create aLocaleConverter
that will return the specified default value if a conversion error occurs.protected
BaseLocaleConverter(java.lang.Object defaultValue, java.util.Locale locale, java.lang.String pattern, boolean locPattern)
Create aLocaleConverter
that will return the specified default value if a conversion error occurs.protected
BaseLocaleConverter(java.util.Locale locale, java.lang.String pattern)
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.protected
BaseLocaleConverter(java.util.Locale locale, java.lang.String pattern, boolean locPattern)
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description <T> T
convert(java.lang.Class<T> type, java.lang.Object value)
Convert the specified locale-sensitive input object into an output object of the specified type.<T> T
convert(java.lang.Class<T> type, java.lang.Object value, java.lang.String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.java.lang.Object
convert(java.lang.Object value)
Convert the specified locale-sensitive input object into an output object.java.lang.Object
convert(java.lang.Object value, java.lang.String pattern)
Convert the specified locale-sensitive input object into an output object.protected abstract java.lang.Object
parse(java.lang.Object value, java.lang.String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.
-
-
-
Field Detail
-
useDefault
protected boolean useDefault
Should we return the default value on conversion errors?
-
locale
protected java.util.Locale locale
The locale specified to our Constructor, by default - system locale.
-
pattern
protected java.lang.String pattern
The default pattern specified to our Constructor, if any.
-
locPattern
protected boolean locPattern
The flag indicating whether the given pattern string is localized or not.
-
-
Constructor Detail
-
BaseLocaleConverter
protected BaseLocaleConverter(java.util.Locale locale, java.lang.String pattern)
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs. An unlocalized pattern is used for the convertion.- Parameters:
locale
- The localepattern
- The convertion pattern
-
BaseLocaleConverter
protected BaseLocaleConverter(java.util.Locale locale, java.lang.String pattern, boolean locPattern)
Create aLocaleConverter
that will throw aConversionException
if a conversion error occurs.- Parameters:
locale
- The localepattern
- The convertion patternlocPattern
- Indicate whether the pattern is localized or not
-
BaseLocaleConverter
protected BaseLocaleConverter(java.lang.Object defaultValue, java.util.Locale locale, java.lang.String pattern)
Create aLocaleConverter
that will return the specified default value if a conversion error occurs. An unlocalized pattern is used for the convertion.- Parameters:
defaultValue
- The default value to be returnedlocale
- The localepattern
- The convertion pattern
-
BaseLocaleConverter
protected BaseLocaleConverter(java.lang.Object defaultValue, java.util.Locale locale, java.lang.String pattern, boolean locPattern)
Create aLocaleConverter
that will return the specified default value if a conversion error occurs.- Parameters:
defaultValue
- The default value to be returnedlocale
- The localepattern
- The convertion patternlocPattern
- Indicate whether the pattern is localized or not
-
-
Method Detail
-
parse
protected abstract java.lang.Object parse(java.lang.Object value, java.lang.String pattern) throws java.text.ParseException
Convert the specified locale-sensitive input object into an output object of the specified type.- Parameters:
value
- The input object to be convertedpattern
- The pattern is used for the convertion- Returns:
- The converted value
- Throws:
java.text.ParseException
- if conversion cannot be performed successfully
-
convert
public java.lang.Object convert(java.lang.Object value)
Convert the specified locale-sensitive input object into an output object. The default pattern is used for the conversion.- Parameters:
value
- The input object to be converted- Returns:
- The converted value
- Throws:
ConversionException
- if conversion cannot be performed successfully
-
convert
public java.lang.Object convert(java.lang.Object value, java.lang.String pattern)
Convert the specified locale-sensitive input object into an output object.- Parameters:
value
- The input object to be convertedpattern
- The pattern is used for the conversion- Returns:
- The converted value
- Throws:
ConversionException
- if conversion cannot be performed successfully
-
convert
public <T> T convert(java.lang.Class<T> type, java.lang.Object value)
Convert the specified locale-sensitive input object into an output object of the specified type. The default pattern is used for the convertion.- Specified by:
convert
in interfaceConverter
- Type Parameters:
T
- The desired target type of the conversion- Parameters:
type
- Data type to which this value should be convertedvalue
- The input object to be converted- Returns:
- The converted value
- Throws:
ConversionException
- if conversion cannot be performed successfully
-
convert
public <T> T convert(java.lang.Class<T> type, java.lang.Object value, java.lang.String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.- Specified by:
convert
in interfaceLocaleConverter
- Type Parameters:
T
- The desired target type of the conversion- Parameters:
type
- Data is type to which this value should be convertedvalue
- is the input object to be convertedpattern
- is the pattern is used for the conversion; if null is passed then the default pattern associated with the converter object will be used.- Returns:
- The converted value
- Throws:
ConversionException
- if conversion cannot be performed successfully
-
-