理清Action参数绑定，可以降低使用core mvc的时候常遇到的参数绑定失败等问题，节约开发时间。

这个故事还要从Content-Type讲起：

1. 为啥需要content-type

http是超文本传输协议，数据都是以文本的方式传输。服务器要解析出客户端传过来的数据，数据结构那么多，服务器怎么知道你传输过来的数据结构？content-type就是用来描述传输过程中的数据结构的。服务器把数据传给客户端的时候，也需要告知客户端我传给你的数据结构是啥样子的，同样是用content-type来描述。

2. content-type有哪些

• 客户端——>服务器 客户端传给服务器的常用content-type有这么几种：

1. application/x-www-form-urlencoded （格式：title=test&sub=3）表单提交，默认就是这种content-type数据结构
2. multipart/form-data 既可以上传文件，也可以上传键值对，数据结构比较长，不贴了，主要用来传文件。
3. text/plain 纯文本，不告诉服务器我是啥数据结构，json可以传，字符串可以传，只要是文本都可以传。
4. application/json 以Json格式编码数据体，方便传输结构化数据（相比键值对），广泛用于 ajax 请求
5. text/xml 以xml格式编码数据体，是早期互联网广泛使用的格式

• 服务器——>客户端

1. content-type对照表 http://tool.oschina.net/commons/
2. 贴一个图片请求的response

Cache-Control: no-cache
Connection: keep-alive
Content-Type: image/png;charset=utf-8
Date: Sun, 24 Feb 2019 04:22:33 GMT
Expires: Sun, 1 Jan 2000 01:00:00 GMT
Pragma: must-revalidate, no-cache, private
Server: nginx
Transfer-Encoding: chunked

再贴一个json的响应头

Access-Control-Allow-Origin: *
Cache-control: private
Connection: close
Content-Encoding: gzip
Content-Type: application/json; charset=utf-8
Date: Sun, 24 Feb 2019 04:23:11 GMT
Server: nginx/1.7.10
Vary: Accept-Encoding
X-Powered-By: PHP/5.6.6

贴一个文件下载的

Accept-Ranges: bytes
Access-Control-Allow-Origin: *
Access-Control-Expose-Headers: X-Log, X-Reqid
Access-Control-Max-Age: 2592000
Ali-Swift-Global-Savetime: 1550982437
Cache-Control: public, max-age=31536000
Connection: keep-alive
Content-Disposition: attachment; //设置浏览器如何处置文件，inline在浏览器中显示 和 attachment打开下载对话框
filename="RO-怪物物品图片-土波利_爱给网_aigei_com.png"; filename*=utf-8' 'RO-%E6%80%AA%E7%89%A9%E7%89%A9%E5%93%81%E5%9B%BE%E7%89%87-%E5%9C%9F%E6%B3%A2%E5%88%A9_%E7%88%B1%E7%BB%99%E7%BD%91_aigei_com.png
Content-Length: 733
Content-Transfer-Encoding: binary
Content-Type: image/png
Date: Sun, 24 Feb 2019 04:27:17 GMT
EagleId: 73e7282115509824370526003e
Last-Modified: Mon, 01 Jan 0001 00:00:00 GMT
Server: Tengine
Timing-Allow-Origin: *
Via: cache7.l2et15[90,200-0,M], cache7.l2et15[91,0], cache17.cn1088[149,200-0,M], cache13.cn1088[150,0]

3. 总结

content-type 是描述服务器和客户端通信的数据格式，是非常重要的一个字段，如果请求头中设置的是application/x-www-form-urlencoded，而传过去的是json，服务器以application/x-www-form-urlencoded的数据格式去解析请求的数据，将无法获取到数据。

asp.net core mvc Action参数绑定

1. 绑定来自路由参数的数据

1.1 我叫啥

• get请求 地址是/home/IndexGet 后面没有任何参数

  
  image.png

• post请求 地址是/home/IndexPost 后面没有任何参数

  
  image.png

1.2 我的controller叫啥

