comment: 一些javadoc注释

Author: mySingleLive

forest-core/src/main/java/com/dtflys/forest/backend/BodyBuilder.java

@@ -9,5 +9,11 @@
  */
 public interface BodyBuilder<R> {
 
+    /**
+     * 构建请求体
+     * @param req 后端http请求对象
+     * @param request Forest请Cont求对象
+     * @param lifeCycleHandler 生命周期处理器
+     */
     void buildBody(R req, ForestRequest request, LifeCycleHandler lifeCycleHandler);
 }

forest-core/src/main/java/com/dtflys/forest/backend/body/AbstractBodyBuilder.java

@@ -78,6 +78,15 @@ public void buildBody(T httpRequest, ForestRequest request, LifeCycleHandler lif
         }
     }
 
+    /**
+     * 设置字节数组类型请求体
+     * @param httpReq 后端请求对象
+     * @param request Forest请求对象
+     * @param bytes 字节数组
+     * @param charset 字符集
+     * @param contentType 数据类型
+     * @param mergeCharset 是否合并字符集
+     */
     public void setBody(T httpReq, ForestRequest request, byte[] bytes, String charset, String contentType, boolean mergeCharset) {
         if (charset != null) {
             String text = new String(bytes, Charset.forName(charset));

forest-core/src/main/java/com/dtflys/forest/interceptor/Interceptor.java

@@ -96,6 +96,7 @@ default void afterExecute(ForestRequest request, ForestResponse response) {
      * @param request Forest请求对象
      * @param encoder Forest转换器
      * @param encodedData 序列化后的请求体数据
+     * @return 编码后的请求体数据
      */
     default byte[] onBodyEncode(ForestRequest request, ForestEncoder encoder, byte[] encodedData) {
         return encodedData;

forest-core/src/main/java/com/dtflys/forest/lifecycles/authorization/OAuth2Client.java

@@ -11,7 +11,7 @@
  *
  * @author HouKunLin
  * @since 1.5.0-BETA9
- * @deprecated 已过时，在引入 {@link OAuth2#forestInterceptor()} 功能后，这个接口用法就不再使用了，该接口在未来将会被删除，如果你的代码中有用到该接口，请及时迁移
+ * @deprecated 已过时，在引入 {@link OAuth2#tokenInterceptor()} 功能后，这个接口用法就不再使用了，该接口在未来将会被删除，如果你的代码中有用到该接口，请及时迁移
  */
 @Deprecated
 public interface OAuth2Client {
@@ -23,7 +23,7 @@ public interface OAuth2Client {
      * @param query    GET 参数
      * @param body     POST 参数
      * @return 返回json信息 {@link OAuth2Token}类实例
-     * @deprecated 已过时，在引入 {@link OAuth2#forestInterceptor()} 功能后，这个接口用法就不再使用了，该接口在未来将会被删除，如果你的代码中有用到该接口，请及时迁移
+     * @deprecated 已过时，在引入 {@link OAuth2#tokenInterceptor()} 功能后，这个接口用法就不再使用了，该接口在未来将会被删除，如果你的代码中有用到该接口，请及时迁移
      */
     @Deprecated
     @PostRequest(url = "${tokenUri}")

forest-core/src/main/java/com/dtflys/forest/utils/Base64Utils.java

@@ -15,15 +15,29 @@ public class Base64Utils {
 	private final static Base64.Encoder ENCODER = Base64.getEncoder();
 
 
+    /**
+     * 对字符串进行 Base64 编码，并返回编码后的字符串
+     * @param str 原字符串
+     * @return Base64 编码后的字符串
+     */
     public static String encode(String str) {
 		return ENCODER.encodeToString(str.getBytes());
     }
 
+    /**
+     * 对字符串进行 Base64 编码，并返回编码后的字节数组
+     * @param str 原字符串
+     * @return Base64 编码后的字节数组
+     */
     public static byte[] encodeToByteArray(String str) {
         return ENCODER.encode(str.getBytes());
     }
 
-
+    /**
+     * 对 Base64 编码后的字符串进行解码，并返回解码后的字节数组
+     * @param str Base64 编码后的字符串
+     * @return Base64 解码后的字节数组
+     */
     public static byte[] decode(String str) {
 		return DECODER.decode(str);
     }