Update to p25

Author: Surbowl

README.md

@@ -4,7 +4,7 @@ __ASP.NET Core 3.0 实现 RESTful API 的学习笔记__
 <br><br>
 跟随杨旭老师（solenovex）的[博客](https://www.cnblogs.com/cgzl/p/11814971.html)与[视频](https://www.bilibili.com/video/av77957694?from=search&seid=17664776753878261104)课程，学习 RESTful API 在ASP.NET Core 3.0 上的实现。
 <br>
-包含课程中搭建的项目与部分笔记，目前覆盖到视频 P24 
+包含课程中搭建的项目与部分笔记，目前覆盖到视频 P25 
 <br><br><br>
 非常感谢杨老师 🤗
 <br>

Routine/Routine.APi/Controllers/CompaniesController.cs

@@ -17,8 +17,8 @@
  * PATCH    - 局部修改/更新                    |    N     N
  * PUT      - 如果存在就替换，不存在则创建      |     N     Y
  * DELETE   - 移除/删除                       |     N     Y
- * OPTIONS  - 略                              |     Y     Y
- * HEAD     - 略                              |     Y     Y
+ * OPTIONS  - 获取 Web API 的通信选项的信息    |     Y     Y
+ * HEAD     - 只请求页面的首部                 |     Y     Y
  * 
  * 安全性是指方法执行后并不会改变资源的表述
  * 幂等性是指方法无论执行多少次都会得到同样的结果
@@ -136,5 +136,12 @@ public async Task<IActionResult> CreateCompany([FromBody]CompanyAddDto company)
             //通过使用 CreatedAtRoute 返回时可以在 Header 中添加一个地址（Loaction）
             return CreatedAtRoute(nameof(GetCompany), new { companyId = returnDto.Id }, returnDto);
         }
+
+        [HttpOptions]
+        public IActionResult GetCompaniesOptions()
+        {
+            Response.Headers.Add("Allow", "GET,POST,OPTIONS");
+            return Ok();
+        }
     }
 }

Routine/Routine.APi/Startup.cs

@@ -30,35 +30,38 @@ public Startup(IConfiguration configuration)
         // 注册服务 This method gets called by the runtime. Use this method to add services to the container.
         public void ConfigureServices(IServiceCollection services)
         {
+            /*
+            * 内容协商：
+            * 针对一个响应，当有多种表述格式的时候，选取最佳的一个表述，例如 application/json、application/xml
+            * 
+            * Accept Header 指明服务器输出格式，对应 ASP.NET Core 里的 Output Formatters
+            * 如果服务器不支持客户端请求的媒体类型（Media Type），返回状态码406
+            * 
+            * Content-Type Header 指明服务器输入格式，对应 ASP.NET Core 里的 Input Formatters
+            */
+
+            //以下是一种较旧的写法，在本项目中不使用
+            //services.AddControllers(options =>
+            //{
+            //    //启用406状态码
+            //    options.ReturnHttpNotAcceptable = true;
+
+            //    //OutputFormatters 默认有且只有 Json 格式
+            //    //添加对输出 XML 格式的支持
+            //    //此时默认输出格式依然是 Json ,因为 Json 格式位于第一位置
+            //    options.OutputFormatters.Add(new XmlDataContractSerializerOutputFormatter());
+
+            //    //如果在 Index 0 位置插入对 XML 格式的支持，那么默认输出格式是 XML
+            //    //options.OutputFormatters.Insert(0, new XmlDataContractSerializerOutputFormatter());
+            //});
+            //
+            //以下是较新的写法，使用诸如 AddXmlDataContractSerializerFormatters() 等，使用更方便。
             services.AddControllers(options =>
             {
-                /*
-                 * 内容协商：
-                 * 针对一个响应，当有多种表述格式的时候，选取最佳的一个表述，例如 application/json、application/xml
-                 * 
-                 * Accept Header 指明服务器输出格式，对应 ASP.NET Core 里的 Output Formatters
-                 * 如果服务器不支持客户端请求的媒体类型（Media Type），返回状态码406
-                 * 
-                 * Content-Type Header 指明服务器输入格式，对应 ASP.NET Core 里的 Input Formatters
-                 */
-
                 //启用406状态码
                 options.ReturnHttpNotAcceptable = true;
 
-                //OutputFormatters 默认有且只有 Json 格式
-                //添加对 XML 格式的支持
-                //此时默认格式依然是 Json ,因为 Json 格式位于第一位置
-                options.OutputFormatters.Add(new XmlDataContractSerializerOutputFormatter());
-
-                //如果在 Index 0 位置插入对 XML 格式的支持，那么默认格式是 XML
-                //options.OutputFormatters.Insert(0, new XmlDataContractSerializerOutputFormatter());
-            });
-
-            //以下是另一种较新的写法，同样实现对 XML 格式的支持
-            //services.AddControllers(options =>
-            //{
-            //    options.ReturnHttpNotAcceptable = true;
-            //}).AddXmlDataContractSerializerFormatters();
+            }).AddXmlDataContractSerializerFormatters(); //添加对 XML 输入与输出格式的支持
 
             //使用 AutoMapper，扫描当前应用域的所有 Assemblies 寻找 AutoMapper 的配置文件
             services.AddAutoMapper(AppDomain.CurrentDomain.GetAssemblies());