.NET中反序列化SuccessFactors OData v2 API返回对象的解决方案

OData v2协议默认响应格式为Atom XML，你当前的请求未指定Accept请求头，服务端按默认规则返回了XML格式内容，而非你预期的JSON。

不能直接实现。JsonConverter是Newtonsoft.Json提供的JSON格式专属扩展，只能处理JSON结构输入，无法直接解析你拿到的XML格式响应。
如果先调整请求让接口返回JSON格式，完全可以用轻量方案实现映射，不需要自定义JsonConverter，也不需要完整定义接口返回的嵌套结构：

1. 先给HttpClient加上JSON格式接受头，强制服务端返回JSON：

   client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
   

2. OData v2的JSON响应固定用d节点作为业务数据的根包装，单实体查询时业务字段直接挂在d节点下，列表查询时d节点下的results数组存数据。你只需要定义一个通用泛型包装类即可完成映射：

   public class ODataSingleResult<T>
   {
       [JsonProperty("d")]
       public T Data { get; set; }
   }
   

3. 反序列化时直接调用：

   var result = JsonConvert.DeserializeObject<ODataSingleResult<User>>(json);
   var user = result.Data;
   

   你的User类不需要做任何修改，Newtonsoft会自动按驼峰/帕斯卡命名规则匹配firstName到FirstName、lastName到LastName的映射。

如果你坚持要处理返回的Atom XML格式，不需要绕到JSON序列化，直接用LINQ to XML读取节点映射即可，代码量更小：

var doc = XDocument.Parse(xmlResponse);
XNamespace dNs = "http://schemas.microsoft.com/ado/2007/08/dataservices";
XNamespace mNs = "http://schemas.microsoft.com/ado/2007/08/dataservices/metadata";
var propNode = doc.Descendants(mNs + "properties").First();
var user = new User
{
    FirstName = (string)propNode.Element(dNs + "firstName"),
    LastName = (string)propNode.Element(dNs + "lastName")
};

有三类成熟方案可选，都不需要自己处理格式解析、查询参数拼接的细节：

• 零依赖轻量方案：继续用HttpClient，搭配上面提到的通用包装类/LINQ to XML逻辑，只需要补全Accept头，代码改动量最小，适合只有少量OData接口调用的场景。
• 官方OData客户端：引用Microsoft.OData.Client类库，这是微软为OData协议提供的原生客户端，支持v2/v4版本，自动处理XML/JSON格式切换、认证、查询构造、字段映射，你可以直接用生成工具根据OData元数据生成实体类，也可以直接给你现有的User类加映射特性，连$filter、$select这类查询参数都可以用LINQ语法写，完全避免手写字符串出错的问题，对SuccessFactors的适配性经过大量生产项目验证。
• 轻量第三方OData客户端：如果觉得官方客户端太重，可以用Simple.OData.Client，封装更简洁，支持动态查询，不需要提前生成实体类，小场景下开发效率更高。

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