com.feilong.lib.beanutils.ConvertUtils 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;
/**
* Utility methods for converting String scalar values to objects of the
* specified Class, String arrays to arrays of the specified Class.
*
*
* For more details, see ConvertUtilsBean which provides the
* implementations for these methods.
*
*
* @version $Id$
* @see ConvertUtilsBean
*/
public class ConvertUtils{
// --------------------------------------------------------- Public Classes
/**
* Convert the specified value into a String.
*
*
* For more details see ConvertUtilsBean.
*
*
* @param value
* Value to be converted (may be null)
* @return The converted String value or null if value is null
*
* @see ConvertUtilsBean#convert(Object)
*/
public static String convert(final Object value){
return ConvertUtilsBean.getInstance().convert(value);
}
/**
* 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 ConvertUtilsBean.
*
*
* @param value
* Value to be converted (may be null)
* @param clazz
* Java class to be converted to (must not be null)
* @return The converted value
*
* @see ConvertUtilsBean#convert(String, Class)
*/
public static Object convert(final String value,final Class clazz){
return ConvertUtilsBean.getInstance().convert(value, clazz);
}
/**
* Convert an array of specified values to an array of objects of the specified class (if possible).
*
*
* For more details see ConvertUtilsBean.
*
*
* @param values
* Array of values to be converted
* @param clazz
* Java array or element class to be converted to (must not be null)
* @return The converted value
*
* @see ConvertUtilsBean#convert(String[], Class)
*/
public static Object convert(final String[] values,final Class clazz){
return ConvertUtilsBean.getInstance().convert(values, clazz);
}
/**
* Convert the value to an object of the specified class (if possible).
*
* @param value
* Value to be converted (may be null)
* @param targetType
* Class of the value to be converted to (must not be null)
* @return The converted value
*
* @throws ConversionException
* if thrown by an underlying Converter
*/
public static Object convert(final Object value,final Class targetType){
return ConvertUtilsBean.getInstance().convert(value, targetType);
}
/**
*
* Remove all registered {@link Converter}s, and re-establish the standard Converters.
*
*
*
* For more details see ConvertUtilsBean.
*
*
* @see ConvertUtilsBean#deregister()
* @deprecated 这种会影响全局, 后面版本会去掉,暂时没有替换的方法保留
*/
@Deprecated
public static void deregister(){
ConvertUtilsBean.getInstance().deregister();
}
/**
*
* Remove any registered {@link Converter} for the specified destination
* Class.
*
*
*
* For more details see ConvertUtilsBean.
*
*
* @param clazz
* Class for which to remove a registered Converter
* @see ConvertUtilsBean#deregister(Class)
* @deprecated 这种会影响全局, 后面版本会去掉,暂时没有替换的方法保留
*/
@Deprecated
public static void deregister(final Class clazz){
ConvertUtilsBean.getInstance().deregister(clazz);
}
/**
* Look up and return any registered {@link Converter} for the specified
* destination class; if there is no registered Converter, return
* null.
*
*
* For more details see ConvertUtilsBean.
*
*
* @param clazz
* Class for which to return a registered Converter
* @return The registered {@link Converter} or null if not found
* @see ConvertUtilsBean#lookup(Class)
*/
public static Converter lookup(final Class clazz){
return ConvertUtilsBean.getInstance().lookup(clazz);
}
/**
*
* Register a custom {@link Converter} for the specified destination
* Class, replacing any previously registered Converter.
*
*
*
* For more details see ConvertUtilsBean.
*
*
* @param converter
* Converter to be registered
* @param clazz
* Destination class for conversions performed by this
* Converter
* @see ConvertUtilsBean#register(Converter, Class)
* @deprecated 这种会影响全局, 后面版本会去掉,暂时没有替换的方法保留
*/
@Deprecated
public static void register(final Converter converter,final Class clazz){
ConvertUtilsBean.getInstance().register(converter, clazz);
}
/**
* Change primitive Class types to the associated wrapper class. This is
* useful for concrete converter implementations which typically treat
* primitive types like their corresponding wrapper types.
*
* @param
* The type to be checked.
* @param type
* The class type to check.
* @return The converted type.
* @since 1.9
*/
// All type casts are safe because the TYPE members of the wrapper types
// return their own class.
@SuppressWarnings("unchecked")
public static Class primitiveToWrapper(final Class type){
if (type == null || !type.isPrimitive()){
return type;
}
if (type == Integer.TYPE){
return (Class) Integer.class;
}else if (type == Double.TYPE){
return (Class) Double.class;
}else if (type == Long.TYPE){
return (Class) Long.class;
}else if (type == Boolean.TYPE){
return (Class) Boolean.class;
}else if (type == Float.TYPE){
return (Class) Float.class;
}else if (type == Short.TYPE){
return (Class) Short.class;
}else if (type == Byte.TYPE){
return (Class) Byte.class;
}else if (type == Character.TYPE){
return (Class) Character.class;
}else{
return type;
}
}
}