Forest v1.5.9 版本发布，轻量级 HTTP 客户端框架

v1.5.9 版本发布了，此次更新主要解决了URL Encoder在某些情况下不正确的问题

为此自己重新实现了URL解析和URL编码，抛弃了原有的 Java 自带的URI对象解析和URLEncoder类

实现了URL语义化的字符串模板

自动区分模板参数属于URL的哪个部分

/**
 * 新版本能够识别 {a} 和 {b} 是一个URL的Query参数
 * 会按照查询参数的要求进行URL编码：会将'&'符号转义 
 * 而 {path} 会被识别URL路径的一部分
 * 会按照URL路径的要求来进行URL编码：会保留'&'符号，不做转义
 */
@Get("/data/{path}?a={a}&b={b}")
String getData(@Var("path") String path, @Var("a") String a, @Var("b") String b);

{}与${}的区别

{}代表一个Query参数

{}模板参数，在?a={a}的情况下，会被认为是一个Query参数，即便变量可能包含"1&x=10&y=20"这样多个参数的字符串，也会被转义成一个Query参数

@Get("http://localhost/data?a={a}&b={b}")
String getData(@Var("a") String a, @Var("b") String b)

// 最终产生的URL是
// http://localhost/data?a=1%26x%3D10%26y%3D20&b=hello
// 也就是只会有 a 和 b 两个Query参数
myClient.getData("1&x=10&y=20", "hello");

${}可以包含多个Query参数

而 ${}模板参数，可以认为是一种字符串替换，替换完再对URL参数进行解析，所以一个模板参数引用的变量中可能包含多个参数，也会被解析成多个参数

@Get("http://localhost/data?a=${a}&b=${b}")
String getData(@Var("a") String a, @Var("b") String b)

// 最终产生的URL是
// http://localhost/data?a=1&x=10&y=20&b=hello
// 也就是只会有 a、x、y、b 四个Query参数
myClient.getData("1&x=10&y=20", "hello");

推荐使用{}作为模板参数

基于这两种模板参数各自的特性，都各有各的用处，但一般情况下，推荐使用{}

因为它更结构化、更语义化，也更容易让人理解，不容易出错，尤其是在URL参数中传递另一个URL地址时的作用更为突出

比如，要传一个带参数的子URL：https://search.gitee.com/?type=repository&q=forest

接到父URL后为 http://localhost/data?call={url}

如果是用${url}就会出问题

@Get("/data?call=${url}")
String getData(@Var("url") String url);

// 最后产生的URL是
// http://localhost/data?call=https://search.gitee.com/?type=repository&q=forest

咋看起来没错，但最后那部分&q=forest会被认为是父URL的Query参数，但其实应该是子URL的

如果用 {url} 就没关系，即使后来再有其它参数也毫无问题

@Get("/data?call={url}&x={x}")
String getData(@Var("url") String url, @Var("x") String x);

// 最后产生的URL是
// http://localhost/data?call=https://search.gitee.com/?type=repository%26q=forest&x=xxx

可以看到，子URL中Query参数的连接符&被转义了，这样就解决了子URL参数和父URL参数(如后面的x)之间产生的歧义

FIX的BUG

• fix: URI路径的URLEncoder编码结果不正确 (#I4DUFG:URI路径的URLEncoder编码结果不正确)