更新

Docs/1.3.2.基础使用.使用请求数据.ipynb

@@ -33,7 +33,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 13,
+   "execution_count": 1,
    "metadata": {
     "dotnet_interactive": {
      "language": "csharp"
@@ -126,8 +126,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 19,
+   "execution_count": 13,
    "metadata": {
+    "dotnet_interactive": {
+     "language": "csharp"
+    },
+    "polyglot_notebook": {
+     "kernelName": "csharp"
+    },
     "vscode": {
      "languageId": "polyglot-notebook"
     }
@@ -137,7 +143,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "{\"data\":{\"id\":1,\"name\":\"管理员01\",\"password\":\"123456\",\"role\":\"Admin\"},\"code\":1,\"message\":\"成功\"}\r\n"
+      "配置文件根目录：e:\\王高峰\\我的项目\\学习项目\\HttpClientStudy\\Docs\\Publish\\HttpClientStudy.Core\n",
+      "{\"data\":{\"id\":1,\"name\":\"管理员01\",\"password\":\"123456\",\"role\":\"Admin\"},\"code\":1,\"message\":\"成功\"}\n"
      ]
     },
     {
@@ -268,8 +275,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 24,
+   "execution_count": 14,
    "metadata": {
+    "dotnet_interactive": {
+     "language": "csharp"
+    },
+    "polyglot_notebook": {
+     "kernelName": "csharp"
+    },
     "vscode": {
      "languageId": "polyglot-notebook"
     }
@@ -318,8 +331,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 35,
+   "execution_count": 15,
    "metadata": {
+    "dotnet_interactive": {
+     "language": "csharp"
+    },
+    "polyglot_notebook": {
+     "kernelName": "csharp"
+    },
     "vscode": {
      "languageId": "polyglot-notebook"
     }
@@ -369,19 +388,48 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 4、使用Form表单"
+    "## 4、使用请求体"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "把数据放在请求体中，发送到服务端。可以是简单的字符串，也可以是二进制数据(上传文件)、form表单项、编码过的form表单项、json、流式数据等形式，甚至是这个类型的组合。\n",
+    "\n",
+    "说下个人的几点理解：\n",
+    "1、不管哪种请求体数据，都是放在请求体中，以二进制形式通过网络发往服务器，由服务器接收使用。客户端发送请求数据需要与服务端接收相配合；\n",
+    "2、客户端通过Content-Typey请求头设置，告诉服务端请求发送的是哪种类型的数据;服务端根据Content-Type来识别、解析请求数据。常见的类型有：multipart/form-data、application/x-www-form-urlencoded、application/json、text/plain等；\n",
+    "3、ASP.NET Core中，默认的请求体类型是FormUrlEncodedContent，所以默认情况下，客户端发送的请求数据是form表单项; asp.net 框架对json格式数据和表单数据进行了特殊处理，支持参数绑定等，可以使用[FromBody]特性，将请求数据绑定到对应的模型上。但普通的文本类型等不支持绑定等功能，需要从请求体中获取原始数据，自行处理。\n",
+    "4、一次可发送多种格式数据，由统一的分隔符分隔。服务端可以从请求头[] Content-Type: multipart/mixed; boundary=\"d2e38916-df08-4fec-a40e-3e5179736f32\"]拿到分隔符，然后根据分隔符将数据拆分出来。\n",
+    "\n",
+    "HttpClient 中，请求体也分为这几种(常见的)类型：\n",
+    "1. MultipartFormDataContent\n",
+    "2. FormUrlEncodedContent\n",
+    "3. JsonContent\n",
+    "4. StringContent\n",
+    "5. ByteArrayContent\n",
+    "6. StreamContent\n",
+    "7. MultipartContent"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### MultipartFormDataContent ：Form表单"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "简单的Form表单，提交数据。其实是把数据放请求值的一种，后页有详细介绍。"
+    "Form表单，提交数据方式之一。"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 46,
+   "execution_count": 13,
    "metadata": {
     "vscode": {
      "languageId": "polyglot-notebook"
@@ -392,7 +440,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "{\"data\":\"Id=1&name=管理员01\",\"code\":1,\"message\":\"成功\"}\r\n"
+      "{\"data\":\"id=1&name=管理员01\",\"code\":1,\"message\":\"成功\"}\r\n"
      ]
     }
    ],
@@ -401,7 +449,7 @@
     "*   Form表单，提交数据。一般为Put或Post提交。\n",
     "*/\n",
     "{\n",
-    "    // 创建一个MultipartFormDataContent对象,用来存入 Form表单独项及值\n",
+    "    // 创建一个 MultipartFormDataContent 对象, 用来存入 Form表单 各项及值\n",
     "    var formContent = new MultipartFormDataContent();\n",
     " \n",
     "    // 添加表单字段\n",
@@ -422,21 +470,25 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 5、使用请求体"
+    "### FormUrlEncodedContent ：Form表单 asp.net core 默认接收方式"
    ]
   },
   {
-   "cell_type": "markdown",
+   "cell_type": "code",
-   "metadata": {},
+   "execution_count": null,
+   "metadata": {
+    "vscode": {
+     "languageId": "polyglot-notebook"
+    }
+   },
+   "outputs": [],
    "source": [
-    "把数据放在请求体中，发送到服务端。可以是简单的字符串，也可以是二进制数据(上传文件)、form表单项、编码过的form表单项、json、流式数据等形式，甚至是这个类型的组合。\n",
+    "/*\n",
-    "所以请求体也分为这几种(常见的)类型：\n",
+    "    \n",
-    "1. StringContent\n",
+    "*/\n",
-    "2. ByteArrayContent\n",
+    "{\n",
-    "3. FormUrlEncodedContent\n",
+    "\n",
-    "4. JsonContent\n",
+    "}"
-    "5. StreamContent\n",
-    "6. MultipartContent\n"
    ]
   },
   {
@@ -452,16 +504,39 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 11,
    "metadata": {
+    "dotnet_interactive": {
+     "language": "csharp"
+    },
+    "polyglot_notebook": {
+     "kernelName": "csharp"
+    },
     "vscode": {
      "languageId": "polyglot-notebook"
     }
    },
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\"data\":\"我是请求体第一段内容\",\"code\":1,\"message\":\"成功\"}\r\n"
+     ]
+    }
+   ],
    "source": [
+    "/*\n",
+    "    \n",
+    "*/\n",
     "{\n",
-    "    StringContent content = new StringContent(\"\",Encoding.UTF8, System.Net.Mime.MediaTypeNames.Text.Plain);\n",
+    "    var requestContent = new StringContent(\"我是请求体第一段内容\", Encoding.UTF8, \"text/plain\");\n",
+    "\n",
+    "    var response = await SharedClient.PostAsync(\"/api/AdvancedPost/TextData\", requestContent);\n",
+    "\n",
+    "    var content = await response.Content.ReadAsStringAsync();\n",
+    "\n",
+    "    Console.WriteLine(content);\n",
     "}"
    ]
   }

