XXL-TOOL v2.3.0 发布 | Java工具类库

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. // 1、快速创建缓存
2. Cache<String, String> cache = CacheTool.newFIFOCache(1000).build();   // 默认FIFO缓存
3. Cache<String, String> cache = CacheTool.newLFUCache(1000).build();    // LFU缓存
4. Cache<String, String> cache = CacheTool.newLRUCache(1000).build();    // LRU缓存
5. Cache<String, String> cache = CacheTool.newUnlimitedCache().build();  // 无限制缓存
7. // 2、缓存详细配置
8. Cache<String, String> cache2 = CacheTool.newLRUCache()
9.                 .capacity(1000)                 // 缓存容量
10.                 .expireAfterAccess(30 * 1000)   // 缓存过期时间 30s，过期策略为：访问后过期
11.                 .expireAfterWrite(30 * 1000)    // 缓存过期时间 30s，过期策略为：写后过期  （expireAfterAccess 与 expireAfterWrite，选择其一设置即可）
12.                 .pruneInterval(5000)            // 定期清理缓存，清理间隔为5s
13.                 .build();
14.                
15. // 3、缓存加载器设置
16. Cache<String, String> cache = CacheTool.<String,String>newLRUCache()
17.                 .loader(new CacheLoader<>() {               // 自定义缓存加载器，缓存未命中时，会调用该加载器获取数据
18.                     @Override
19.                     public String load(String key) throws Exception {
20.                         return "value-" + key;
21.                     }
22.                 })
23.                 .build();
24.                
25. // 4、缓存监听器设置
26. Cache<String, String> cache = CacheTool.<String,String>newLRUCache()
27.                 .listener(new CacheListener<>() {             // 缓存监听器，缓存删除操作时，会调用该监听器
28.                     @Override
29.                     public void onRemove(String key, String value) throws Exception {
30.                         logger.info("onRemove, key = " + key + ", value = " + value);
31.                     }
32.                 })
33.                 .build();
35. // 5、缓存常规操作；
36. cache.put(key, "value01");    // 写入缓存
37. cache.get(key);               // 获取缓存，缓存未命中时，尝试从缓存加载器加载数据（若已设置缓存加载器）
38. cache.getIfPresent(key);      // 获取缓存，缓存未命中时返回null
39. cache.remove(key);            // 删除缓存
41. // 6、缓存其他操作
42. cache.prune()                 // 清理已过期缓存
43. cache.clear();                // 清空缓存
44. cache.asMap()                 // 获取全部缓存数据（过滤已过期数据）
45. cache.size()                  // 缓存对象数量（包含过期数据）
46. cache.hitCount()              // 缓存命中次数
47. cache.missCount()             // 缓存未命中次数
48. cache.isEmpty()               // 缓存是否为空
49. cache.isFull()                // 缓存是否已满
50. ...

复制代码

代码示例02：HttpTool 高性能HTTP请求库

一个高性能 HTTP 请求库，API简洁易用、使用高效方便且性能优越；支持 “常规Http请求、Java对象方式请求、接口&注解代理方式请求” 三种使用方式。

• a、常规使用方式：
  

1. // 1、发送 Get 请求，获取响应内容
2. String response = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad").execute().response();
4. // 2、发送 Post 请求，获取 Http状态码 以及 响应内容
5. HttpResponse httpResponse = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad").execute();
6. int statusCode = httpResponse.statusCode();   // 获取Http状态码
7. String response = httpResponse.response();    // 获取响应内容
9. // 3、自定义请求参数
10. HttpResponse httpResponse = HttpTool.createRequest()
11.                 .url("https://news.baidu.com/widget?ajax=json&id=ad")     // 设置请求地址
12.                 .method(Method.GET)                                       // 设置请求方式
13.                 .contentType(ContentType.JSON)                            // 设置请求内容类型
14.                 .header("header", "value")                                // 设置请求头/header
15.                 .cookie("cookie", "value")                                // 设置Cookie
16.                 .connectTimeout(10000)                                    // 设置连接超时时间
17.                 .readTimeout(10000)                                       // 读取超时
18.                 .useCaches(false)                                         // 设置是否使用缓存
19.                 .body("body")                                             // 设置请求体， 仅针对 非Get 请求生效
20.                 .form("form", "value")                                    // 设置表单参数，仅针对 GET 请求生效，参数将会添加到 url 中；
21.                 .auth("auth999")                                          // 设置认证信息，本质为设置 header（Authorization） 信息；
22.                 .interceptor(new HttpInterceptor() {                      // 添加拦截器
23.                     @Override
24.                     public void before(HttpRequest httpRequest) {
25.                         logger.info("before, url = " + httpRequest.getUrl());
26.                     }
27.                     @Override
28.                     public void after(HttpRequest httpRequest, HttpResponse httpResponse) {
29.                         logger.info("after, response = " + httpResponse.response());
30.                     }
31.                 });

复制代码

• b、Java对象方式Http请求：
  

1. RespDTO result = HttpTool.createPost("https://news.baidu.com/widget?ajax=json&id=ad")
2.                 .request(new RespDTO("jack", 18))   // 设置请求java对象数据，将会自动序列化为json，以 requestBody 形式发送；
3.                 .execute()
4.                 .response(RespDTO.class);           // 设置响应java对象类型，将会自动将响应内容 反序列化 为java对象；

复制代码

• c、接口代理方式Http请求：
  

1. // 接口代理，发送请求
2. DemoService demoService = HttpTool.createClient()
3.                 .url("https://news.baidu.com/widget?ajax=json&id=ad")
4.                 .timeout(10000)
5.                 .proxy(DemoService.class);
6. RespDTO result = demoService.widget();
8. // 接口定义
9. public static interface DemoService2{
10.     RespDTO widget();
11. }

复制代码

代码示例03：FileTool 高性能文件操作工具

一个高性能 File/文件 操作工具，支持丰富文件操作API；针对大文件读写设计分批操作、流式读写能力，降低内存占用、提升文件操作性能。

1. FileTool.createFile(testFile);                            // 创建文件
2. FileTool.createDirectories(testFilePath);                 // 创建目录
3. FileTool.createParentDirectories(testFile);               // 创建文件父目录
4.       
5. FileTool.isFile(testFile);                                // 判断文件
6. FileTool.isDirectory(testFilePath);                       // 判断目录     
7. FileTool.isSameFile(file1, file2);                        // 判断文件是否相同                     
8. FileTool.exists(testFile);                                // 判断文件是否存在
9.       
10. FileTool.size(testFile);                                  // 获取文件 或 目录大小
11. FileTool.totalLines(testFile);                            // 获取文件行数
12.       
13. FileTool.delete(testFile);                                // 删除文件或目录
14. FileTool.clean(testFilePath);                             // 清空目录
15.       
16. FileTool.copy(src, dest);                                 // 复制文件
17. FileTool.move(src, dest);                                 // 移动文件或目录
19. FileTool.writeString(testFilePath, content);                       // 写入文件数据
20. FileTool.writeLines(testFilePath, Iterable<?> lines);              // 写入文件行数据
21. FileTool.writeLines(testFilePath, Supplier<?> lineSupplier);       // 写入文件数据，以迭代方式、流式写入，避免内存溢出
23. FileTool.readString(testFilePath);                                 // 读取文件数据
24. FileTool.readLines(testFilePath);                                  // 读取文件行数据
25. FileTool.readLines(testFilePath, Consumer<String> lineConsumer);   // 读取文件行数据，以迭代方式、流式读取，避免内存溢出
26. ...

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！