RestSharp 106升级至108：自定义序列化/反序列化替代方案求助

RestSharp 108彻底重构了序列化体系，移除了旧版本的[SerializeAs]和[DeserializeAs]类级特性，改用.NET原生序列化库（默认用System.Text.Json处理JSON，System.Xml.Serialization处理XML）。要同时支持JSON和XML的类级命名包裹，分场景处理如下：

1. XML序列化/反序列化 #

直接用.NET原生的[XmlRoot]特性替代旧特性，完美匹配原有XML格式：

响应类（对应原类A） #

using System.Xml.Serialization;

[XmlRoot("response")]
public class ACertainResponse
{
    public string SomeProp { get; set; }
    // 其他属性
}

请求类（对应原类B） #

using System.Xml.Serialization;

[XmlRoot("request")]
public class SomeRequest
{
    public string SomeProp { get; set; }
    // 其他属性
}

2. JSON序列化/反序列化 #

System.Text.Json无原生类级包裹特性，提供两种优雅实现方式：

方式一：使用包装类（推荐，简单直观） #

创建对应包裹名称的包装类，将原有类作为属性，用[JsonPropertyName]指定属性名：

响应类包装（匹配{"response": {...}}格式）

using System.Text.Json.Serialization;

public class ResponseWrapper
{
    [JsonPropertyName("response")]
    public ACertainResponse Response { get; set; }
}

反序列化时用ResponseWrapper替代ACertainResponse：

var response = await client.GetAsync<ResponseWrapper>(url);
var data = response.Data.Response; // 获取原ACertainResponse实例

请求类包装（匹配{"request": {...}}格式）

using System.Text.Json.Serialization;

public class RequestWrapper
{
    [JsonPropertyName("request")]
    public SomeRequest Request { get; set; }
}

序列化时传入RequestWrapper实例：

var request = new RequestWrapper { Request = new SomeRequest { SomeProp = "A Value" } };
var response = await client.PostJsonAsync(url, request);

方式二：自定义JSON转换器（适合不想写包装类的场景） #

实现JsonConverter手动处理类的包裹逻辑，以ACertainResponse为例：

using System.Text.Json;
using System.Text.Json.Serialization;

public class ACertainResponseConverter : JsonConverter<ACertainResponse>
{
    public override ACertainResponse Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        using var doc = JsonDocument.ParseValue(ref reader);
        var responseElement = doc.RootElement.GetProperty("response");
        return JsonSerializer.Deserialize<ACertainResponse>(responseElement.GetRawText(), options);
    }

    public override void Write(Utf8JsonWriter writer, ACertainResponse value, JsonSerializerOptions options)
    {
        writer.WriteStartObject();
        writer.WritePropertyName("response");
        JsonSerializer.Serialize(writer, value, options);
        writer.WriteEndObject();
    }
}

在RestSharp序列化配置中注册转换器：

var options = new JsonSerializerOptions();
options.Converters.Add(new ACertainResponseConverter());
var client = new RestClient("baseUrl", configureSerialization: s => s.UseSystemTextJson(options));

同时支持JSON和XML的统一处理 #

给类添加[XmlRoot]特性，配合JSON的包装类或转换器即可，RestSharp会根据请求头自动选择序列化方式。

内容的提问来源于stack exchange，提问作者Jon P