任何包含特殊字符的URL地址或Body中的表单信息要发送请求，都要进过一定程度的UREncode以符合HTTP相关标准，才能正常发出请求

而HTTP请求中的不同部分对URLEncode强度要求是不同的，比如Body表单格式字符串的要求相对宽松，可以包含{,},空格等字符串，而Query参数值部分则必须将其转义才能正常发送

所以Forest在默认情况下为HTTP请求已经URL中的不同部分提供了各自合适的编码强度（最大限度宽松）的 URLEncode

但有些情况默认的URLEncode也无法满足要求：

1. 不同服务端接口对编码的强度要求可能是不同的，比如要求Query参数必须是最严格的编码
2. 已经如果在URL中大范围使用 ${变量名} 这样变量引用的时候，Forest也无法准备判断您引入的变量是URL中具体那个部分，从而也无法给出准确的编码强度
3. 输入一个有歧义的字符串到字符串模板中

所以此时需要进行手动URLEncode，为此提供了在字符串模板中可供调用的内置函数:

• encode(str): 严格编码，最大的编码强度
• encodeQuery(str): Query参数编码，对URL中的参数值部分字符串进行编码，强度适中以最大限度适应HTTP规范
• encodePath(str): Path路径编码，对URL中域名+后端+/ 后的路径部分字符串进行编码
• encodeForm(str): Form表单编码，对Body中x-www-form-urlencoded格式的请求体字符串进行编码，强度最宽松
• encodeUserInfo(str): UserInfo编码，对URL中用户名密码验证信息部分字符串进行编码

例子:

// 在{}中调用encode函数对userInfo变量进行严格URLEncode编码
@Get("http://{encode(userInfo)}@localhost:8080/hello/user")
ForestResponse<String> doGet(@Var("userInfo") String userInfo);

若调用该接口参数如下:

client.doGet("xxx/yyy/foo");

则产生的请求为:

GET http://xxx%2Fyyy%2Ffoo@localhost:8080/hello/user HTTP

如若不用 encode 函数的话，则请求会变成

GET http://xxx/yyy/foo@localhost:8080/hello/user HTTP

此时xxx/yyy/xxx中的/会使地址产生歧义，将xxx错误地解析为域名，显然这样的地址是无法正常发送出去的