org.apache.commons.beanutils2.locale.converters.DateLocaleConverter Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of commons-beanutils2 Show documentation
Show all versions of commons-beanutils2 Show documentation
Apache Commons BeanUtils provides an easy-to-use but flexible wrapper around reflection and introspection.
The newest version!
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.commons.beanutils2.locale.converters;
import java.text.DateFormat;
import java.text.DateFormatSymbols;
import java.text.ParseException;
import java.text.ParsePosition;
import java.text.SimpleDateFormat;
import java.util.Locale;
import org.apache.commons.beanutils2.ConversionException;
import org.apache.commons.beanutils2.locale.BaseLocaleConverter;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
/**
* Standard {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* implementation that converts an incoming
* locale-sensitive String into a {@code java.util.Date} object,
* optionally using a default value or throwing a
* {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs.
*/
public class DateLocaleConverter extends BaseLocaleConverter {
/** All logging goes through this logger */
private final Log log = LogFactory.getLog(DateLocaleConverter.class);
/** Should the date conversion be lenient? */
boolean isLenient;
/**
* Default Pattern Characters
*/
private static final String DEFAULT_PATTERN_CHARS = DateLocaleConverter.initDefaultChars();
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.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 conversion.
*/
public DateLocaleConverter() {
this(false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs. The locale is the default locale for
* this instance of the Java Virtual Machine.
*
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final boolean locPattern) {
this(Locale.getDefault(), locPattern);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs. An unlocalized pattern is used for the conversion.
*
* @param locale The locale
*/
public DateLocaleConverter(final Locale locale) {
this(locale, false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs.
*
* @param locale The locale
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final Locale locale, final boolean locPattern) {
this(locale, (String) null, locPattern);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs. An unlocalized pattern is used for the conversion.
*
* @param locale The locale
* @param pattern The conversion pattern
*/
public DateLocaleConverter(final Locale locale, final String pattern) {
this(locale, pattern, false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will throw a {@link org.apache.commons.beanutils2.ConversionException}
* if a conversion error occurs.
*
* @param locale The locale
* @param pattern The conversion pattern
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final Locale locale, final String pattern, final boolean locPattern) {
super(locale, pattern, locPattern);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.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 conversion.
*
* @param defaultValue The default value to be returned
*/
public DateLocaleConverter(final Object defaultValue) {
this(defaultValue, false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.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.
*
* @param defaultValue The default value to be returned
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final Object defaultValue, final boolean locPattern) {
this(defaultValue, Locale.getDefault(), locPattern);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs. An unlocalized pattern is used for the conversion.
*
* @param defaultValue The default value to be returned
* @param locale The locale
*/
public DateLocaleConverter(final Object defaultValue, final Locale locale) {
this(defaultValue, locale, false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs.
*
* @param defaultValue The default value to be returned
* @param locale The locale
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final Object defaultValue, final Locale locale, final boolean locPattern) {
this(defaultValue, locale, null, locPattern);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs. An unlocalized pattern is used for the conversion.
*
* @param defaultValue The default value to be returned
* @param locale The locale
* @param pattern The conversion pattern
*/
public DateLocaleConverter(final Object defaultValue, final Locale locale, final String pattern) {
this(defaultValue, locale, pattern, false);
}
/**
* Create a {@link org.apache.commons.beanutils2.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs.
*
* @param defaultValue The default value to be returned
* @param locale The locale
* @param pattern The conversion pattern
* @param locPattern Indicate whether the pattern is localized or not
*/
public DateLocaleConverter(final Object defaultValue, final Locale locale, final String pattern,
final boolean locPattern) {
super(defaultValue, locale, pattern, locPattern);
}
/**
* Returns whether date formatting is lenient.
*
* @return true if the {@code DateFormat} used for formatting is lenient
* @see java.text.DateFormat#isLenient
*/
public boolean isLenient() {
return isLenient;
}
/**
* Specify whether or not date-time parsing should be lenient.
*
* @param lenient true if the {@code DateFormat} used for formatting should be lenient
* @see java.text.DateFormat#setLenient
*/
public void setLenient(final boolean lenient) {
isLenient = lenient;
}
/**
* Convert the specified locale-sensitive input object into an output object of the
* specified type.
*
* @param value The input object to be converted
* @param pattern The pattern is used for the conversion
* @return the converted Date value
*
* @throws org.apache.commons.beanutils2.ConversionException
* if conversion cannot be performed successfully
* @throws ParseException if an error occurs parsing
*/
@Override
protected Object parse(final Object value, String pattern) throws ParseException {
// Handle Date
if (value instanceof java.util.Date) {
return value;
}
// Handle Calendar
if (value instanceof java.util.Calendar) {
return ((java.util.Calendar)value).getTime();
}
if (locPattern) {
pattern = convertLocalizedPattern(pattern, locale);
}
// Create Formatter - use default if pattern is null
final DateFormat formatter = pattern == null ? DateFormat.getDateInstance(DateFormat.SHORT, locale)
: new SimpleDateFormat(pattern, locale);
formatter.setLenient(isLenient);
// Parse the Date
final ParsePosition pos = new ParsePosition(0);
final String strValue = value.toString();
final Object parsedValue = formatter.parseObject(strValue, pos);
if (pos.getErrorIndex() > -1) {
throw new ConversionException("Error parsing date '" + value +
"' at position="+ pos.getErrorIndex());
}
if (pos.getIndex() < strValue.length()) {
throw new ConversionException("Date '" + value +
"' contains unparsed characters from position=" + pos.getIndex());
}
return parsedValue;
}
/**
* Convert a pattern from a localized format to the default format.
*
* @param locale The locale
* @param localizedPattern The pattern in 'local' symbol format
* @return pattern in 'default' symbol format
*/
private String convertLocalizedPattern(final String localizedPattern, final Locale locale) {
if (localizedPattern == null) {
return null;
}
// Note that this is a little obtuse.
// However, it is the best way that anyone can come up with
// that works with some 1.4 series JVM.
// Get the symbols for the localized pattern
final DateFormatSymbols localizedSymbols = new DateFormatSymbols(locale);
final String localChars = localizedSymbols.getLocalPatternChars();
if (DEFAULT_PATTERN_CHARS.equals(localChars)) {
return localizedPattern;
}
// Convert the localized pattern to default
String convertedPattern = null;
try {
convertedPattern = convertPattern(localizedPattern,
localChars,
DEFAULT_PATTERN_CHARS);
} catch (final Exception ex) {
if (log.isDebugEnabled()) {
log.debug("Converting pattern '" + localizedPattern + "' for " + locale, ex);
}
}
return convertedPattern;
}
/**
* Converts a Pattern from one character set to another.
*/
private String convertPattern(final String pattern, final String fromChars, final String toChars) {
final StringBuilder converted = new StringBuilder();
boolean quoted = false;
for (int i = 0; i < pattern.length(); ++i) {
char thisChar = pattern.charAt(i);
if (quoted) {
if (thisChar == '\'') {
quoted = false;
}
} else {
if (thisChar == '\'') {
quoted = true;
} else if ((thisChar >= 'a' && thisChar <= 'z') ||
(thisChar >= 'A' && thisChar <= 'Z')) {
final int index = fromChars.indexOf(thisChar );
if (index == -1) {
throw new IllegalArgumentException(
"Illegal pattern character '" + thisChar + "'");
}
thisChar = toChars.charAt(index);
}
}
converted.append(thisChar);
}
if (quoted) {
throw new IllegalArgumentException("Unfinished quote in pattern");
}
return converted.toString();
}
/**
* This method is called at class initialization time to define the
* value for constant member DEFAULT_PATTERN_CHARS. All other methods needing
* this data should just read that constant.
*/
private static String initDefaultChars() {
final DateFormatSymbols defaultSymbols = new DateFormatSymbols(Locale.US);
return defaultSymbols.getLocalPatternChars();
}
}