• get请求 地址是/home/IndexGet 后面没有任何参数

  
  image.png

• post请求 地址是/home/IndexPost 后面没有任何参数

  
  image.png

1.3 增加路由参数

            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{api=api}/{controller=Home}/{action=Index}/{id?}");
            });
            

1.4 Model绑定和全局成员绑定

定义如下

public class HomeController : Controller
    {
        [ModelBinder]
        public string controller { get; set; }
        [ModelBinder]
        public string action { get; set; }
        [ModelBinder]
        public string api { get; set; }

        [HttpPost]
        public IActionResult IndexPost(Test test)
        {
            return Content("");
        }

        [HttpGet]
        public IActionResult IndexGet(Test test)
        {
            return Content("");
        }
    }

    public class Test
    {
        public string controller { get; set; }
        public string action { get; set; }
        public string api { get; set; }
    }

• get请求 地址是/test/home/IndexGet 后面没有任何参数

  
  image.png

• post请求 地址是/test/home/IndexPost 后面没有任何参数

  
  image.png

2. 绑定来自url参数的数据

//请求地址
/test/home/IndexGet?param1=1&param2=2&param3=3

image.png

3. 绑定来自header的数据

image.png image.png image.png

需要注意的是FromHeader必须放在类的属性上

下面这种方式，无法获取到数据

[HttpGet]
public IActionResult IndexGet([FromHeader]Test test)
{
    return Content("");
}

4. 绑定DI容器中的数据

        [HttpGet]
        public IActionResult IndexGet([FromServices]IControllerFactory iControllerFactory)
        {
            return Content("");
        }

image.png

上面iControllerFactory是框架初始化的时候会自动初始化到DI容器中的一个对象。

5.绑定content-type为application/x-www-form-urlencoded的数据（默认表单提交）

    //这是Action
    [HttpPost]
    public IActionResult IndexPost(Test test)
    {
        return Content("");
    }
    //这是Model
    public class Test
    {
        public string param1 { get; set; }
        public string param2 { get; set; }

    }

这是结果

image.png

application/x-www-form-urlencoded类型的绑定非常简单基本上不用做什么操作就可以绑定成功

6.绑定content-type为multipart/form-data的数据

public class HomeController : Controller
    {

        [HttpPost]
        public IActionResult IndexPost(Test test)
        {
            return Content("");
        }

        [HttpGet]
        public IActionResult IndexGet(Test test)
        {
            return Content("");
        }
    }

    public class Test
    {
        public string param1 { get; set; }
        public IFormFileCollection param2 { get; set; }
    }

image.png

请求结果

image.png

7.绑定content-type为application/json的数据

请求头

POST /home/IndexPost HTTP/1.1
Host: localhost:49780
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: a17123b3-df00-4fdc-23fc-181437681135

{param1:1}

action

 public class HomeController : Controller
 {

     [HttpPost]
     public IActionResult IndexPost(Test test)
     {
         return Content("");
     }

     [HttpGet]
     public IActionResult IndexGet(Test test)
     {
         return Content("");
     }
 }

 public class Test
 {
     public string param1 { get; set; }
 }

结果

image.png

没有获取到请求的值

---

修改Action

 [HttpPost]
 public IActionResult IndexPost([FromBody]Test test)
 {
     return Content("");
 }

结果

image.png

---

请求头

POST /home/IndexPost HTTP/1.1
Host: localhost:49780
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 3eac37b2-f2c4-0898-eb5d-906933b92d95

{param1:"assa"}

Action和Model

[HttpPost]
public IActionResult IndexPost([FromBody]Test test)
{
    return Content("");
}
        
public class Test
{
    public int param1 { get; set; }
}

image.png

结果并没有获取到数据

image.png

需要特别注意，模型绑定的过程中的错误，不会抛出异常。异常会被记录到ModelState中。
查看ModelState可以发现是类型转换失败了，所以请求的时候如果发现请求Model绑定失败，可以检查下是否有错误。