com.feilong.lib.beanutils.locale.converters.LongLocaleConverter Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation
Show all versions of feilong Show documentation
feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.
/*
* 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 com.feilong.lib.beanutils.locale.converters;
import java.text.ParseException;
import java.util.Locale;
/**
*
* Standard {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* implementation that converts an incoming
* locale-sensitive String into a java.lang.Long object,
* optionally using a default value or throwing a
* {@link com.feilong.lib.beanutils.ConversionException}
* if a conversion error occurs.
*
*
* @version $Id$
*/
public class LongLocaleConverter extends DecimalLocaleConverter{
// ----------------------------------------------------------- Constructors
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.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.
*
*/
public LongLocaleConverter(){
this(false);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.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 LongLocaleConverter(final boolean locPattern){
this(Locale.getDefault(), locPattern);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.ConversionException}
* if a conversion error occurs. An unlocalized pattern is used for the convertion.
*
* @param locale
* The locale
*/
public LongLocaleConverter(final Locale locale){
this(locale, false);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.ConversionException}
* if a conversion error occurs.
*
* @param locale
* The locale
* @param locPattern
* Indicate whether the pattern is localized or not
*/
public LongLocaleConverter(final Locale locale, final boolean locPattern){
this(locale, (String) null, locPattern);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.ConversionException}
* if a conversion error occurs. An unlocalized pattern is used for the convertion.
*
* @param locale
* The locale
* @param pattern
* The convertion pattern
*/
public LongLocaleConverter(final Locale locale, final String pattern){
this(locale, pattern, false);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will throw a {@link com.feilong.lib.beanutils.ConversionException}
* if a conversion error occurs.
*
* @param locale
* The locale
* @param pattern
* The convertion pattern
* @param locPattern
* Indicate whether the pattern is localized or not
*/
public LongLocaleConverter(final Locale locale, final String pattern, final boolean locPattern){
super(locale, pattern, locPattern);
}
/**
* Create a {@link com.feilong.lib.beanutils.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 convertion.
*
* @param defaultValue
* The default value to be returned
*/
public LongLocaleConverter(final Object defaultValue){
this(defaultValue, false);
}
/**
* Create a {@link com.feilong.lib.beanutils.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 LongLocaleConverter(final Object defaultValue, final boolean locPattern){
this(defaultValue, Locale.getDefault(), locPattern);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs. An unlocalized pattern is used for the convertion.
*
* @param defaultValue
* The default value to be returned
* @param locale
* The locale
*/
public LongLocaleConverter(final Object defaultValue, final Locale locale){
this(defaultValue, locale, false);
}
/**
* Create a {@link com.feilong.lib.beanutils.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 LongLocaleConverter(final Object defaultValue, final Locale locale, final boolean locPattern){
this(defaultValue, locale, null, locPattern);
}
/**
* Create a {@link com.feilong.lib.beanutils.locale.LocaleConverter}
* that will return the specified default value
* if a conversion error occurs. An unlocalized pattern is used for the convertion.
*
* @param defaultValue
* The default value to be returned
* @param locale
* The locale
* @param pattern
* The convertion pattern
*/
public LongLocaleConverter(final Object defaultValue, final Locale locale, final String pattern){
this(defaultValue, locale, pattern, false);
}
/**
* Create a {@link com.feilong.lib.beanutils.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 convertion pattern
* @param locPattern
* Indicate whether the pattern is localized or not
*/
public LongLocaleConverter(final Object defaultValue, final Locale locale, final String pattern, final boolean locPattern){
super(defaultValue, locale, pattern, locPattern);
}
/**
* Convert the specified locale-sensitive input object into an output object of the
* specified type. This method will return a Long type.
*
* @param value
* The input object to be converted
* @param pattern
* The pattern is used for the convertion
* @return The converted value
*
* @throws com.feilong.lib.beanutils.ConversionException
* if conversion
* cannot be performed successfully
* @throws ParseException
* if an error occurs parsing a String to a Number
* @since 1.8.0
*/
@Override
protected Object parse(final Object value,final String pattern) throws ParseException{
final Object result = super.parse(value, pattern);
if (result == null || result instanceof Long){
return result;
}
return new Long(((Number) result).longValue());
}
}