【ASP.NET Core】MVC模型绑定:非规范正文内容的处理

本篇老周就和老伙伴们分享一下,对于客户端提交的不规范 Body 如何做模型绑定。不必多说,这种情况下,只能自定义 ModelBinder 了。而且最佳方案是不要注册为全局 Binder——毕竟这种特殊情况是针对极少数情形的,咱们没必要去干扰标准格式的正常运行(情况复杂,特殊 binder 注册为全局很危险,弄不好容易出“八阿哥”)。

你可能会说,用标准的 JSON 或 XML 不香吗,为什么要做不规范的数据?你可别说,实际开发中,就是有不少思维奇葩的客户,提出各种连外星人都感到神经病的需要。所以,倒了九辈子大霉遇到这样的需求,就不得不根据实际数据格式来自定义绑定了。

OK,老周深刻意识到,讲再多的理论各位都不感兴趣的,人们更习惯于听故事,不然的话为什么正史所记录的事情知者甚少,而很多虚构的故事会在民间大量传播。比如“狸猫换太子”什么的,都是故事,一只死猫能把皇子换掉,你以为皇宫是菜市场呢。

这里有这样的故事:某API,参数是 Room 对象。Room 类型有三个属性——Length、Width、Height,它们的类型都是浮点(float)。然后这个 API 调用时怎么 POST 的呢?三行文本,每一行表示一个属性,格式是 name: value,并且不区分大小写。也就是说,调用 API 时,正文部分这样传:

length:  3.5
width:   0.7
height:  12.5

也可能这样:

LENGTH: 5.5
WIDTH:   10.0
HEIGHT:   2.7

还可能是这样:

Length: 50.2
Width:   11.55
Height:  14.3

所以,待会儿咱们实现属性名称查找时,统一转为小写,这样好比较。

 

下面,开始干活。

1、定义模型

public class Room
{
    public float Length { get; set; }
    public float Width { get; set; }
    public float Height { get; set; }
}

2、定义 API 控制器

[ApiController, Route("api/test")]
public class WhatController : ControllerBase
{
    [HttpPost, Route("abc")]
    public float TestDone(Room rom)
    {
        if (rom.Height <= 0f || rom.Width <= 0f || rom.Length <= 0f)
            return -1f;
        return rom.Height * rom.Width * rom.Length;
    }
}

 

3、自定义 ValueProvider

由于在本例中,body 的内容既不是标准的 XML 和 JSON,也不是 Form-data 结构,所以 .NET Core 默认注册的几个 ValueProvider 是不起作用的。咱们得自己实现一个。

    public class CustValueProvider : IValueProvider
    {
        private readonly IDictionary<string, string> innerDic;

        public CustValueProvider(HttpContext ctx)
        {
            innerDic = new Dictionary<string, string>();
            var req = ctx.Request;
            HttpRequestStreamReader reader = new(req.Body, Encoding.UTF8); string? line;
            // 一行一行地读
            for (line = reader.ReadLineAsync().GetAwaiter().GetResult(); line != null; line = reader.ReadLineAsync().GetAwaiter().GetResult())
            {
                string[] parts = line!.Split(":");
                // 左边是name,右边是value
                string name = parts[0].Trim().ToLower();
                string value = parts[1].Trim();
                innerDic[name] = value;
            }
            reader.Dispose();
        }

        public bool ContainsPrefix(string prefix)
        {
            return true;
        }

        public ValueProviderResult GetValue(string key)
        {
            if (!innerDic.ContainsKey(key))
                return ValueProviderResult.None;
            return new ValueProviderResult(innerDic[key]);
        }
    }

通过构造函数的参数获得 HttpContext 对象,这样就可以访问到 Body,它是个流对象。

然后使用一个叫 HttpRequestStreamReader 的类,它位于 Microsoft.AspNetCore.WebUtilities 命名空间。这个类很好用,可以读文本文件那样读 Body。这里咱们一行一行地读就行,注意要调用 ReadLineAsync 方法,不能调用同步方法(除非你配置 Kestrel 充许同步调用)。异步调用可以确保响应能力,所以还是推荐异步调用。不过,此处是从构造函数调用的,就同步获其结果了。

分析过程是这样的:读出一行文本,然后用英文的冒号分隔字符串,变成一个二元素数组,[0] 就是 name,[1] 就是 value 了。把所有分析出来的东东都添加到字典对象中,方便后面提取值。

