74 lines
2.4 KiB
C#
74 lines
2.4 KiB
C#
|
using System;
|
|||
|
using System.IO;
|
|||
|
using System.Text.Encodings.Web;
|
|||
|
using System.Text.Json;
|
|||
|
using System.Threading.Tasks;
|
|||
|
|
|||
|
namespace ColdMint.scripts.serialization;
|
|||
|
|
|||
|
/// <summary>
|
|||
|
/// <para>JsonSerialization</para>
|
|||
|
/// <para>Json序列化工具</para>
|
|||
|
/// </summary>
|
|||
|
/// <remarks>
|
|||
|
///<para>This serializer is no longer recommended and Yaml is recommended instead of Json.</para>
|
|||
|
///<para>此序列化器已不再推荐使用,建议用Yaml代替Json。</para>
|
|||
|
/// </remarks>
|
|||
|
/// <seealso cref="YamlSerialization"/>
|
|||
|
[Obsolete("The Json serializer is out of date, we recommend yaml serialization.\nJson序列化器已过时了,我们推荐使用Yaml。", true)]
|
|||
|
public static class JsonSerialization
|
|||
|
{
|
|||
|
private static readonly JsonSerializerOptions Options = new()
|
|||
|
{
|
|||
|
//Case-insensitive attribute matching
|
|||
|
//不区分大小写的属性匹配
|
|||
|
PropertyNameCaseInsensitive = true,
|
|||
|
//Try to avoid escape
|
|||
|
//尽量避免转义
|
|||
|
Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
|
|||
|
//Enable smart Print
|
|||
|
//启用漂亮打印
|
|||
|
WriteIndented = true
|
|||
|
};
|
|||
|
|
|||
|
/// <summary>
|
|||
|
/// <para>Read a Json file to type T</para>
|
|||
|
/// <para>读取一个Json文件到T类型</para>
|
|||
|
/// </summary>
|
|||
|
/// <param name="path"></param>
|
|||
|
/// <typeparam name="T"></typeparam>
|
|||
|
/// <returns></returns>
|
|||
|
public static async Task<T?> ReadJsonFileToObj<T>(string path)
|
|||
|
{
|
|||
|
await using var openStream = File.OpenRead(path);
|
|||
|
return await JsonSerializer.DeserializeAsync<T>(openStream, Options);
|
|||
|
}
|
|||
|
|
|||
|
/// <summary>
|
|||
|
/// <para>Serialize the object to Json</para>
|
|||
|
/// <para>将对象序列化为Json</para>
|
|||
|
/// </summary>
|
|||
|
/// <param name="obj"></param>
|
|||
|
/// <returns></returns>
|
|||
|
public static string Serialize(object obj)
|
|||
|
{
|
|||
|
return JsonSerializer.Serialize(obj, Options);
|
|||
|
}
|
|||
|
|
|||
|
/// <summary>
|
|||
|
/// <para>Deserialize Json to an object</para>
|
|||
|
/// <para>将Json反序列化为对象</para>
|
|||
|
/// </summary>
|
|||
|
/// <param name="json"></param>
|
|||
|
/// <typeparam name="T"></typeparam>
|
|||
|
/// <returns></returns>
|
|||
|
public static T? Deserialize<T>(string json)
|
|||
|
{
|
|||
|
return JsonSerializer.Deserialize<T>(json, Options);
|
|||
|
}
|
|||
|
|
|||
|
public static async Task<T?> ReadJsonFileToObj<T>(Stream openStream)
|
|||
|
{
|
|||
|
return await JsonSerializer.DeserializeAsync<T>(openStream, Options);
|
|||
|
}
|
|||
|
}
|