.NET WebAPI 自定义 NullableConverter 解决可为空类型字段入参“”空字符触发转换异常问题
最近在项目中启用了Nullable 可为空的类型,这个特性确实很好用,在 WebAPI 的入参上可以直接采用 ? 来标记一个字段是否允许为空,但是使用过程中遇到了如下一个问题,比如创建部门接口
我们定义入参模型如下:
public class DtoDepartment
{
/// <summary>
/// 部门名称
/// </summary>
public string Name { get; set; }
/// <summary>
/// 上级部门ID
/// </summary>
public Guid? ParentId { get; set; }
}
我们这里将上级部门ID定义为可以为空的类型,因为有些部门不存在上级部门
然后定义这样一个接口
[HttpPost("CreateDepartment")]
public bool CreateDepartment(DtoDepartment department)
{
//省略业务逻辑
return true;
}
当前端请求的时候传入如下Json 时则就会触发异常
{
"name": "商务一部",
"parentId": ""
}
异常内容为:
{
"errMsg": "The department field is required. | The JSON value could not be converted to System.Nullable`1[System.Guid]. Path: $.parentId | LineNumber: 2 | BytePositionInLine: 16."
}
像这样的情况是因为虽然我们定义的 Dto 允许上级部门ID字段为空,但是前端调用的时候 parentId 实际传入的是 "" 空字符串,当空字符串给 Guid? 转换的时候就会产生这样的异常,当遇到这样的情况时,我们可以要求前端调整 JSON 格式如下
{
"name": "商务一部",
"parentId": null
}
前端只要给 parentId 的赋值从 "" 调整为 null 之后我们的接口就可以正常运行了,但是有的时候前端的组件这里取值可能是和一些组件库绑定的,不太方便绑定默认值为 null,很多情况下组件库组件的默认值都是 "" 空字符串的形式,所以经过和前端同事多次沟通之后想着从后端彻底解决这个问题,经过研究之后编写了下面的 NullableConverter 转换器,只要在项目启动的时候注册到 AddJsonOptions 其中即可。
using System.Text.Json;
using System.Text.Json.Serialization;
namespace Common.JsonConverter
{
public class NullableConverter<T> : JsonConverter<T?> where T : struct
{
public override T? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
{
if (reader.TokenType == JsonTokenType.String)
{
if (string.IsNullOrEmpty(reader.GetString()) || string.IsNullOrWhiteSpace(reader.GetString()))
{
return null;
}
}
return JsonSerializer.Deserialize<T>(ref reader, options);
}
public override void Write(Utf8JsonWriter writer, T? value, JsonSerializerOptions options)
{
JsonSerializer.Serialize(writer, value!.Value, options);
}
}
}
上面我们只是用 Guid? 举了一个例子,实际情况下
- DateTime?
- DateTimeOffset?
- long?
- int?
- double?
- decimal?
- float?
- Guid?
- bool?
都有可能存在这个问题,所以我们为这几种类型都配置了这个可为空类型转换器。这样前端在调用接口时配到这类型的字段,传 "" 和 null 我们后端就都可以接收了,收到之后字段的值都是 null
我这里项目采用的是微软的 System.Text.Json 处理的 Json 序列化,注册配置 NullableConverter 代码如下:
#region 注册 Json 序列化配置
builder.Services.AddControllers().AddJsonOptions(options =>
{
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<DateTime>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<DateTimeOffset>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<long>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<int>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<double>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<decimal>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<float>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<Guid>());
options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<bool>());
});
#endregion
至此 .NET WebAPI 自定义 NullableConverter 解决可为空类型字段入参“”空字符触发转换异常问题 就讲解完了,有任何不明白的,可以在文章下面评论或者私信我,欢迎大家积极的讨论交流,有兴趣的朋友可以关注我目前在维护的一个 .NET 基础框架项目,项目地址如下
https://github.com/dashiell-zhang/NetEngine.git
https://gitee.com/dashiell-zhang/NetEngine.git