ASP.NET Core Web API设置响应输出的Json数据格式的两种方式

前言

在ASP.NET Core Web API中设置响应输出Json数据格式有两种方式，可以通过添加System.Text.Json或Newtonsoft.JsonJSON序列化和反序列化库在应用程序中全局设置接口响应的Json数据格式，本文示例使用的是新的Minimal API模式。

JSON序列化和反序列化库

System.Text.Json

System.Text.Json是 .NET Core 3.0 及以上版本中内置的 JSON 序列化和反序列化库。

Newtonsoft.Json

Newtonsoft.Json是一个功能强大且灵活的.NET JSON序列化和反序列化库，用于在.NET应用程序中处理JSON数据。

设置Json统一格式需求

修改属性名称的序列化方式，在.Net Core中默认使用小驼峰序列化Json属性参数，前端想要使用与后端模型本身命名格式输出（如：UserName）。

日期类型默认格式化处理，设置为：yyyy-MM-dd HH:mm:ss。

未配置之前的API输出Json数据

UserInfoModel

    public class UserInfoModel{public DateTime DateTime { get; set; }public int NumberIndex { get; set; }public string UserName { get; set; }}

UserInfoControlle

    [ApiController][Route("[controller]")]public class UserInfoController : ControllerBase{private static readonly string[] NameList = new[] { "追逐时光者", "小明同学", "DotNetGuide", "小艺同学", "Edwin" };[HttpGet(Name = "GetUserInfo")]public IEnumerable<UserInfoModel> Get(){return Enumerable.Range(1, 5).Select(index => new UserInfoModel{DateTime = DateTime.Now.AddDays(index),NumberIndex = Random.Shared.Next(-20, 55),UserName = NameList[Random.Shared.Next(NameList.Length)]}).ToArray();}}

输出Json数据

System.Text.Json程序全局配置

添加自定义时间输出格式类(DateTimeJsonConverter)

    public class DateTimeJsonConverter : JsonConverter<DateTime>{public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options){return DateTime.Parse(reader.GetString());}public override void Write(Utf8JsonWriter writer, DateTime value, JsonSerializerOptions options){writer.WriteStringValue(value.ToString("yyyy-MM-dd HH:mm:ss"));}}

在Program.cs中全局配置

            builder.Services.AddControllers().AddJsonOptions(options =>{//命名规则，该值指定用于将对象上的属性名称转换为另一种格式(例如驼峰大小写)或为空以保持属性名称不变的策略[前端想要使用与后端模型本身命名格式输出]。options.JsonSerializerOptions.PropertyNamingPolicy = null;//自定义输出的时间格式options.JsonSerializerOptions.Converters.Add(new DateTimeJsonConverter());});

配置后输出的Json数据

Newtonsoft.Json程序全局配置

说明

在.NET 3.0及其以上的版本使用Newtonsoft.Json需要通过安装 Microsoft.AspNetCore.Mvc.NewtonsoftJson 包来进行配置（注意假如提示该包安装失败可以尝试安装其他版本的包）。

在Program.cs中全局配置

            builder.Services.AddControllers().AddNewtonsoftJson(options =>{//修改属性名称的序列化方式[前端想要使用与后端模型本身命名格式输出]options.SerializerSettings.ContractResolver = null;//方式1：日期类型默认格式化处理 options.SerializerSettings.Converters.Add(new IsoDateTimeConverter() { DateTimeFormat = "yyyy-MM-dd HH:mm:ss" });//方式2：日期类型默认格式化处理 //options.SerializerSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat;//options.SerializerSettings.DateFormatString = "yyyy-MM-dd HH:mm:ss";});