serein-flow/Serein.Extend.NewtonsoftJson/NewtonsoftJsonProvider.cs

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using Newtonsoft.Json.Serialization;
using Serein.Library.Api;
using System.Diagnostics.CodeAnalysis;

namespace Serein.Extend.NewtonsoftJson
{

    /// <summary>
    /// 基于Newtonsoft.Json的IJsonProvider实现
    /// </summary>
    public sealed class NewtonsoftJsonProvider : IJsonProvider
    {
        private JsonSerializerSettings? settings;

        /// <summary>
        ///  基于Newtonsoft.Json的JSON门户实现，默认首字母小写、忽略null
        /// </summary>
        public NewtonsoftJsonProvider()
        {
            settings = new JsonSerializerSettings
            {
                ContractResolver = new CamelCasePropertyNamesContractResolver(), // 控制首字母小写
                NullValueHandling = NullValueHandling.Ignore                     // 可选：忽略 null
            };
        }

        /// <summary>
        /// 使用自定义的序列化设置
        /// </summary>
        /// <param name="settings"></param>
        public NewtonsoftJsonProvider(JsonSerializerSettings settings)
        {
            this.settings = settings;
        }

        /// <summary>
        /// 反序列化JSON文本为指定类型的对象。
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="jsonText"></param>
        /// <returns></returns>
        public T? Deserialize<T>(string jsonText)
        {
            return JsonConvert.DeserializeObject<T>(jsonText, settings);
        }

        /// <summary>
        /// 反序列化JSON文本为指定类型的对象。
        /// </summary>
        /// <param name="jsonText"></param>
        /// <param name="type"></param>
        /// <returns></returns>
        public object? Deserialize(string jsonText, Type type)
        {
            return JsonConvert.DeserializeObject(jsonText, type, settings);
        }

        /// <summary>
        /// 序列化对象为JSON文本。
        /// </summary>
        /// <param name="obj"></param>
        /// <returns></returns>
        public string Serialize(object obj)
        {
            return JsonConvert.SerializeObject(obj, settings);
        }

        /// <summary>
        /// 将JSON文本解析为IJsonToken对象。
        /// </summary>
        /// <param name="json"></param>
        /// <returns></returns>

        public IJsonToken Parse(string json)
        {
            return NewtonsoftJsonTokenFactory.Parse(json);
        }

        /// <summary>
        /// 尝试解析JSON文本为IJsonToken对象，如果成功则返回true，并通过out参数返回解析后的对象。
        /// </summary>
        /// <param name="json"></param>
        /// <param name="jsonToken"></param>
        /// <returns></returns>
        public bool TryParse(string json, [NotNullWhen(true)] out IJsonToken? jsonToken)
        { 
            try
            {
                jsonToken = NewtonsoftJsonTokenFactory.Parse(json);
                return true;
            }
            catch (Exception)
            {
                jsonToken = null!;
                return false;
            }
        }

        /// <summary>
        /// 创建一个新的JSON数组对象。
        /// </summary>
        /// <param name="values"></param>
        /// <returns></returns>
        public IJsonToken CreateObject(IDictionary<string, object>? values = null)
        {
            var jobj = values != null ? JObject.FromObject(values) : new JObject();
            return new NewtonsoftJsonObjectToken(jobj);
        }

        /// <summary>
        /// 创建一个新的JSON数组。
        /// </summary>
        /// <param name="values"></param>
        /// <returns></returns>

        public IJsonToken CreateArray(IEnumerable<object>? values = null)
        {
            var jarr = values != null ? JArray.FromObject(values) : new JArray();
            return new NewtonsoftJsonArrayToken(jarr);
        }

        /// <summary>
        /// 将对象转换为IJsonToken。
        /// </summary>
        /// <param name="obj"></param>
        /// <returns></returns>
        public IJsonToken FromObject(object obj)
        {
            var token = JObject.FromObject(obj);
            return new NewtonsoftJsonObjectToken(token);
        }
    }
}