ContainsPrefix 方法是分析是否包含前缀,比如前X篇文章中提到的像 stu.name、stu.age 等,stu 就是前缀。这此咱们不考虑这个,所以直接返回 true。

GetValue 方法是关键,这是供给外面调用的规范方法,通过 key 从字典对象中查找出值。查找的 key 用的就是 Room 类的属性名称。

 

4、自定义 ModelBinder

    public class RoomBinder : IModelBinder
    {
        public Task BindModelAsync(ModelBindingContext bindingContext)
        {
            // 参数不能为 null
            if (bindingContext == null)
                throw new ArgumentNullException(nameof(bindingContext));

            // 特殊处理,把全局的 ValueProvider 替换
            bindingContext.ValueProvider = new CustValueProvider(bindingContext.HttpContext);

            var objMetadata = bindingContext.ModelMetadata;
            // 目标类型有三个属性
            if (objMetadata.Properties.Count == 0)
                return Task.CompletedTask;

            Type modeltype = objMetadata.ModelType;
            // 创建实例
            object? modelObj = Activator.CreateInstance(modeltype);
            if (modelObj is null)
                return Task.CompletedTask;

            // 给属性赋值
            foreach (var prop in objMetadata.Properties)
            {
                // 找到 key
                string key = prop.Name!.ToLower();
                var wrapValue = bindingContext.ValueProvider.GetValue(key);
                if (wrapValue == ValueProviderResult.None)
                    continue;   //无值,有请下一位
                // 取内容
                string realVal = wrapValue.FirstValue!;
                // null 或者长度为 0,不可用
                if (realVal is null or { Length: 0 })
                    continue;   //没有用的值,有请下一位
                // 看看能不能转换
                var proptype = prop.ModelType;  //这是属性值的类型
                object? propval;
                try
                {
                    // 把取出的字符串转换为属性值的类型
                    propval = Convert.ChangeType(realVal, proptype);
                }
                catch { continue; }
                // 设置属性值
                // PropertyGetter:获取属性的值
                // PropertySetter:设置属性的值
                if (propval != null && prop.PropertySetter != null)
                {
                    prop.PropertySetter(modelObj!, propval);
                }
            }
            // 重要:一定要设置绑定的结果
            bindingContext.Result = ModelBindingResult.Success(modelObj);

            return Task.CompletedTask;
        }
    }

由于是针对特殊情形的绑定,所以这里老周就不分析 Content-Type,假设它任意内容均可,文本提交一般用 text/* 或者明确一点 text/plain。

这里咱们也不使用全局的 ValueProvider,所以把 bindingContext 的也替换掉。

   bindingContext.ValueProvider = new CustValueProvider(bindingContext.HttpContext);

因为针对性强,这里其实你可以直接 new 一个 Room 实例,然后从 ValueProvider 中找出三个属性的值,直接转换为 float 值,赋给对象的三个属性即可。不过,老周为了装逼,写得复杂了一点。

ModelMetadata 包含目标类型相关的信息,比如它的 Type,它有几个属性(Properties),每个属性也能获取到 ModelMetaData,表示属性值的类型信息。

所以,首先咱们从 ModelType 得到 Room 类的 Type,接着,用 Activator 来创建它的实例。

从 Properties 中取出各个属性的 ModelMetaData,并根据属性名(有定义属性的类型通常不会为null)来查找出各属性的值,类型是字符串。然后获取属性值的 Type,再用 Convert.ChangeType 做类型转换,转为属性值的类型(这里其实是 float)。

再通过 PropertySetter 来设置属性的值,它是委托类型,和属性的 set 访问器绑定。

最后 ModelBindingResult.Success 设置填充 Room 对象。

 

补充:忘了最后一步,要在 Room 类的定义上应用 ModelBinder 特性。

[ModelBinder(typeof(RoomBinder))] public class Room
{
    ……
}

————————————————————————————————

测试

POST /api/test/abc HTTP/1.1
Content-Type: text/plain
User-Agent: PostmanRuntime/7.29.0
Accept: */*
Host: localhost:5018
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 36
 
width: 3.6 height: 5.5 length: 8.0
 
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 26 Mar 2022 05:00:16 GMT
Server: Kestrel
Transfer-Encoding: chunked
 
158.4

好了,这个特殊绑定就顺利完成了。

 

其实,自定义 InputFormatter 也可以实现同样功能的,这个老周下一篇再扯。

 2 total views,  1 views today

页面下部广告