Hutool Java工具库技术文档

Hutool Java工具库技术文档

【免费下载链接】hutool 🍬小而全的Java工具类库，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。 项目地址: https://gitcode.com/chinabugotech/hutool

1. 安装指南

1.1 Maven安装

在项目的pom.xml文件中添加以下依赖：

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.40</version>
</dependency>

1.2 Gradle安装

在build.gradle文件中添加：

implementation 'cn.hutool:hutool-all:5.8.40'

1.3 手动下载安装

可以从Maven中央库直接下载jar包：

• 下载hutool-all-5.8.40.jar文件
• 将jar包添加到项目的classpath中

1.4 源码编译安装

1. 克隆项目源码：

   git clone https://gitee.com/chinabugotech/hutool.git
   

2. 进入项目目录执行：

   ./hutool.sh install
   

2. 项目使用说明

Hutool是一个功能丰富的Java工具库，主要包含以下核心模块：

• 核心工具：Bean操作、日期处理、各种Util等
• 加密解密：对称、非对称和摘要算法封装
• HTTP客户端：基于HttpUrlConnection的封装
• 数据库操作：JDBC封装后的ActiveRecord思想实现
• 缓存：简单缓存实现
• 定时任务：类Crontab表达式的定时任务
• JSON处理：轻量级JSON实现
• Excel/Word操作：针对POI的封装
• 验证码：图片验证码生成
• AI工具：大模型封装实现

3. 项目API使用文档

3.1 核心工具示例

// 字符串处理
String str = "Hello Hutool";
String reverseStr = StrUtil.reverse(str);

// 日期处理
Date date = DateUtil.parse("2023-01-01");
String formatDate = DateUtil.format(date, "yyyy/MM/dd");

// 集合工具
List<String> list = CollUtil.newArrayList("a", "b", "c");
String joinStr = CollUtil.join(list, ",");

3.2 HTTP客户端示例

// GET请求
String result = HttpUtil.get("https://www.example.com");

// POST请求
HashMap<String, Object> paramMap = new HashMap<>();
paramMap.put("key1", "value1");
paramMap.put("key2", "value2");
String result = HttpUtil.post("https://www.example.com", paramMap);

3.3 加密解密示例

// MD5加密
String md5 = SecureUtil.md5("123456");

// AES加密解密
String content = "Hello Hutool";
String password = "123456";
String encrypt = SecureUtil.aes(password.getBytes()).encryptHex(content);
String decrypt = SecureUtil.aes(password.getBytes()).decryptStr(encrypt);

3.4 数据库操作示例

// 配置数据源
DataSource ds = new SimpleDataSource("jdbc:mysql://localhost:3306/test", "user", "pass");

// 使用ActiveRecord
User user = new User().setId(1).setName("张三").setAge(22);
user.insert();
user.setName("李四").update();

4. 项目安装方式

Hutool提供多种安装方式以满足不同开发场景需求：

1. Maven中央库依赖（推荐）

   • 适合Maven/Gradle项目
   • 自动解决依赖关系
   • 版本更新方便

2. Gradle依赖

   • 适合Android或Gradle项目
   • 简单易用

3. 手动下载Jar包

   • 适合无构建工具的项目
   • 需要手动管理依赖

4. 源码编译安装

   • 适合需要定制修改的场景
   • 可以获取最新功能
   • 需要本地构建环境

注意：Hutool 5.x需要JDK8+环境，如果使用JDK7，请使用Hutool 4.x版本。

【免费下载链接】hutool 🍬小而全的Java工具类库，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。 项目地址: https://gitcode.com/chinabugotech/hutool