!69 feat: 后台清理过期 Cookie

* feat: 后台清理过期 Cookie
* fix: Cookie 值 URLEncode 处理
* feat: Cookie 存储机制
* feat: Cookie 自动化存取
* feat: Cookie 自动化存取
* feat: Cookie 自动化存取
* feat: Cookie 自动化存取
* feat: Cookie 存储机制
* feat: 增强 Cookie 相关 API 接口
* refactor: parse ForestCookie
* refactor: parse ForestCookie
* refactor: ForestCookie 不在依赖 OkHttp
* refactor: ForestCookie 不在依赖 OkHttp
* refactor: parse ForestCookie

Author: mySingleLive

forest-core/src/main/java/com/dtflys/forest/Forest.java

@@ -1,6 +1,7 @@
 package com.dtflys.forest;
 
 import com.dtflys.forest.config.ForestConfiguration;
+import com.dtflys.forest.http.ForestCookie;
 import com.dtflys.forest.http.ForestFuture;
 import com.dtflys.forest.http.ForestRequest;
 import com.dtflys.forest.http.ForestResponse;
@@ -320,4 +321,17 @@ public static void await(Collection<ForestFuture> futures, Consumer<ForestRespon
         }
     }
 
+    /**
+     * 通过Cookie名和Cookie值创建一个Cookie
+     *
+     * @param name Cookie名
+     * @param value Cookie值
+     * @return Forest Cookie
+     * @since 1.7.0
+     */
+    public static ForestCookie cookie(String name, String value) {
+        return ForestCookie.nameValue(name, value);
+    }
+
+
 }

forest-core/src/main/java/com/dtflys/forest/backend/okhttp3/executor/OkHttp3Executor.java

@@ -164,7 +164,10 @@ protected void prepareHeaders(Request.Builder builder) {
                 } else if (ForestHeader.CONTENT_ENCODING.equalsIgnoreCase(name)) {
                     contentEncodingHeaderName = name;
                 } else {
-                    builder.addHeader(name, MappingTemplate.getParameterValue(jsonConverter, nameValue.getValue()));
+                    String headerValue = MappingTemplate.getParameterValue(jsonConverter, nameValue.getValue());
+                    if (headerValue != null) {
+                        builder.addHeader(name, headerValue);
+                    }
                 }
             }
         }

forest-core/src/main/java/com/dtflys/forest/config/ForestConfiguration.java

@@ -53,6 +53,8 @@
 import com.dtflys.forest.http.ForestAsyncMode;
 import com.dtflys.forest.http.ForestRequest;
 import com.dtflys.forest.http.ForestRequestType;
+import com.dtflys.forest.http.cookie.ForestCookieStorage;
+import com.dtflys.forest.http.cookie.MemoryCookieStorage;
 import com.dtflys.forest.interceptor.DefaultInterceptorFactory;
 import com.dtflys.forest.interceptor.Interceptor;
 import com.dtflys.forest.interceptor.InterceptorFactory;
@@ -180,7 +182,6 @@ public class ForestConfiguration implements VariableScope, Serializable {
      */
     private Integer readTimeout;
 
-
     /**
      * 全局的请求失败重试策略类
      */
@@ -361,6 +362,21 @@ public class ForestConfiguration implements VariableScope, Serializable {
      */
     private List<AfterExecuteResultTypeHandler<?>> afterExecuteResultTypeHandlers = new LinkedList<>();
 
+    /**
+     * 是否允许 Cookie 自动存取
+     */
+    private boolean autoCookieSaveAndLoadEnabled = false;
+
+    /**
+     * Cookie 的最大自动存储大小
+     */
+    private int cookiesStorageMaxSize = 2048;
+
+    /**
+     * 全局 Cookie 存储器
+     */
+    private volatile ForestCookieStorage cookieStorage;
+
     /**
      * Forest请求池
      */
@@ -492,7 +508,6 @@ public HttpBackendSelector getBackendSelector() {
     public ForestConfiguration setBackend(HttpBackend backend) {
         if (backend != null) {
             backend.init(this);
-            log.info("[Forest] Http Backend: " + backend.getName());
         }
         this.backend = backend;
         return this;
@@ -1771,6 +1786,65 @@ public ForestConfiguration setSslKeyStores(Map<String, SSLKeyStore> sslKeyStores
         return this;
     }
 
+    /**
+     * 是否允许 Cookie 自动存取
+     * 
+     * @return {@code true}: 允许自动存取, {@code false}: 不允许
+     * @since 1.7.0
+     */
+    public boolean isAutoCookieSaveAndLoadEnabled() {
+        return autoCookieSaveAndLoadEnabled;
+    }
+
+    /**
+     * 设置是否允许 Cookie 自动存取
+     * 
+     * @param autoCookieSaveAndLoadEnabled {@code true}: 允许自动存取, {@code false}: 不允许
+     * @return 当前ForestConfiguration实例
+     * @since 1.7.0
+     */
+    public ForestConfiguration setAutoCookieSaveAndLoadEnabled(boolean autoCookieSaveAndLoadEnabled) {
+        this.autoCookieSaveAndLoadEnabled = autoCookieSaveAndLoadEnabled;
+        return this;
+    }
+
+    /**
+     * 获取 Cookie 的最大自动存储大小
+     * 
+     * @return Cookie 的最大自动存储大小
+     * @since 1.7.0
+     */
+    public int getCookiesStorageMaxSize() {
+        return cookiesStorageMaxSize;
+    }
+
+    /**
+     * 设置 Cookie 的最大自动存储大小
+     * 
+     * @param cookiesStorageMaxSize Cookie 的最大自动存储大小
+     * @since 1.7.0
+     */
+    public void setCookiesStorageMaxSize(int cookiesStorageMaxSize) {
+        this.cookiesStorageMaxSize = cookiesStorageMaxSize;
+    }
+
+    /**
+     * 获取全局 Cookie 存储器
+     * 
+     * @return Cookie 存储器对象
+     * @since 1.7.0
+     */
+    public ForestCookieStorage getCookieStorage() {
+        if (cookieStorage == null) {
+            synchronized (this) {
+                if (cookieStorage == null) {
+                    cookieStorage = new MemoryCookieStorage(cookiesStorageMaxSize);
+                }
+            }
+        }
+        return cookieStorage;
+    }
+
     /**
      * 获取全局请求池
      *