Release Notes
- 1、【强化】缓存工具（CacheTool）重构升级，支持多种缓存策略及特性：
- 多种缓存类型实现：FIFO、LFU、LRU、Unlimited...等多种实现；
- 锁分桶设计：在保障缓存读写线程安全基础上，降低锁冲突几率，从而提升缓存性能；
- 缓存过期策略：支持多种缓存过期策略，如 “写入后过期、访问后过期” 等；
- 缓存定时清理：支持 定时清理 过期缓存数据，主动降低缓存占用空间；
- 缓存加载器：支持自定义缓存加载器，更灵活进行数据预热、数据初始化等操作；
- 缓存监听器：支持自定义缓存监听器，监听缓存数据变化，如缓存清理；
- 缓存统计信息：支持统计缓存命中数、未命中数、缓存大小等信息；
- 2、【强化】Http工具（HttpTool）重构升级，支持多种请求策略及特性：
- 规范Http请求参数：支持自定义 Url、Method、ContentType、Header、Cookie、ConnectTimeout、ReadTimeout、UseCaches 等；
- 请求拦截器：支持自定义请求拦截器，对请求进行预处理、后处理操作；
- 请求安全校验：支持自定义Http Authorization信息；
- 请求数据传递：支持多种请求数据传递方式，包括Body、Form等；
- 基于Java对象Http交互：Http请求提交入参、以及响应结果均支持Java对象，工具底层屏蔽json序列化/反序列化工作，提升开发效率与工具易用性；
- 提供链式调用API，提升开发效率及体验；
- 3、【强化】Http工具（HttpTool）强化：支持接口代理模式方式的HTTP客户端配置及使用；
- 4、【强化】FileTool 工具能力升级，支持文件“创建、删除、移动、复制、读写”等丰富API；
- 5、【性能】FileTool 性能升级，针对大文件读写设计分批数据操作、流式导入导出能力，降低内容占用，提升操作性能；
- 6、【优化】IOTool 代码结构优化，提升 性能、易用性和维护性；
简介
XXL-TOOL 是一个Java工具类库，致力于让Java开发更高效。包含 “日期、集合、字符串、IO、缓存、并发、Excel、Emoji、Response、Pipeline、Http、Json、JsonRpc、Encrypt、Auth、ID、Serializer、验证码、限流器...” 等数十个模块。
文档地址
- 中文文档：https://www.xuxueli.com/xxl-tool/
- Github：https://github.com/xuxueli/xxl-tool
组件列表
| 模块 | 说明 |
|---|---|
| Core模块 | 包含 集合、缓存、日期、反射、断言、……等基础工具。 |
| Cache模块 | 一个高性能的 Java 缓存工具，支持多种缓存类型（FIFO、LFU、LRU等）、锁分桶优化、缓存过期策略（写后过期、访问后过期...）、缓存定时清理、缓存加载器、缓存监听器、缓存信息统计...等功能。 |
| IO模块 | 一系列处理IO（输入/输出）操作的工具，包括 FileTool、CsvTool、IOTool...等。 |
| Concurrent模块 | 一系列并发编程工具，具备良好的线程安全、高并发及高性能优势，包括MessageQueue（高性能内存队列，30W+ TPS）、CyclicThread（后台循环线程）、TimeWheel（时间轮组件）、TokenBucket（令牌桶/限流器）等。 |
| Http模块 | 一系列处理Http通讯、IP、Cookie等相关工具。 |
| Json模块 | json序列化、反序列化工具封装，基于Gson。 |
| JsonRpc模块 | 一个轻量级、跨语言远程过程调用实现，基于json、http实现（对比传统RPC框架：XXL-RPC）。 |
| Excel模块 | 一个灵活的Java对象和Excel文档相互转换的工具。一行代码完成Java对象和Excel之间的转换。 |
| Emoji模块 | 一个灵活可扩展的Emoji表情编解码库，可快速实现Emoji表情的编解码。 |
| Response模块 | 统一响应数据结构体，标准化数据结构、状态码等，降低协作成本。 |
| Pipeline模块 | 高扩展性流程编排引擎。 |
| Exception模块 | 异常处理相关工具。 |
| Freemarker模块 | 模板引擎工具，支持根据模板文件实现 动态文本生成、静态文件生成 等，支持邮件发送、网页静态化场景。 |
| Encrypt模块 | 一系列处理编解码、加解密的工具，包括 Md5Tool、SHA256Tool、HexTool、Base64Tool...等。 |
| Auth模块 | 一系列权限认证相关工具，包括JwtTool...等。 |
| ID模块 | 一系列ID生成工具，支持多种ID生成策略，包括 UUID、Snowflake、Date、Random 等。 |
| Serializer模块 | 一系列序列化、反序列化工具，支持扩展多种序列化格式，包括 jdk、protobuf、hessian 等。 |
| Captcha模块 | 一个验证码工具，支持随机字符验证码、数字验证码、中文验证码等多形式。支持自定义验证码生成算法、宽高、颜色、文字字体/大小/间距、背景颜色、边框宽度/边框、干扰策略…等。 |
| ... | ... |
代码示例01：CacheTool 高性能本地缓存
一个高性能的 Java 缓存工具，支持多种缓存类型（FIFO、LFU、LRU等）、锁分桶优化、缓存过期策略（写后过期、访问后过期...）、缓存定时清理、缓存加载器、缓存监听器、缓存信息统计...等功能。
// 1、快速创建缓存
Cache<String, String> cache = CacheTool.newFIFOCache(1000).build(); // 默认FIFO缓存
Cache<String, String> cache = CacheTool.newLFUCache(1000).build(); // LFU缓存
Cache<String, String> cache = CacheTool.newLRUCache(1000).build(); // LRU缓存
Cache<String, String> cache = CacheTool.newUnlimitedCache().build(); // 无限制缓存// 2、缓存详细配置
Cache<String, String> cache2 = CacheTool.newLRUCache().capacity(1000) // 缓存容量.expireAfterAccess(30 * 1000) // 缓存过期时间 30s，过期策略为：访问后过期.expireAfterWrite(30 * 1000) // 缓存过期时间 30s，过期策略为：写后过期 （expireAfterAccess 与 expireAfterWrite，选择其一设置即可）.pruneInterval(5000) // 定期清理缓存，清理间隔为5s.build();// 3、缓存加载器设置
Cache<String, String> cache = CacheTool.<String,String>newLRUCache().loader(new CacheLoader<>() { // 自定义缓存加载器，缓存未命中时，会调用该加载器获取数据@Overridepublic String load(String key) throws Exception {return "value-" + key;}}).build();// 4、缓存监听器设置
Cache<String, String> cache = CacheTool.<String,String>newLRUCache().listener(new CacheListener<>() { // 缓存监听器，缓存删除操作时，会调用该监听器@Overridepublic void onRemove(String key, String value) throws Exception {logger.info("onRemove, key = " + key + ", value = " + value);}}).build();// 5、缓存常规操作；
cache.put(key, "value01"); // 写入缓存
cache.get(key); // 获取缓存，缓存未命中时，尝试从缓存加载器加载数据（若已设置缓存加载器）
cache.getIfPresent(key); // 获取缓存，缓存未命中时返回null
cache.remove(key); // 删除缓存// 6、缓存其他操作
cache.prune() // 清理已过期缓存
cache.clear(); // 清空缓存
cache.asMap() // 获取全部缓存数据（过滤已过期数据）
cache.size() // 缓存对象数量（包含过期数据）
cache.hitCount() // 缓存命中次数
cache.missCount() // 缓存未命中次数
cache.isEmpty() // 缓存是否为空
cache.isFull() // 缓存是否已满
...
代码示例02：HttpTool 高性能HTTP请求库
一个高性能 HTTP 请求库，API简洁易用、使用高效方便且性能优越；支持 “常规Http请求、Java对象方式请求、接口&注解代理方式请求” 三种使用方式。
- a、常规使用方式：
// 1、发送 Get 请求，获取响应内容
String response = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad").execute().response();// 2、发送 Post 请求，获取 Http状态码 以及 响应内容
HttpResponse httpResponse = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad").execute();
int statusCode = httpResponse.statusCode(); // 获取Http状态码
String response = httpResponse.response(); // 获取响应内容// 3、自定义请求参数
HttpResponse httpResponse = HttpTool.createRequest().url("https://news.baidu.com/widget?ajax=json&id=ad") // 设置请求地址.method(Method.GET) // 设置请求方式.contentType(ContentType.JSON) // 设置请求内容类型.header("header", "value") // 设置请求头/header.cookie("cookie", "value") // 设置Cookie.connectTimeout(10000) // 设置连接超时时间.readTimeout(10000) // 读取超时.useCaches(false) // 设置是否使用缓存.body("body") // 设置请求体， 仅针对 非Get 请求生效.form("form", "value") // 设置表单参数，仅针对 GET 请求生效，参数将会添加到 url 中；.auth("auth999") // 设置认证信息，本质为设置 header（Authorization） 信息； .interceptor(new HttpInterceptor() { // 添加拦截器@Overridepublic void before(HttpRequest httpRequest) {logger.info("before, url = " + httpRequest.getUrl());}@Overridepublic void after(HttpRequest httpRequest, HttpResponse httpResponse) {logger.info("after, response = " + httpResponse.response());}});
- b、Java对象方式Http请求：
RespDTO result = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad").request(new RespDTO("jack", 18)) // 设置请求java对象数据，将会自动序列化为json，以 requestBody 形式发送；.execute().response(RespDTO.class); // 设置响应java对象类型，将会自动将响应内容 反序列化 为java对象；
- c、接口代理方式Http请求：
// 接口代理，发送请求
DemoService demoService = HttpTool.createClient().url("https://news.baidu.com/widget?ajax=json&id=ad").timeout(10000).proxy(DemoService.class);
RespDTO result = demoService.widget();// 接口定义
public static interface DemoService2{RespDTO widget();
}
代码示例03：FileTool 高性能文件操作工具
一个高性能 File/文件 操作工具，支持丰富文件操作API；针对大文件读写设计分批操作、流式读写能力，降低内存占用、提升文件操作性能。
FileTool.createFile(testFile); // 创建文件
FileTool.createDirectories(testFilePath); // 创建目录
FileTool.createParentDirectories(testFile); // 创建文件父目录FileTool.isFile(testFile); // 判断文件
FileTool.isDirectory(testFilePath); // 判断目录
FileTool.isSameFile(file1, file2); // 判断文件是否相同
FileTool.exists(testFile); // 判断文件是否存在FileTool.size(testFile); // 获取文件 或 目录大小
FileTool.totalLines(testFile); // 获取文件行数FileTool.delete(testFile); // 删除文件或目录
FileTool.clean(testFilePath); // 清空目录FileTool.copy(src, dest); // 复制文件
FileTool.move(src, dest); // 移动文件或目录FileTool.writeString(testFilePath, content); // 写入文件数据
FileTool.writeLines(testFilePath, Iterable<?> lines); // 写入文件行数据
FileTool.writeLines(testFilePath, Supplier<?> lineSupplier); // 写入文件数据，以迭代方式、流式写入，避免内存溢出FileTool.readString(testFilePath); // 读取文件数据
FileTool.readLines(testFilePath); // 读取文件行数据
FileTool.readLines(testFilePath, Consumer<String> lineConsumer); // 读取文件行数据，以迭代方式、流式读取，避免内存溢出
...