Hutool Hutool
(opens new window)
🏡首页
📖指南
🎢最佳实践
💖支持
💡javaDoc (opens new window)
⏳更新记录 (opens new window)
  • 🍎gitee (opens new window)
  • 🍏github (opens new window)
(opens new window)
🏡首页
📖指南
🎢最佳实践
💖支持
💡javaDoc (opens new window)
⏳更新记录 (opens new window)
  • 🍎gitee (opens new window)
  • 🍏github (opens new window)
  • 快速入门

  • 核心(hutool-core)

    • AI(Hutool-ai)

    • 注解(annotation)

    • 数组(array)

    • JavaBean(bean)

    • 缓存(cache)

    • 类加载器(classloader)

    • 编码解码(codec)

    • 集合(collection)

    • 比较器(comparator)

    • 压缩(compress)

    • 类型转换(convert)

      • 简介
        • 📚简介
          • JDK类型转换的问题
          • Hutool类型转换的优势
          • 核心功能
          • 主要类结构
      • 类型转换工具-ConvertUtil
    • 数据(data)

    • 日期时间(date)

    • 异常(exception)

    • 函数(func)

    • IO流(io)

    • 语言特性(lang)

    • Map(map)

    • 数字数学(math)

    • 网络(net)

    • 对象池(pool)

    • 反射(reflect)

    • 正则(regex)

    • 服务提供(spi)

    • 聚合操作(stream)

    • 字符串文本(text)

    • 并发和线程(thread)

    • 树结构(tree)

    • 工具集合(util)

    • XML操作(xml)

  • 定时任务(hutool-cron)

  • 加密(hutool-crypto)

  • 数据库(hutool-db)

  • 扩展(hutool-extra)

  • HTTP(hutool-http)

  • 日志(hutool-log)

  • 配置文件(hutool-setting)

  • JSON(hutool-json)

  • Office办公(hutool-poi)

  • 套接字(hutool-socket)

  • GUI(hutool-swing)

  • 指南
  • 核心(hutool-core)
  • 类型转换(convert)
Hutool
2026-01-03
目录

简介

# 📚简介

类型转换模块是Hutool核心功能之一,提供了强大的类型转换能力,简化了Java中各种类型之间的转换操作。

# JDK类型转换的问题

在Java中,类型转换是日常开发中频繁遇到的操作,但JDK原生的类型转换存在以下问题:

  1. 转换代码冗长:需要编写大量的类型检查、异常处理和转换逻辑
  2. 转换规则不统一:不同类型之间的转换方式各异,缺乏统一的API
  3. 异常处理复杂:原生转换可能抛出各种异常,需要手动处理
  4. 支持类型有限:对集合、Map、枚举等复杂类型的转换支持不足
  5. 转换结果不可靠:需要额外的空值检查和默认值处理

# Hutool类型转换的优势

Hutool的类型转换模块(cn.hutool.v7.core.convert)通过统一的API和丰富的转换规则,解决了JDK原生转换的痛点:

  1. 统一API:所有转换操作都通过ConvertUtil类提供,调用简单直观
  2. 丰富的转换类型:支持基本类型、包装类型、字符串、日期、集合、Map、枚举等几乎所有Java类型
  3. 智能转换:自动识别源类型和目标类型,选择最佳转换策略
  4. 静默转换:提供静默转换方法,转换失败时返回默认值,无需处理异常
  5. 自定义转换:支持扩展自定义转换器,满足特殊转换需求
  6. 支持泛型:支持通过TypeReference进行泛型类型转换

# 核心功能

  • 基本类型与包装类型之间的转换
  • 字符串与各种类型之间的转换
  • 集合、数组之间的转换
  • 日期时间类型之间的转换
  • 枚举类型转换
  • 数字格式转换(中文数字、英文数字等)
  • 编码转换
  • 全角半角转换

# 主要类结构

  • ConvertUtil:核心转换工具类,提供所有转换方法
  • Converter:转换器接口,定义转换行为
  • CompositeConverter:复合转换器,管理所有转换器实例
  • BasicType:基本类型工具类,处理原始类型与包装类型的转换
  • 各种具体转换器实现类,如EnumConverter、MapConverter、CollectionConverter等

通过Hutool的类型转换模块,可以大幅简化开发中的类型转换代码,提高代码的可读性和可维护性。

ZIP64支持-Zip64
类型转换工具-ConvertUtil

← ZIP64支持-Zip64 类型转换工具-ConvertUtil→

Theme by Vdoing | Copyright © 2025-2026 Hutool | Apache-2.0
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式