UrlEncode 使用教程

UrlEncode 是一个 URL 编码和解码的工具类，提供了对 URL 进行编码和解码的方法，处理 URL 中的中文字符，并能将查询字符串解析为 Map。

主要功能特性

1. URL 编码和解码：支持不同编码策略和字符集规范
2. 中文字符处理：专门处理 URL 中的中文乱码问题
3. 查询字符串解析：将格式为 xxx=xxx&xxx=xxx 的字符串转换为 Map
4. 多种编码模式：支持普通编码、GET 请求优化编码和安全编码

基本使用方法

1. 创建实例

// 使用默认 UTF-8 字符集创建实例
UrlEncode encoder = new UrlEncode("Hello World");

// 使用指定字符集创建实例
UrlEncode encoder = new UrlEncode("Hello World", StandardCharsets.UTF_8);

2. URL 编码

// 基本 URL 编码
String encoded = new UrlEncode("Hello World").encode();
// 输出: Hello+World

// GET 请求优化编码（将 + 替换为 %20）
String queryEncoded = new UrlEncode("Hello World").encodeQuery();
// 输出: Hello%20World

// 安全编码（处理特殊字符）
String safeEncoded = new UrlEncode("Hello*World~Test").encodeSafe();
// 输出: Hello%2AWorld%7ETest

3. URL 解码

// URL 解码
String decoded = new UrlEncode("Hello%20World").decode();
// 输出: Hello World

4. 链式调用

由于使用了 @Accessors(chain = true) 注解，可以进行链式调用：

String result = new UrlEncode("Hello World")
    .setCharset(StandardCharsets.UTF_8)
    .encodeQuery();

静态工具方法

1. 中文字符处理

// 处理 URL 中的中文乱码
String chineseStr = "你好世界";
String processed = UrlEncode.urlChinese(chineseStr);

2. 查询字符串转 Map

// 将查询字符串转换为 Map
String queryString = "name=张三&age=25&city=北京";
Map<String, String> paramMap = UrlEncode.parseStringToMap(queryString);

// 结果:
// name -> 张三
// age -> 25
// city -> 北京

注意事项

1. encodeSafe 方法在单元测试中有问题，需要修复
2. 如果 Tomcat 过滤器已设置 UTF-8，则 urlChinese 方法可能不需要重复转码
3. 所有编码和解码操作都支持自定义字符集