org.apache.commons.beanutils.locale.converters

Class DateLocaleConverter

public class DateLocaleConverter extends BaseLocaleConverter

Standard LocaleConverter implementation that converts an incoming locale-sensitive String into a java.util.Date object, optionally using a default value or throwing a ConversionException if a conversion error occurs.

Author: Yauheny Mikulski Michael Szlapa

Field Summary
booleanisLenient
Should the date conversion be lenient?
static Loglog
All logging goes through this logger
Constructor Summary
DateLocaleConverter()
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, String pattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.
DateLocaleConverter(Object defaultValue)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, String pattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
DateLocaleConverter(Object defaultValue, Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.
Method Summary
SimpleDateFormatgetFormatter(String pattern, Locale locale)
Gets an appropriate SimpleDateFormat for given locale, default Date format pattern is not provided.
booleanisLenient()
Returns whether date formatting is lenient.
protected Objectparse(Object value, String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.
voidsetLenient(boolean lenient)
Specify whether or not date-time parsing should be lenient.

Field Detail

isLenient

boolean isLenient
Should the date conversion be lenient?

log

private static Log log
All logging goes through this logger

Constructor Detail

DateLocaleConverter

public DateLocaleConverter()
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine and an unlocalized pattern is used for the convertion.

DateLocaleConverter

public DateLocaleConverter(boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine.

Parameters: locPattern Indicate whether the pattern is localized or not

DateLocaleConverter

public DateLocaleConverter(Locale locale)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters: locale The locale

DateLocaleConverter

public DateLocaleConverter(Locale locale, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.

Parameters: locale The locale locPattern Indicate whether the pattern is localized or not

DateLocaleConverter

public DateLocaleConverter(Locale locale, String pattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs. An unlocalized pattern is used for the convertion.

Parameters: locale The locale pattern The convertion pattern

DateLocaleConverter

public DateLocaleConverter(Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will throw a ConversionException if a conversion error occurs.

Parameters: locale The locale pattern The convertion pattern locPattern Indicate whether the pattern is localized or not

DateLocaleConverter

public DateLocaleConverter(Object defaultValue)
Create a LocaleConverter that will return the specified default value if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine and an unlocalized pattern is used for the convertion.

Parameters: defaultValue The default value to be returned

DateLocaleConverter

public DateLocaleConverter(Object defaultValue, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs. The locale is the default locale for this instance of the Java Virtual Machine.

Parameters: defaultValue The default value to be returned locPattern Indicate whether the pattern is localized or not

DateLocaleConverter

public DateLocaleConverter(Object defaultValue, Locale locale)
Create a LocaleConverter 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 returned locale The locale

DateLocaleConverter

public DateLocaleConverter(Object defaultValue, Locale locale, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.

Parameters: defaultValue The default value to be returned locale The locale locPattern Indicate whether the pattern is localized or not

DateLocaleConverter

public DateLocaleConverter(Object defaultValue, Locale locale, String pattern)
Create a LocaleConverter 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 returned locale The locale pattern The convertion pattern

DateLocaleConverter

public DateLocaleConverter(Object defaultValue, Locale locale, String pattern, boolean locPattern)
Create a LocaleConverter that will return the specified default value if a conversion error occurs.

Parameters: defaultValue The default value to be returned locale The locale pattern The convertion pattern locPattern Indicate whether the pattern is localized or not

Method Detail

getFormatter

private SimpleDateFormat getFormatter(String pattern, Locale locale)
Gets an appropriate SimpleDateFormat for given locale, default Date format pattern is not provided.

isLenient

public boolean isLenient()
Returns whether date formatting is lenient.

Returns: true if the DateFormat used for formatting is lenient

See Also: java.text.DateFormat#isLenient

parse

protected Object parse(Object value, String pattern)
Convert the specified locale-sensitive input object into an output object of the specified type.

Parameters: value The input object to be converted pattern The pattern is used for the convertion

Throws: org.apache.commons.beanutils.ConversionException if conversion cannot be performed successfully

setLenient

public void setLenient(boolean lenient)
Specify whether or not date-time parsing should be lenient.

Parameters: lenient true if the DateFormat used for formatting should be lenient

See Also: java.text.DateFormat#setLenient

Copyright (c) 2001-2004 - Apache Software Foundation