com.dahuatech.hutool.core.convert.Convert Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of java-sdk-common Show documentation
Show all versions of java-sdk-common Show documentation
Dahua ICC Open API SDK for Java
package com.dahuatech.hutool.core.convert;
import com.dahuatech.hutool.core.convert.impl.CollectionConverter;
import com.dahuatech.hutool.core.convert.impl.GenericEnumConverter;
import com.dahuatech.hutool.core.convert.impl.MapConverter;
import com.dahuatech.hutool.core.lang.Assert;
import com.dahuatech.hutool.core.lang.TypeReference;
import com.dahuatech.hutool.core.text.UnicodeUtil;
import com.dahuatech.hutool.core.util.CharsetUtil;
import com.dahuatech.hutool.core.util.ClassUtil;
import com.dahuatech.hutool.core.util.HexUtil;
import com.dahuatech.hutool.core.util.StrUtil;
import java.lang.reflect.Type;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.nio.charset.Charset;
import java.util.*;
import java.util.concurrent.TimeUnit;
/**
* 类型转换器
*
* @author xiaoleilu
*/
public class Convert {
/**
* 转换为字符串
* 如果给定的值为null，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static String toStr(Object value, String defaultValue) {
return convertQuietly(String.class, value, defaultValue);
}
/**
* 转换为字符串
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static String toStr(Object value) {
return toStr(value, null);
}
/**
* 转换为String数组
*
* @param value 被转换的值
* @return String数组
* @since 3.2.0
*/
public static String[] toStrArray(Object value) {
return convert(String[].class, value);
}
/**
* 转换为字符
* 如果给定的值为null，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Character toChar(Object value, Character defaultValue) {
return convertQuietly(Character.class, value, defaultValue);
}
/**
* 转换为字符
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Character toChar(Object value) {
return toChar(value, null);
}
/**
* 转换为Character数组
*
* @param value 被转换的值
* @return Character数组
* @since 3.2.0
*/
public static Character[] toCharArray(Object value) {
return convert(Character[].class, value);
}
/**
* 转换为byte
* 如果给定的值为null，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Byte toByte(Object value, Byte defaultValue) {
return convertQuietly(Byte.class, value, defaultValue);
}
/**
* 转换为byte
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Byte toByte(Object value) {
return toByte(value, null);
}
/**
* 转换为Byte数组
*
* @param value 被转换的值
* @return Byte数组
* @since 3.2.0
*/
public static Byte[] toByteArray(Object value) {
return convert(Byte[].class, value);
}
/**
* 转换为Short
* 如果给定的值为null，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Short toShort(Object value, Short defaultValue) {
return convertQuietly(Short.class, value, defaultValue);
}
/**
* 转换为Short
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Short toShort(Object value) {
return toShort(value, null);
}
/**
* 转换为Short数组
*
* @param value 被转换的值
* @return Short数组
* @since 3.2.0
*/
public static Short[] toShortArray(Object value) {
return convert(Short[].class, value);
}
/**
* 转换为Number
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Number toNumber(Object value, Number defaultValue) {
return convertQuietly(Number.class, value, defaultValue);
}
/**
* 转换为Number
* 如果给定的值为空，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Number toNumber(Object value) {
return toNumber(value, null);
}
/**
* 转换为Number数组
*
* @param value 被转换的值
* @return Number数组
* @since 3.2.0
*/
public static Number[] toNumberArray(Object value) {
return convert(Number[].class, value);
}
/**
* 转换为int
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Integer toInt(Object value, Integer defaultValue) {
return convertQuietly(Integer.class, value, defaultValue);
}
/**
* 转换为int
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Integer toInt(Object value) {
return toInt(value, null);
}
/**
* 转换为Integer数组
*
* @param value 被转换的值
* @return 结果
*/
public static Integer[] toIntArray(Object value) {
return convert(Integer[].class, value);
}
/**
* 转换为long
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Long toLong(Object value, Long defaultValue) {
return convertQuietly(Long.class, value, defaultValue);
}
/**
* 转换为long
* 如果给定的值为null，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Long toLong(Object value) {
return toLong(value, null);
}
/**
* 转换为Long数组
*
* @param value 被转换的值
* @return 结果
*/
public static Long[] toLongArray(Object value) {
return convert(Long[].class, value);
}
/**
* 转换为double
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Double toDouble(Object value, Double defaultValue) {
return convertQuietly(Double.class, value, defaultValue);
}
/**
* 转换为double
* 如果给定的值为空，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Double toDouble(Object value) {
return toDouble(value, null);
}
/**
* 转换为Double数组
*
* @param value 被转换的值
* @return 结果
*/
public static Double[] toDoubleArray(Object value) {
return convert(Double[].class, value);
}
/**
* 转换为Float
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Float toFloat(Object value, Float defaultValue) {
return convertQuietly(Float.class, value, defaultValue);
}
/**
* 转换为Float
* 如果给定的值为空，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Float toFloat(Object value) {
return toFloat(value, null);
}
/**
* 转换为Float数组
*
* @param value 被转换的值
* @return 结果
*/
public static Float[] toFloatArray(Object value) {
return convert(Float[].class, value);
}
/**
* 转换为boolean
* String支持的值为：true、false、yes、ok、no，1,0 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static Boolean toBool(Object value, Boolean defaultValue) {
return convertQuietly(Boolean.class, value, defaultValue);
}
/**
* 转换为boolean
* 如果给定的值为空，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static Boolean toBool(Object value) {
return toBool(value, null);
}
/**
* 转换为Boolean数组
*
* @param value 被转换的值
* @return 结果
*/
public static Boolean[] toBooleanArray(Object value) {
return convert(Boolean[].class, value);
}
/**
* 转换为BigInteger
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static BigInteger toBigInteger(Object value, BigInteger defaultValue) {
return convertQuietly(BigInteger.class, value, defaultValue);
}
/**
* 转换为BigInteger
* 如果给定的值为空，或者转换失败，返回默认值null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static BigInteger toBigInteger(Object value) {
return toBigInteger(value, null);
}
/**
* 转换为BigDecimal
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
*/
public static BigDecimal toBigDecimal(Object value, BigDecimal defaultValue) {
return convertQuietly(BigDecimal.class, value, defaultValue);
}
/**
* 转换为BigDecimal
* 如果给定的值为空，或者转换失败，返回null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
*/
public static BigDecimal toBigDecimal(Object value) {
return toBigDecimal(value, null);
}
/**
* 转换为Date
* 如果给定的值为空，或者转换失败，返回默认值
* 转换失败不会报错
*
* @param value 被转换的值
* @param defaultValue 转换错误时的默认值
* @return 结果
* @since 4.1.6
*/
public static Date toDate(Object value, Date defaultValue) {
return convertQuietly(Date.class, value, defaultValue);
}
/**
* 转换为Date
* 如果给定的值为空，或者转换失败，返回null
* 转换失败不会报错
*
* @param value 被转换的值
* @return 结果
* @since 4.1.6
*/
public static Date toDate(Object value) {
return toDate(value, null);
}
/**
* 转换为Enum对象
* 如果给定的值为空，或者转换失败，返回默认值
*
* @param 枚举类型
* @param clazz Enum的Class
* @param value 值
* @param defaultValue 默认值
* @return Enum
*/
public static > E toEnum(Class clazz, Object value, E defaultValue) {
return (new GenericEnumConverter<>(clazz)).convertQuietly(value, defaultValue);
}
/**
* 转换为Enum对象
* 如果给定的值为空，或者转换失败，返回默认值null
*
* @param 枚举类型
* @param clazz Enum的Class
* @param value 值
* @return Enum
*/
public static > E toEnum(Class clazz, Object value) {
return toEnum(clazz, value, null);
}
/**
* 转换为集合类
*
* @param collectionType 集合类型
* @param elementType 集合中元素类型
* @param value 被转换的值
* @return {@link Collection}
* @since 3.0.8
*/
public static Collection toCollection(
Class collectionType, Class elementType, Object value) {
return new CollectionConverter(collectionType, elementType).convert(value, null);
}
/**
* 转换为ArrayList，元素类型默认Object
*
* @param value 被转换的值
* @return {@link List}
* @since 4.1.11
*/
public static List toList(Object value) {
return convert(List.class, value);
}
/**
* 转换为ArrayList
*
* @param 元素类型
* @param elementType 集合中元素类型
* @param value 被转换的值
* @return {@link List}
* @since 4.1.20
*/
@SuppressWarnings("unchecked")
public static List toList(Class elementType, Object value) {
return (List) toCollection(ArrayList.class, elementType, value);
}
/**
* 转换为Map
*
* @param 键类型
* @param 值类型
* @param keyType 键类型
* @param valueType 值类型
* @param value 被转换的值
* @return {@link Map}
* @since 4.6.8
*/
@SuppressWarnings("unchecked")
public static Map toMap(Class keyType, Class valueType, Object value) {
return (Map) new MapConverter(HashMap.class, keyType, valueType).convert(value, null);
}
/**
* 转换值为指定类型，类型采用字符串表示
*
* @param 目标类型
* @param className 类的字符串表示
* @param value 值
* @return 转换后的值
* @since 4.0.7
* @throws ConvertException 转换器不存在
*/
@SuppressWarnings("unchecked")
public static T convertByClassName(String className, Object value) throws ConvertException {
return (T) convert(ClassUtil.loadClass(className), value);
}
/**
* 转换值为指定类型
*
* @param 目标类型
* @param type 类型
* @param value 值
* @return 转换后的值
* @since 4.0.0
* @throws ConvertException 转换器不存在
*/
public static T convert(Class type, Object value) throws ConvertException {
return convert((Type) type, value);
}
/**
* 转换值为指定类型
*
* @param 目标类型
* @param reference 类型参考，用于持有转换后的泛型类型
* @param value 值
* @return 转换后的值
* @throws ConvertException 转换器不存在
*/
public static T convert(TypeReference reference, Object value) throws ConvertException {
return convert(reference.getType(), value, null);
}
/**
* 转换值为指定类型
*
* @param 目标类型
* @param type 类型
* @param value 值
* @return 转换后的值
* @throws ConvertException 转换器不存在
*/
public static T convert(Type type, Object value) throws ConvertException {
return convert(type, value, null);
}
/**
* 转换值为指定类型
*
* @param 目标类型
* @param type 类型
* @param value 值
* @param defaultValue 默认值
* @return 转换后的值
* @throws ConvertException 转换器不存在
* @since 4.0.0
*/
public static T convert(Class type, Object value, T defaultValue) throws ConvertException {
return convert((Type) type, value, defaultValue);
}
/**
* 转换值为指定类型
*
* @param 目标类型
* @param type 类型
* @param value 值
* @param defaultValue 默认值
* @return 转换后的值
* @throws ConvertException 转换器不存在
*/
public static T convert(Type type, Object value, T defaultValue) throws ConvertException {
return ConverterRegistry.getInstance().convert(type, value, defaultValue);
}
/**
* 转换值为指定类型，不抛异常转换
* 当转换失败时返回{@code null}
*
* @param 目标类型
* @param type 目标类型
* @param value 值
* @return 转换后的值，转换失败返回null
* @since 4.5.10
*/
public static T convertQuietly(Type type, Object value) {
return convertQuietly(type, value, null);
}
/**
* 转换值为指定类型，不抛异常转换
* 当转换失败时返回默认值
*
* @param 目标类型
* @param type 目标类型
* @param value 值
* @param defaultValue 默认值
* @return 转换后的值
* @since 4.5.10
*/
public static T convertQuietly(Type type, Object value, T defaultValue) {
try {
return convert(type, value, defaultValue);
} catch (Exception e) {
return defaultValue;
}
}
// ----------------------------------------------------------------------- 全角半角转换
/**
* 半角转全角
*
* @param input String.
* @return 全角字符串.
*/
public static String toSBC(String input) {
return toSBC(input, null);
}
/**
* 半角转全角
*
* @param input String
* @param notConvertSet 不替换的字符集合
* @return 全角字符串.
*/
public static String toSBC(String input, Set notConvertSet) {
final char[] c = input.toCharArray();
for (int i = 0; i < c.length; i++) {
if (null != notConvertSet && notConvertSet.contains(c[i])) {
// 跳过不替换的字符
continue;
}
if (c[i] == ' ') {
c[i] = '\u3000';
} else if (c[i] < '\177') {
c[i] = (char) (c[i] + 65248);
}
}
return new String(c);
}
/**
* 全角转半角
*
* @param input String.
* @return 半角字符串
*/
public static String toDBC(String input) {
return toDBC(input, null);
}
/**
* 替换全角为半角
*
* @param text 文本
* @param notConvertSet 不替换的字符集合
* @return 替换后的字符
*/
public static String toDBC(String text, Set notConvertSet) {
if (StrUtil.isBlank(text)) {
return text;
}
final char[] c = text.toCharArray();
for (int i = 0; i < c.length; i++) {
if (null != notConvertSet && notConvertSet.contains(c[i])) {
// 跳过不替换的字符
continue;
}
if (c[i] == '\u3000' || c[i] == '\u00a0' || c[i] == '\u2007' || c[i] == '\u202F') {
// \u3000是中文全角空格，\u00a0、\u2007、\u202F是不间断空格
c[i] = ' ';
} else if (c[i] > '\uFF00' && c[i] < '\uFF5F') {
c[i] = (char) (c[i] - 65248);
}
}
return new String(c);
}
// --------------------------------------------------------------------- hex
/**
* 字符串转换成十六进制字符串，结果为小写
*
* @param str 待转换的ASCII字符串
* @param charset 编码
* @return 16进制字符串
* @see HexUtil#encodeHexStr(String, Charset)
*/
public static String toHex(String str, Charset charset) {
return HexUtil.encodeHexStr(str, charset);
}
/**
* byte数组转16进制串
*
* @param bytes 被转换的byte数组
* @return 转换后的值
* @see HexUtil#encodeHexStr(byte[])
*/
public static String toHex(byte[] bytes) {
return HexUtil.encodeHexStr(bytes);
}
/**
* Hex字符串转换为Byte值
*
* @param src Byte字符串，每个Byte之间没有分隔符
* @return byte[]
* @see HexUtil#decodeHex(char[])
*/
public static byte[] hexToBytes(String src) {
return HexUtil.decodeHex(src.toCharArray());
}
/**
* 十六进制转换字符串
*
* @param hexStr Byte字符串(Byte之间无分隔符 如:[616C6B])
* @param charset 编码 {@link Charset}
* @return 对应的字符串
* @see HexUtil#decodeHexStr(String, Charset)
* @deprecated 请使用 {@link #hexToStr(String, Charset)}
*/
@Deprecated
public static String hexStrToStr(String hexStr, Charset charset) {
return hexToStr(hexStr, charset);
}
/**
* 十六进制转换字符串
*
* @param hexStr Byte字符串(Byte之间无分隔符 如:[616C6B])
* @param charset 编码 {@link Charset}
* @return 对应的字符串
* @see HexUtil#decodeHexStr(String, Charset)
* @since 4.1.11
*/
public static String hexToStr(String hexStr, Charset charset) {
return HexUtil.decodeHexStr(hexStr, charset);
}
/**
* String的字符串转换成unicode的String
*
* @param strText 全角字符串
* @return String 每个unicode之间无分隔符
* @see UnicodeUtil#toUnicode(String)
*/
public static String strToUnicode(String strText) {
return UnicodeUtil.toUnicode(strText);
}
/**
* unicode的String转换成String的字符串
*
* @param unicode Unicode符
* @return String 字符串
* @see UnicodeUtil#toString(String)
*/
public static String unicodeToStr(String unicode) {
return UnicodeUtil.toString(unicode);
}
/**
* 给定字符串转换字符编码
* 如果参数为空，则返回原字符串，不报错。
*
* @param str 被转码的字符串
* @param sourceCharset 原字符集
* @param destCharset 目标字符集
* @return 转换后的字符串
* @see CharsetUtil#convert(String, String, String)
*/
public static String convertCharset(String str, String sourceCharset, String destCharset) {
if (StrUtil.hasBlank(str, sourceCharset, destCharset)) {
return str;
}
return CharsetUtil.convert(str, sourceCharset, destCharset);
}
/**
* 转换时间单位
*
* @param sourceDuration 时长
* @param sourceUnit 源单位
* @param destUnit 目标单位
* @return 目标单位的时长
*/
public static long convertTime(long sourceDuration, TimeUnit sourceUnit, TimeUnit destUnit) {
Assert.notNull(sourceUnit, "sourceUnit is null !");
Assert.notNull(destUnit, "destUnit is null !");
return destUnit.convert(sourceDuration, sourceUnit);
}
// --------------------------------------------------------------- 原始包装类型转换
/**
* 原始类转为包装类，非原始类返回原类
*
* @see BasicType#wrap(Class)
* @param clazz 原始类
* @return 包装类
* @see BasicType#wrap(Class)
*/
public static Class wrap(Class clazz) {
return BasicType.wrap(clazz);
}
/**
* 包装类转为原始类，非包装类返回原类
*
* @see BasicType#unWrap(Class)
* @param clazz 包装类
* @return 原始类
* @see BasicType#unWrap(Class)
*/
public static Class unWrap(Class clazz) {
return BasicType.unWrap(clazz);
}
// -------------------------------------------------------------------------- 数字和英文转换
/**
* 将阿拉伯数字转为英文表达方式
*
* @param number {@link Number}对象
* @return 英文表达式
* @since 3.0.9
*/
public static String numberToWord(Number number) {
return NumberWordFormater.format(number);
}
/**
* 将阿拉伯数字转为中文表达方式
*
* @param number 数字
* @param isUseTraditonal 是否使用繁体字（金额形式）
* @return 中文
* @since 3.2.3
*/
public static String numberToChinese(double number, boolean isUseTraditonal) {
return NumberChineseFormater.format(number, isUseTraditonal);
}
/**
* 金额转为中文形式
*
* @param n 数字
* @return 中文大写数字
* @since 3.2.3
*/
public static String digitToChinese(Number n) {
if (null == n) {
return "零";
}
return NumberChineseFormater.format(n.doubleValue(), true, true);
}
// -------------------------------------------------------------------------- 数字转换
/**
* int转byte
*
* @param intValue int值
* @return byte值
* @since 3.2.0
*/
public static byte intToByte(int intValue) {
return (byte) intValue;
}
/**
* byte转无符号int
*
* @param byteValue byte值
* @return 无符号int值
* @since 3.2.0
*/
public static int byteToUnsignedInt(byte byteValue) {
// Java 总是把 byte 当做有符处理；我们可以通过将其和 0xFF 进行二进制与得到它的无符值
return byteValue & 0xFF;
}
/**
* byte数组转short
*
* @param bytes byte数组
* @return short值
* @since 3.2.0
*/
public static short bytesToShort(byte[] bytes) {
return (short) (bytes[1] & 0xff | (bytes[0] & 0xff) << 8);
}
/**
* short转byte数组
*
* @param shortValue short值
* @return byte数组
* @since 3.2.0
*/
public static byte[] shortToBytes(short shortValue) {
byte[] b = new byte[2];
b[1] = (byte) (shortValue & 0xff);
b[0] = (byte) ((shortValue >> 8) & 0xff);
return b;
}
/**
* byte[]转int值
*
* @param bytes byte数组
* @return int值
* @since 3.2.0
*/
public static int bytesToInt(byte[] bytes) {
return bytes[3] & 0xFF
| //
(bytes[2] & 0xFF) << 8
| //
(bytes[1] & 0xFF) << 16
| //
(bytes[0] & 0xFF) << 24; //
}
/**
* int转byte数组
*
* @param intValue int值
* @return byte数组
* @since 3.2.0
*/
public static byte[] intToBytes(int intValue) {
return new byte[] { //
(byte) ((intValue >> 24) & 0xFF), //
(byte) ((intValue >> 16) & 0xFF), //
(byte) ((intValue >> 8) & 0xFF), //
(byte) (intValue & 0xFF) //
};
}
/**
* long转byte数组
* from:
* https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
*
* @param longValue long值
* @return byte数组
* @since 3.2.0
*/
public static byte[] longToBytes(long longValue) {
// Magic number 8 should be defined as Long.SIZE / Byte.SIZE
final byte[] result = new byte[8];
for (int i = 7; i >= 0; i--) {
result[i] = (byte) (longValue & 0xFF);
longValue >>= 8;
}
return result;
}
/**
* byte数组转long
* from:
* https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
*
* @param bytes byte数组
* @return long值
* @since 3.2.0
*/
public static long bytesToLong(byte[] bytes) {
// Magic number 8 should be defined as Long.SIZE / Byte.SIZE
long values = 0;
for (int i = 0; i < 8; i++) {
values <<= 8;
values |= (bytes[i] & 0xff);
}
return values;
}
}