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

组件列表

代码示例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<>() {               // 自定义缓存加载器，缓存未命中时，会调用该加载器获取数据
                    @Override
                    public String load(String key) throws Exception {
                        return "value-" + key;
                    }
                })
                .build();
                
// 4、缓存监听器设置
Cache<String, String> cache = CacheTool.<String,String>newLRUCache()
                .listener(new CacheListener<>() {             // 缓存监听器，缓存删除操作时，会调用该监听器
                    @Override
                    public 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() {                      // 添加拦截器
                    @Override
                    public void before(HttpRequest httpRequest) {
                        logger.info("before, url = " + httpRequest.getUrl());
                    }
                    @Override
                    public 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);   // 读取文件行数据，以迭代方式、流式读取，避免内存溢出
...