com.feilong.lib.beanutils.ConvertUtils Maven / Gradle / Ivy
Show all versions of feilong Show documentation
/*
* 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()
*/
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)
*/
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)
*/
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;
}
}
}