HttpClientStudy.WebApp/Controllers/AdvancedGetController.cs

@@ -15,12 +15,12 @@ namespace HttpClientStudy.WebApp.Controllers
     [ApiController]
     public class AdvancedGetController : ControllerBase
     {
-        private ILogger<SimpleController> _logger;
+        private ILogger<AdvancedGetController> _logger;
 
         /// <summary>
         /// 构造
         /// </summary>
-        public AdvancedGetController(ILogger<SimpleController> logger)
+        public AdvancedGetController(ILogger<AdvancedGetController> logger)
         { 
             _logger = logger;
         }

HttpClientStudy.WebApp/Controllers/AdvancedPostController.cs

@@ -0,0 +1,95 @@
+using System.ComponentModel.DataAnnotations;
+using System.Text;
+
+using HttpClientStudy.WebApp.Models;
+
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+
+namespace HttpClientStudy.WebApp.Controllers
+{
+    /// <summary>
+    /// 高级Post请求 控制器
+    /// </summary>
+    [Route("api/[controller]/[action]")]
+    [ApiController]
+    public class AdvancedPostController : ControllerBase
+    {
+        private ILogger<AdvancedPostController> _logger;
+
+        /// <summary>
+        /// 构造
+        /// </summary>
+        public AdvancedPostController(ILogger<AdvancedPostController> logger)    
+        { 
+            _logger = logger;
+        }
+
+        #region 接收请求体数据
+
+        /// <summary>
+        /// 接收请求体数据
+        /// 普通文本：直接从原始请求体获取。不能使用 [FromBody]绑定特性，因为绑定是针对 Form表单、Json格式的特殊数据。
+        /// </summary>
+        /// <returns>
+        /// 返回请求体原始数据
+        /// </returns>
+        [HttpPost]
+        public async Task<IActionResult> TextData()
+        {
+            string content = "请求体没有数据";
+
+            if (Request.ContentLength>0)
+            {
+                byte[] bytes = new byte[(int)Request.ContentLength];
+
+                await Request.Body.ReadAsync(bytes);
+
+                content = UnicodeEncoding.UTF8.GetString(bytes);
+            }
+
+            var result = BaseResultUtil.Success(content);
+            return Ok(result);
+        } 
+
+        /// <summary>
+        /// 接收请求体数据
+        /// 表单数据
+        /// </summary>
+        /// <returns></returns>
+        [HttpPost]
+        public IActionResult FormData([FromForm,Required]int id, [FromForm,Required]string name)
+        {
+            var paras = $"{nameof(id)}={id}&{nameof(name)}={name}";
+            var result = BaseResultUtil.Success(paras);
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// 接收请求体数据
+        /// 编码后的表单数据
+        /// </summary>
+        /// <returns></returns>
+        [HttpPost]
+        public IActionResult FormUrlEncodedData([FromForm, Required] int id, [FromForm, Required] string name)
+        {
+            var paras = $"{nameof(id)}={id}&{nameof(name)}={name}";
+            var result = BaseResultUtil.Success(paras);
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// 接收请求体数据
+        /// json 数据
+        /// </summary>
+        /// <returns></returns>
+        [HttpPost]
+        public IActionResult JsonData([FromBody]AdvancedGetModel? vm)
+        {
+            var result = BaseResultUtil.Success(vm);
+            return Ok(result);
+        }
+
+        #endregion
+    }
+}