asp.net core 参数接收及模型绑定

ASP.NET Core MVC的Model Binding会将HTTP Request数据，以映射的方式对应到参数中。基本上跟ASP.NET MVC差不多，但能Binding的来源更多了一些。
本篇将介绍ASP.NET Core的Model Binding。

参数

HttpRequest

HttpRequest 是用户请求对象
QueryString
Form
Cookie
Session
Header
实例：

        public IActionResult Index()
        {
            QueryString x = Request.QueryString; //	?a=1
            string x = Request.Query["a"]; //1
            return View();
        }

HttpContext

HttpContext 是用户请求上下文
提供Session属性获取Session对象
Session.Set设置
Session.Remove移除
Session.TryGetValue获取数据

Model Binding

要接收Client 传送来的数据，可以通过Action 的参数接收，如下：

1
2
3
4
5
6
7
8
9
10
11
12
using Microsoft.AspNetCore.Mvc;
 
namespace MyWebsite.Controllers
{
    public class HomeController : Controller
    {
        public IActionResult Index(int id)
        {
            return Content($"id: {id}");
        }
    }
}

id就是从HTTP Request的内容被Binding的Model参数。
预设的Model Binding会从HTTP Request的三个地方取值(优先顺序由上到下)：

  • Form
    透过HTTP POST的form取值。如下图：

  • Route
    是通过MVC Route URL取值。
    如：http://localhost:5000/Home/Index/2，id取出的值就会是2。
  • Query
    是通过URL Query参数取值。
    如：http://localhost:5000/Home/Index?id=1，id取出的值就会是1。

如果三者都传入的话，会依照优先顺序取值Form > Route > Query。

Binding Attributes

除了预设的三种Binding 来源外，还可以通过Model Binding Attributes 从HTTP Request 的其他数据中Binding。有以下6 种：

  • [FromHeader]
    从HTTP Header取值。
  • [FromForm]
    通过HTTP POST的form取值。
  • [FromRoute]
    是通过MVC Route URL取值。
  • [FromQuery]
    是通过URL Query参数取值。

  • [FromBody]
    从HTTP Body取值，通常用于取JSON, XML。
    ASP.NET Core MVC预设的序列化是使用JSON，如果要传XML格式做Model Binding的话，要在MVC服务加入XmlSerializerFormatters，如下：

    Startup.cs

1
2
3
4
5
6
// ...
public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc()
            .AddXmlSerializerFormatters();
}

  • [FromServices]
    这个比较特别，不是从HTTP Request取值，而是从DI容器取值。
    DI预设是使用Constructor Injection，但Controller可能会因为每个Action用到不一样的Service导致很多参数，所以也可以在Action注入Service。

范例程序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// ...
public class HomeController : Controller
{
    public IActionResult FirstSample(
        [FromHeader]string header,
        [FromForm]string form,
        [FromRoute]string id,
        [FromQuery]string query)
    {
        return Content($"header: {header}, form: {form}, id: {id}, query: {query}");
    }
     
    public IActionResult DISample([FromServices] ILogger<HomeController> logger)
    {
        return Content($"logger is null: {logger == null}.");
    }
 
    public IActionResult BodySample([FromBody]UserModel model)
    {
        return Ok(model);
    }
}
 
// ...
public class UserModel
{
    public int Id { get; set; }       
    public string Name { get; set; }       
    public string Email { get; set; }       
    public string PhoneNumber { get; set; }       
    public string Address { get; set; }
}

输出结果

FirstSample输出结果：

DISample输出结果：
http://localhost:5000/Home/DISample

1
logger is null: False.

BodySample输出结果：

  • JSON
     
  • XML

Model 验证

Model Binding 也可以顺便帮忙验证字段数据，只要在字段的属性上面带上Validation Attributes，如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
using System.ComponentModel.DataAnnotations;
// ...
public class UserModel
{
    [Required]
    public int Id { get; set; }
 
    [RegularExpression(@"\w+")]
    [StringLength(20, MinimumLength = 4)]
    public string Name { get; set; }
 
    [EmailAddress]
    public string Email { get; set; }
 
    [Phone]
    public string PhoneNumber { get; set; }
 
    [StringLength(200)]
    public string Address { get; set; }
}

然后在Action 加上判断：

Controllers\HomeController.cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
using Microsoft.AspNetCore.Mvc;
 
namespace MyWebsite.Controllers
{
    public class HomeController : Controller
    {
        // ...
        public IActionResult BodySample([FromBody]UserModel model)
        {
            // 由于 Id 是 int 类型，int 默认为 0
            // 虽然带上了 [Required]，但不是 null 所以算是有值。
            if (model.Id < 1)
            {
                ModelState.AddModelError("Id", "Id not exist");
            }
            if (ModelState.IsValid)
            {
                return Ok(model);
            }
            return BadRequest(ModelState);
        }
    }
}

输入错误数据的输出结果：

.NET Core提供了很多的Validation Attributes，可以参考官网：System.ComponentModel.DataAnnotations

自定义Validation Attributes

如果.NET Core提供的Validation Attributes不够用还可以自己做。
例如上述范例的数据模型多了生日字段，需要验证年龄：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
using System;
using System.ComponentModel.DataAnnotations;
 
namespace MyWebsite.Attributes
{
    public class AgeCheckAttribute : ValidationAttribute
    {
        public int MinimumAge { get; private set; }
        public int MaximumAge { get; private set; }
 
        public AgeCheckAttribute(int minimumAge, int maximumAge)
        {
            MinimumAge = minimumAge;
            MaximumAge = maximumAge;
        }
 
        protected override ValidationResult IsValid(object value, ValidationContext validationContext)
        {
            var date = Convert.ToDateTime(value);
 
            if (date.AddYears(MinimumAge) > DateTime.Today
                || date.AddYears(MaximumAge) < DateTime.Today)
            {
                return new ValidationResult(GetErrorMessage(validationContext));
            }
 
            return ValidationResult.Success;
        }
 
        private string GetErrorMessage(ValidationContext validationContext)
        {
            // 有帶 ErrorMessage 的话优先使用
            // [AgeCheck(18, 120, ErrorMessage="xxx")]
            if (!string.IsNullOrEmpty(this.ErrorMessage))
            {
                return this.ErrorMessage;
            }
 
            // 自定义错误信息
            return $"{validationContext.DisplayName} can't be in future";
        }
    }
}

 

鸣谢：
https://www.cnblogs.com/snaildev/p/9112646.html
posted @ 2022-08-04 16:20  春光牛牛  阅读(801)  评论(0)    收藏  举报