refactor: Move some of the dependency injection code to the Common Library.

2025-09-06 05:36:53 +00:00 · 2022-10-06 12:45:01 +08:00
parent aa90e232f7
commit ecab0e0f5c
34 changed files with 60 additions and 73 deletions
--- a/src/ZonyLrcTools.Common/Infrastructure/Network/IWarpHttpClient.cs
+++ b/src/ZonyLrcTools.Common/Infrastructure/Network/IWarpHttpClient.cs
@@ -0,0 +1,59 @@
+namespace ZonyLrcTools.Common.Infrastructure.Network
+{
+    /// <summary>
+    /// 基于 <see cref="IHttpClientFactory"/> 封装的 HTTP 请求客户端。
+    /// </summary>
+    public interface IWarpHttpClient
+    {
+        /// <summary>
+        /// 根据指定的配置执行 POST 请求，并以 <see cref="string"/> 作为返回值。
+        /// </summary>
+        /// <param name="url">请求的 URL 地址。</param>
+        /// <param name="parameters">请求的参数。</param>
+        /// <param name="isQueryStringParam">是否以 QueryString 形式携带参数。</param>
+        /// <param name="requestOption">请求时的配置动作。</param>
+        /// <returns>服务端的响应结果。</returns>
+        ValueTask<string> PostAsync(string url,
+            object parameters = null,
+            bool isQueryStringParam = false,
+            Action<HttpRequestMessage> requestOption = null);
+
+        /// <summary>
+        /// 根据指定的配置执行 POST 请求，并将结果反序列化为 <see cref="TResponse"/> 对象。
+        /// </summary>
+        /// <param name="url">请求的 URL 地址。</param>
+        /// <param name="parameters">请求的参数。</param>
+        /// <param name="isQueryStringParam">是否以 QueryString 形式携带参数。</param>
+        /// <param name="requestOption">请求时的配置动作。</param>
+        /// <typeparam name="TResponse">需要将响应结果反序列化的目标类型。</typeparam>
+        /// <returns>服务端的响应结果。</returns>
+        ValueTask<TResponse> PostAsync<TResponse>(string url,
+            object parameters = null,
+            bool isQueryStringParam = false,
+            Action<HttpRequestMessage> requestOption = null);
+
+        /// <summary>
+        /// 根据指定的配置执行 GET 请求，并以 <see cref="string"/> 作为返回值。
+        /// </summary>
+        /// <param name="url">请求的 URL 地址。</param>
+        /// <param name="parameters">请求的参数。</param>
+        /// <param name="requestOption">请求时的配置动作。</param>
+        /// <returns>服务端的响应结果。</returns>
+        ValueTask<string> GetAsync(string url,
+            object parameters = null,
+            Action<HttpRequestMessage> requestOption = null);
+
+        /// <summary>
+        /// 根据指定的配置执行 GET 请求，并将结果反序列化为 <see cref="TResponse"/> 对象。
+        /// </summary>
+        /// <param name="url">请求的 URL 地址。</param>
+        /// <param name="parameters">请求的参数。</param>
+        /// <param name="requestOption">请求时的配置动作。</param>
+        /// <typeparam name="TResponse">需要将响应结果反序列化的目标类型。</typeparam>
+        /// <returns>服务端的响应结果。</returns>
+        ValueTask<TResponse> GetAsync<TResponse>(
+            string url,
+            object parameters = null,
+            Action<HttpRequestMessage> requestOption = null);
+    }
+}