【C】KoobooJson在asp.net core中的使用

“KoobooJson是一款体积小巧没有任何依赖且性能表现强劲的Json工具”

详细介绍可以参考官方说明，项目地址：https://github.com/Kooboo/Json

ps：楼主目前使用的版本是：asp.net core 2.2

在 asp.net core 2.x 中，默认使用的json序列化工具是 Newtonsoft.Json ,如果你正在使用 asp.net core mvc/webapi ，并且需要对 Json 序列化进行一些配置（例如首字母大小写，日期格式化等），那么你可能在 Startup.cs 中看到过此方法（AddJsonOptions）的应用：

public void ConfigureServices(IServiceCollection services)
{   services    .AddMvc()   .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)  .AddJsonOptions(opts => {   //忽略循环引用    opts.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;  //不使用驼峰样式的key   opts.SerializerSettings.ContractResolver = new DefaultContractResolver();  //设置时间格式    opts.SerializerSettings.DateFormatString = "yyyy-MM-dd HH:mm:ss";    });
}

通过配置以后，返回对象可以被直接序列化成你想要的 json 格式。

那么，使用 KoobooJson 的时候，是否也可以像这样直接通过调用某个方法就进行使用和配置呢？

看了下官方的说明还未支持 web , 请教了作者以后，自己撸了个方法吧。原理是将 Input 和 Output 的格式化方式替换成自己想要的。废话不多说，上代码：

1.使用nuget添加：Kooboo.Json

2.定义输入的序列化类

public class KoobooInputFormatter : IInputFormatter
{   protected Kooboo.Json.JsonDeserializeOption Options { get; set; } = new Kooboo.Json.JsonDeserializeOption()    {       JsonCharacterReadState = Kooboo.Json.JsonCharacterReadStateEnum.IgnoreCase };  public KoobooInputFormatter(): this(null){ }    public KoobooInputFormatter(Kooboo.Json.JsonDeserializeOption options)  {   Options = options ?? Options;  }   public bool CanRead(InputFormatterContext context)  {   return true;    }   public async Task<InputFormatterResult> ReadAsync(InputFormatterContext context)  {   if (context == null)  {   throw new ArgumentNullException(nameof(context));   }   var request = context.HttpContext.Request; string json;    using (var reader = context.ReaderFactory(request.Body, Encoding.UTF8))    {   json = await reader.ReadToEndAsync();  }   var result = Kooboo.Json.JsonSerializer.ToObject(json, context.ModelType, Options);    return await InputFormatterResult.SuccessAsync(result); }
}

3.定义输出的序列化类

public class KoobooOutputFormatter : IOutputFormatter   {   protected const string CONTENT_TYPE = "application/json";    protected virtual Kooboo.Json.JsonSerializerOption Options { get; set; } = new Kooboo.Json.JsonSerializerOption()  {   DatetimeFormat = Kooboo.Json.DatetimeFormatEnum.ISO8601,   IsEnumNum = true,  JsonCharacterRead = Kooboo.Json.JsonCharacterReadStateEnum.InitialLower,   IsIgnoreValueNull = false, ReferenceLoopHandling = Kooboo.Json.JsonReferenceHandlingEnum.Remove   };  public KoobooOutputFormatter()  : this(null)    { } public KoobooOutputFormatter(Kooboo.Json.JsonSerializerOption options)  {   Options = options ?? Options;  }   public bool CanWriteResult(OutputFormatterCanWriteContext context)  {   return true;    }   public Task WriteAsync(OutputFormatterWriteContext context) {   if (context == null)  {   throw new ArgumentNullException(nameof(context));   }   var response = context.HttpContext.Response;   response.ContentType = CONTENT_TYPE;   if (context.Object == null)   {   response.Body.WriteByte(192); //192 好像在 Response.Body 中表示 null  return Task.CompletedTask;  }   using (var writer = new StreamWriter(response.Body, Encoding.UTF8))    {   Kooboo.Json.JsonSerializer.ToJson(context.Object, writer, Options); return Task.CompletedTask;  }   }   }

4.扩展MvcOptions

public static class KoobooMvcOptionsExtension    {   public static void UseKoobooFormatters(this MvcOptions opts, Action<Kooboo.Json.JsonDeserializeOption, Kooboo.Json.JsonSerializerOption> jsonOptionAction = null)    {   Kooboo.Json.JsonDeserializeOption deserializeOption = null;    Kooboo.Json.JsonSerializerOption serializerOption = null;  if (jsonOptionAction != null)  {   deserializeOption = new Kooboo.Json.JsonDeserializeOption();   serializerOption = new Kooboo.Json.JsonSerializerOption(); jsonOptionAction(deserializeOption, serializerOption);  }   opts.InputFormatters.Clear();   opts.InputFormatters.Add(new KoobooInputFormatter(deserializeOption));  opts.OutputFormatters.Clear();  opts.OutputFormatters.Add(new KoobooOutputFormatter(serializerOption)); }   }

5.最终使用

public void ConfigureServices(IServiceCollection services)
{   services.AddMvc()   .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)  .AddMvcOptions(opts =>  {   opts.UseKoobooFormatters((deserializeOption, serializerOption) =>   {   //你可以在这里对反序列化/序列化进行配置   deserializeOption = null;//反序列化对象设置为null，则使用默认的设置   serializerOption.IsEnumNum = false;//枚举不转换为数字  serializerOption.IsIgnoreValueNull = true;//忽略值为null的字段    serializerOption.JsonCharacterRead = Kooboo.Json.JsonCharacterReadStateEnum.InitialLower;//首字母小写   }); });
}

如果你只需要使用默认的配置。你可以直接这样 opts.UseKoobooFormatters();

至此，已经可以在项目中使用了，效果如下：

demo 下载,百度网盘：

下载地址:https://pan.baidu.com/s/1O-OBn2hYcQFhDXQRc7-Wvg

提取码:a4pw

-----------------------------分割线-------------------------------

以下是一些常用的特性（忽略字段，仅包含某字段，字段排序等）

    /// <summary>   /// IgnoreDefaultValue（忽略此类中所有字段为默认值的元素）  /// </summary>    [Kooboo.Json.IgnoreDefaultValue]    public class StudentModel   {   /// <summary> /// Alias（字段别名）   /// JsonOrder（字段排序）   /// </summary>    [Kooboo.Json.Alias("Name")]   [Kooboo.Json.JsonOrder(3)]  public string FullName { get; set; }    /// <summary> /// IgnoreKey（忽略某字段）  /// </summary>    [Kooboo.Json.IgnoreKey] public string Address { get; set; } [Kooboo.Json.JsonOrder(2)]  public byte Age { get; set; }   [Kooboo.Json.JsonOrder(4)]  public DateTime Dirthday { get; set; }  [Kooboo.Json.JsonOrder(1)]  public EnumGender Gender { get; set; }  [Kooboo.Json.JsonOrder(5)]  public string Mobile { get; set; }  /// <summary> /// Base64ValueFormat（这个是自定义的值格式化特性）  /// </summary>    [Base64ValueFormat] public byte[] Avatar { get; set; }  }

如果你需要对值的格式化进行个性设置，例如：你不管，我就需要这种时间格式：ffff.yyyy-MM-dd:HH-mm-ss 或者上一段代码中类型为 byte[] 的 Avatar 属性，可以使用：值格式化特性来实现。

    /// <summary>    /// 可以自定义一个值格式化特性   /// </summary>    public class Base64ValueFormatAttribute : Kooboo.Json.ValueFormatAttribute  {   public override string WriteValueFormat(object value, Type type, Kooboo.Json.JsonSerializerHandler handler, out bool isValueFormat) {   isValueFormat = true;  if (value == null)    return string.Empty;    else    return Convert.ToBase64String((byte[])value);   }   public override object ReadValueFormat(string value, Type type, Kooboo.Json.JsonDeserializeHandler handler, out bool isValueFormat) {   isValueFormat = true;  if (string.IsNullOrWhiteSpace(value) || value == "null")    return null;    else    return Convert.FromBase64String(value); }   }

如果你想将这个自定义的格式化方式运用于全局，你可以在第5步的 UseKoobooFormatters 中，通过设置 serializerOption.GlobalValueFormat 和 deserializeOption.GlobalValueFormat 来实现

public void ConfigureServices(IServiceCollection services)
{   services.AddMvc()   .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)  .AddMvcOptions(opts =>  {   opts.UseKoobooFormatters((deserializeOption, serializerOption) =>   {   //你可以在这里对反序列化/序列化进行配置   serializerOption.IsEnumNum = true;//枚举转换为数字    serializerOption.IsIgnoreValueNull = true;//忽略值为null的字段    serializerOption.JsonCharacterRead = Kooboo.Json.JsonCharacterReadStateEnum.InitialLower;//首字母小写   serializerOption.GlobalValueFormat = KoobooGlobalValueFormat.Base64Serializer;//设置全局的对于byte[]类型的自定义序列化方式   deserializeOption.GlobalValueFormat = KoobooGlobalValueFormat.Base64Deserializer;//设置全局的对于byte[]类型的自定义反序列化方式   }); }); }   public static class KoobooGlobalValueFormat {   public static string Base64Serializer(object value, Type type, Kooboo.Json.JsonSerializerHandler jsonSerializeHandler, out bool isValueFormat)  {   if (type == typeof(byte[]))   {   isValueFormat = true;  if (value == null)    return string.Empty;    else    return Convert.ToBase64String((byte[])value);   }   else    {   isValueFormat = false; return null;    }   }   public static object Base64Deserializer(string value, Type type, Kooboo.Json.JsonDeserializeHandler jsonDeserializeHandler, out bool isValueFormat) {   if (type == typeof(byte[]))   {   isValueFormat = true;  if (string.IsNullOrWhiteSpace(value) || value == "null")    return null;    else    return Convert.FromBase64String(value); }   else    {   isValueFormat = false; return null;    }   }   }

值得注意的是,对于byte[]类型的base64解析行为, KoobooJson已经内嵌在配置项中, 只要设置serializerOption.IsByteArrayFormatBase64 = true 即可

public void ConfigureServices(IServiceCollection services)    {   services.AddMvc()   .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)  .AddMvcOptions(opts =>  {   opts.UseKoobooFormatters((deserializeOption, serializerOption) =>   {   //你可以在这里对反序列化/序列化进行配置   serializerOption.IsEnumNum = true;//枚举转换为数字    serializerOption.IsIgnoreValueNull = true;//忽略值为null的字段    serializerOption.JsonCharacterRead = Kooboo.Json.JsonCharacterReadStateEnum.InitialLower;//首字母小写   serializerOption.IsByteArrayFormatBase64 = true;//使用KoobooJson自带的对于byte[]类型的base64处理   //serializerOption.GlobalValueFormat = KoobooGlobalValueFormat.Base64Serializer;//设置全局的对于byte[]类型的自定义序列化方式 //deserializeOption.GlobalValueFormat = KoobooGlobalValueFormat.Base64Deserializer;//设置全局的对于byte[]类型的自定义反序列化方式 }); }); }

参考资料：

1.Asp.Net Core中Json序列化处理整理

2.将 .NET Core 2.0 的默认 JSON 解析器替换为 Jil

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

原文链接：https://blog.csdn.net/j_teng/article/details/100924973

https://github.com/dotnetcore

【C】KoobooJson在asp.net core中的使用相关推荐

KoobooJson在asp.net core中的使用
"KoobooJson是一款体积小巧没有任何依赖且性能表现强劲的Json工具" 详细介绍可以参考官方说明,项目地址:https://github.com/Kooboo/Json ...
如何使用C＃在ASP.NET Core中轻松实现QRCoder
by Yogi 由瑜伽士如何使用C#在ASP.NET Core中轻松实现QRCoder (How to easily implement QRCoder in ASP.NET Core using ...
asp.net core中IHttpContextAccessor和HttpContextAccessor的妙用
分享一篇文章,关于asp.net core中httpcontext的拓展. 现在,试图围绕HttpContext.Current构建你的代码真的不是一个好主意,但是我想如果你正在迁移一个企业类型的应用 ...
在asp.net core中使用托管服务实现后台任务
在业务场景中经常需要后台服务不停的或定时处理一些任务,这些任务是不需要及时响应请求的. 在 asp.net中会使用windows服务来处理. 在 asp.net core中,可以使用托管服务来实现,托 ...
ASP.NET Core中显示自定义错误页面-增强版
之前的博文 ASP.NET Core中显示自定义错误页面中的方法是在项目中硬编码实现的,当有多个项目时,就会造成不同项目之间的重复代码,不可取. 在这篇博文中改用middleware实现,并且放在独 ...
探索ASP.NET Core中的IStartupFilter
原文:Exploring IStartupFilter in ASP.NET Core 作者:Andrew Lock 译者:Lamond Lu 在本篇博客中,我将介绍一下IStartupFilter, ...
如何简单的在 ASP.NET Core 中集成 JWT 认证？
前情提要:ASP.NET Core 使用 JWT 搭建分布式无状态身份验证系统文章超长预警(1万字以上),不想看全部实现过程的同学可以直接跳转到末尾查看成果或者一键安装相关的 nuget 包自上一 ...
在 ASP.NET Core 中集成 Skywalking APM
前言大家好,今天给大家介绍一下如何在 ASP.NET Core 项目中集成 Skywalking,Skywalking 是 Apache 基金会下面的一个开源 APM 项目,有些同学可能会 APM ...
.ASP NET Core中缓存问题案例
本篇博客中,我将描述一个关于会话状态(Session State)的问题, 这个问题我已经被询问了好几次了. 问题的场景创建一个新的ASP.NET Core应用程序一个用户在会话状态中设置了一个字 ...

【C】KoobooJson在asp.net core中的使用

【C】KoobooJson在asp.net core中的使用相关推荐

最新文章

热门文章