refactor(web): 修复 WebBinaryData 命名与代码规范

- Task 属性重命名为 TaskSource 避免与 System.Threading.Tasks.Task 冲突
- 补回 Create 方法的 task 空值检查
- 提取 CopyHeader 辅助方法与 WebJsonData 风格统一

GameFrameX/com.gameframex.unity#5

Author: AlianBlank

Runtime/Web/WebManager.Binary.cs

@@ -118,12 +118,12 @@ private async void MakeBinaryBytesRequest(WebBinaryData webData)
                 m_SendingBinaryList.Remove(webData);
                 if (unityWebRequest.isNetworkError || unityWebRequest.isHttpError || unityWebRequest.error != null)
                 {
-                    webData.Task.TrySetException(new Exception(unityWebRequest.error));
+                    webData.TaskSource.TrySetException(new Exception(unityWebRequest.error));
                     ReferencePool.Release(webData);
                     return;
                 }
 
-                webData.Task.SetResult(new WebBufferResult(webData.UserData, unityWebRequest.downloadHandler.data));
+                webData.TaskSource.SetResult(new WebBufferResult(webData.UserData, unityWebRequest.downloadHandler.data));
                 ReferencePool.Release(webData);
             };
 #else
@@ -165,7 +165,7 @@ private async void MakeBinaryBytesRequest(WebBinaryData webData)
                         m_MemoryStream.Position = 0;
                         await responseStream.CopyToAsync(m_MemoryStream);
                         var resultData = m_MemoryStream.ToArray();
-                        webData.Task.SetResult(new WebBufferResult(webData.UserData, resultData)); // 将流的内容复制到内存流中并转换为byte数组 
+                        webData.TaskSource.SetResult(new WebBufferResult(webData.UserData, resultData)); // 将流的内容复制到内存流中并转换为byte数组 
                     }
                 }
             }
@@ -174,19 +174,19 @@ private async void MakeBinaryBytesRequest(WebBinaryData webData)
                 // 捕获超时异常
                 if (e.Status == WebExceptionStatus.Timeout)
                 {
-                    webData.Task.SetException(new TimeoutException(e.Message));
+                    webData.TaskSource.SetException(new TimeoutException(e.Message));
                     return;
                 }
 
-                webData.Task.SetException(e);
+                webData.TaskSource.SetException(e);
             }
             catch (IOException e)
             {
-                webData.Task.SetException(e);
+                webData.TaskSource.SetException(e);
             }
             catch (Exception e)
             {
-                webData.Task.SetException(e);
+                webData.TaskSource.SetException(e);
             }
             finally
             {

Runtime/Web/WebManager.WebBinaryData.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using GameFrameX.Runtime;
@@ -16,7 +17,7 @@ private sealed class WebBinaryData : WebData
             /// <summary>
             /// 获取请求任务的完成源，用于异步操作的控制和结果返回
             /// </summary>
-            public TaskCompletionSource<WebBufferResult> Task { get; private set; }
+            public TaskCompletionSource<WebBufferResult> TaskSource { get; private set; }
 
             /// <summary>
             /// 获取要发送的字节数组数据
@@ -38,39 +39,29 @@ public WebBinaryData() { }
             /// </summary>
             public static WebBinaryData Create(string url, Dictionary<string, string> header, byte[] sendData, TaskCompletionSource<WebBufferResult> task, object userData)
             {
+                if (task == null)
+                {
+                    throw new ArgumentNullException(nameof(task));
+                }
+
                 var data = ReferencePool.Acquire<WebBinaryData>();
                 data.URL = url;
                 data.IsGet = false;
                 data.UserData = userData;
-                data.Task = task;
+                data.TaskSource = task;
                 data.SendData = sendData;
 
-                if (header != null && header.Count > 0)
-                {
-                    if (data.m_Header == null)
-                    {
-                        data.m_Header = new Dictionary<string, string>(header.Count);
-                    }
-                    else
-                    {
-                        data.m_Header.Clear();
-                    }
-
-                    foreach (var kv in header)
-                    {
-                        data.m_Header[kv.Key] = kv.Value;
-                    }
-                }
+                CopyHeader(data, header);
 
                 return data;
             }
 
             public override void Clear()
             {
-                if (Task != null)
+                if (TaskSource != null)
                 {
-                    Task.TrySetCanceled();
-                    Task = null;
+                    TaskSource.TrySetCanceled();
+                    TaskSource = null;
                 }
 
                 SendData = null;
@@ -82,6 +73,28 @@ public override void Clear()
 
                 base.Clear();
             }
+
+            private static void CopyHeader(WebBinaryData data, Dictionary<string, string> header)
+            {
+                if (header == null || header.Count == 0)
+                {
+                    return;
+                }
+
+                if (data.m_Header == null)
+                {
+                    data.m_Header = new Dictionary<string, string>(header.Count);
+                }
+                else
+                {
+                    data.m_Header.Clear();
+                }
+
+                foreach (var kv in header)
+                {
+                    data.m_Header[kv.Key] = kv.Value;
+                }
+            }
         }
     }
 }