Class ConvertUtil

java.lang.Object
com.sure.tool.util.ConvertUtil

public class ConvertUtil extends Object
类型转换工具类,参考 Hutool 的 Convert 设计。

English: Best-effort type conversion between strings, numbers, booleans and enums.

Since:
0.1.0
Author:
suretool
  • Method Details

    • toInt

      public static int toInt(Object value)
      转 int。
      Parameters:
      value - 值
      Returns:
      int 值,失败返回 0
    • toInt

      public static int toInt(Object value, int defaultValue)
      转 int。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      int 值或默认值
    • toLong

      public static long toLong(Object value)
      转 long。
      Parameters:
      value - 值
      Returns:
      long 值,失败返回 0
    • toLong

      public static long toLong(Object value, long defaultValue)
      转 long。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      long 值或默认值
    • toDouble

      public static double toDouble(Object value)
      转 double。
      Parameters:
      value - 值
      Returns:
      double 值,失败返回 0
    • toDouble

      public static double toDouble(Object value, double defaultValue)
      转 double。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      double 值或默认值
    • toFloat

      public static float toFloat(Object value, float defaultValue)
      转 float。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      float 值或默认值
    • toBoolean

      public static boolean toBoolean(Object value)
      转 boolean。
      Parameters:
      value - 值
      Returns:
      boolean 值,失败返回 false
    • toBoolean

      public static boolean toBoolean(Object value, boolean defaultValue)
      转 boolean。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      boolean 值或默认值
    • toStr

      public static String toStr(Object value)
      转字符串。
      Parameters:
      value - 值
      Returns:
      字符串,null 返回 null
    • toStr

      public static String toStr(Object value, String defaultValue)
      转字符串。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      字符串或默认值
    • convert

      public static <T> T convert(Class<T> type, Object value)
      通用类型转换:支持基础类型、包装类型、String 及数组/集合转 List。
      Type Parameters:
      T - 目标类型
      Parameters:
      type - 目标类型
      value - 值
      Returns:
      转换后的值
    • toList

      public static List<Object> toList(Object value)
      数组或集合转 List。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      List,不支持的输入返回 null
    • toStrArray

      public static String[] toStrArray(Object value)
      数组或集合转 String 数组。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      String 数组
    • toByteArray

      public static byte[] toByteArray(Object value)
      数组或集合转 byte 数组。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      byte 数组
    • toSet

      public static Set<Object> toSet(Object value)
      数组或集合转 Set(去重,保序)。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      Set
    • toIntArray

      public static int[] toIntArray(Object value)
      数组或集合转 int 数组。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      int 数组
    • toLongArray

      public static long[] toLongArray(Object value)
      数组或集合转 long 数组。
      Parameters:
      value - 数组(含基本类型数组)或集合
      Returns:
      long 数组
    • wrap

      public static Object[] wrap(Object array)
      对象数组(含基本类型数组)装箱为包装类型数组。
      Parameters:
      array - 数组
      Returns:
      包装类型数组
    • toBigDecimal

      public static BigDecimal toBigDecimal(Object value)
      转 BigDecimal。
      Parameters:
      value - 值
      Returns:
      BigDecimal;null 或转换失败返回 null
    • toDate

      public static Date toDate(Object value)
      转 Date(支持 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、时间戳)。
      Parameters:
      value - 值
      Returns:
      Date;无法解析返回 null
    • toSqlDate

      public static Date toSqlDate(Object value)
      转 Date。
      Parameters:
      value - 值
      Returns:
      java.sql.Date;无法解析返回 null
      Since:
      1.0.1
    • toTimestamp

      public static Timestamp toTimestamp(Object value)
      转 Timestamp。
      Parameters:
      value - 值
      Returns:
      java.sql.Timestamp;无法解析返回 null
      Since:
      1.0.1
    • toShort

      public static short toShort(Object value)
      转 short。
      Parameters:
      value - 值
      Returns:
      short;转换失败返回 0
    • toShort

      public static short toShort(Object value, short defaultValue)
      转 short。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      short;转换失败返回默认值
    • toByte

      public static byte toByte(Object value)
      转 byte。
      Parameters:
      value - 值
      Returns:
      byte;转换失败返回 0
    • toByte

      public static byte toByte(Object value, byte defaultValue)
      转 byte。
      Parameters:
      value - 值
      defaultValue - 默认值
      Returns:
      byte;转换失败返回默认值
    • toFloat

      public static float toFloat(Object value)
      转 float。
      Parameters:
      value - 值
      Returns:
      float;转换失败返回 0
    • toCharArray

      public static char[] toCharArray(Object value)
      转字符数组。
      Parameters:
      value - 值
      Returns:
      字符数组
    • toEnum

      public static <E extends Enum<E>> E toEnum(String value, Class<E> enumClass)
      字符串转枚举。
      Type Parameters:
      E - 枚举类型
      Parameters:
      value - 枚举名
      enumClass - 枚举类
      Returns:
      枚举值;无效返回 null
    • toDoubleArray

      public static double[] toDoubleArray(Object value)
      转换为 double 数组(集合/数组/逗号分隔字符串)。
      Parameters:
      value - 值
      Returns:
      double 数组;null 返回空数组
    • toBooleanArray

      public static boolean[] toBooleanArray(Object value)
      转换为 boolean 数组(集合/数组/逗号分隔字符串)。
      Parameters:
      value - 值
      Returns:
      boolean 数组;null 返回空数组
    • toBigInteger

      public static BigInteger toBigInteger(Object value)
      转换为 BigInteger。
      Parameters:
      value - 值
      Returns:
      BigInteger 或 null
    • toLocalDate

      public static LocalDate toLocalDate(Object value)
      转换为 LocalDate(支持 yyyy-MM-dd / ISO_INSTANT 等标准格式)。
      Parameters:
      value - 值
      Returns:
      LocalDate 或 null
    • toLocalDateTime

      public static LocalDateTime toLocalDateTime(Object value)
      转换为 LocalDateTime(支持 yyyy-MM-dd HH:mm:ss 等标准格式)。
      Parameters:
      value - 值
      Returns:
      LocalDateTime 或 null
    • toMap

      public static Map<String,Object> toMap(Object... keysAndValues)
      键值数组转为 Map(偶数个元素两两成键值对)。
      Parameters:
      keysAndValues - 键值数组,如 toMap("a", 1, "b", 2)
      Returns:
      Map,null 键跳过;元素个数为奇数抛异常
    • toMap

      public static Map<String,Object> toMap(Collection<?> collection, String keyFieldName)
      按 Bean 属性字段将集合转为 Map。
      Parameters:
      collection - 对象集合
      keyFieldName - 作为 key 的字段名
      Returns:
      Map(字段值 → 元素);字段值取不到则抛异常