一、简介
Hutool - Extra 作为 Hutool 工具包的扩展模块,对众多第三方库和功能进行了封装,极大地丰富了 Hutool 的功能体系。它涵盖了模板引擎、邮件发送、Servlet 处理、二维码生成、Emoji 处理、FTP 操作以及分词等多个方面,为开发者在不同场景下提供了便捷的解决方案,让开发者无需深入了解各个第三方库的复杂细节,只需调用简单的 API 即可实现相应功能。
二、具体功能及使用示例
1. 模板引擎封装
模板引擎常用于生成动态内容,如 HTML 页面、邮件模板等。Hutool - Extra 对常见的模板引擎进行了封装,以 Freemarker 为例:
引入依赖
如果使用 Maven 项目,在 pom.xml
中添加 Freemarker 和 Hutool 的依赖:
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.8.16</version>
</dependency>
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.31</version>
</dependency>
代码示例
import cn.hutool.extra.template.Engine;
import cn.hutool.extra.template.Template;
import cn.hutool.extra.template.TemplateConfig;
import cn.hutool.extra.template.TemplateUtil;
import java.util.HashMap;
import java.util.Map;
public class FreemarkerExample {
public static void main(String[] args) {
// 创建模板配置
TemplateConfig config = new TemplateConfig();
config.setResourceMode(TemplateConfig.ResourceMode.CLASSPATH);
// 获取模板引擎
Engine engine = TemplateUtil.createEngine(config);
// 获取模板
Template template = engine.getTemplate("test.ftl");
// 准备数据
Map<String, Object> data = new HashMap<>();
data.put("name", "John");
// 渲染模板
String result = template.render(data);
System.out.println(result);
}
}
在上述代码中,首先创建了模板配置对象,指定资源模式为从类路径加载模板。然后使用 TemplateUtil.createEngine
方法获取模板引擎,通过引擎获取指定名称的模板。准备好数据后,调用 render
方法将数据填充到模板中,得到最终的渲染结果。
2. 邮件发送
Hutool - Extra 封装了 JavaMail 实现邮件发送功能,简化了邮件发送的流程。
引入依赖
如果使用 Maven 项目&