ValUtil - 类型转换
ValUtil 提供"有界宽容"的类型转换：输入为 null → 返回 null（或默认值），类型不同但能转换 → 自动转换，内容无法转换 → 抛异常。
基本类型转换
// 转 Integer
Integer val = ValUtil.toInt(obj); // null → null, "25" → 25
Integer val = ValUtil.toInt(obj, 0); // 带默认值
Integer val = ValUtil.toIntZero(obj); // null → 0
// 转 Long
Long val = ValUtil.toLong(obj);
Long val = ValUtil.toLongZero(obj); // null → 0
// 转 Double
Double val = ValUtil.toDouble(obj);
Double val = ValUtil.toDoubleZero(obj); // null → 0.0
// 转 Float
Float val = ValUtil.toFloat(obj);
Float val = ValUtil.toFloatZero(obj); // null → 0.0f
// 转 BigDecimal（金额计算用）
BigDecimal val = ValUtil.toBigDecimal(obj);
BigDecimal val = ValUtil.toBigDecimalZero(obj); // null → 0
// 转 Boolean
Boolean val = ValUtil.toBoolean(obj); // "true"/"1" → true, else false
// 转 String
String val = ValUtil.toStr(obj); // null → null, 其他 → toString()
String val = ValUtil.toStr(obj, "默认值");
String val = ValUtil.toStrBlank(obj); // null → ""
String val = ValUtil.toStrWithEmpty(obj, "默认值"); // null/空字符串 → 默认值
// 字节数组转字符串
String val = ValUtil.toStr(bytes, Charset.forName("UTF-8"));
String val = ValUtil.toStr(bytes); // 默认 UTF-8
集合/数组转换
// 转 JSONList
JSONList list = ValUtil.toList(obj);
JSONList list = ValUtil.toListEmputy(obj); // null → 空列表
// 转 List<T>
List<Integer> ids = ValUtil.toList("1,2,3", Integer.class); // → [1,2,3]
// 转 T[]
Integer[] arr = ValUtil.toArray("1,2,3", Integer.class);
日期转换
// String → Date
Date date = ValUtil.toDate("2024-01-01 12:00:00");
Date date = ValUtil.toDate("2024/01/01", "yyyy/MM/dd");
Date date = ValUtil.toDateNow(obj); // null → 当前时间
// String → LocalDateTime
LocalDateTime ldt = ValUtil.toLocalDateTime("2024-01-01 12:00:00");
LocalDateTime ldt = ValUtil.toLocalDateTime(obj, "yyyy-MM-dd HH:mm:ss");
// 日期格式化输出
String str = ValUtil.toDateStr(obj);
String str = ValUtil.toDateStr(obj, "yyyy-MM-dd");
String str = ValUtil.toDateStrNow(obj); // null → 当前时间字符串
对象转换
// 跨类型转换（通过 Jackson）
User user = ValUtil.toObj(jsonMap, User.class);
User user = ValUtil.toObj(sourceObj, JavaType);
// 原生类型转换（不通过 Jackson）
User user = ValUtil.toNativeObj(sourceObj, User.class);
空值判断
// 判断对象是否为空（支持 CharSequence, Collection, Map, Array 等）
boolean empty = ValUtil.isEmpty(obj);
转换规则
| 输入 | 目标 | 结果 |
|---|---|---|
null | 任意 | null 或默认值 |
"25" | Integer | 25 |
"99.9" | BigDecimal | 99.9 |
"true" | Boolean | true |
"abc" | Integer | 抛异常（内容不可转换） |
"1,2,3" | List<Integer> | [1,2,3]（逗号分隔自动拆分） |