一:背景

1. 讲故事

前段时间和一家公司联调api接口的时候,发现一个奇葩的问题,它的api返回的json会动态改变,简化如下:


{"Code":101,"Items":[{"OrderTitle":"订单1"}]}

{"Code":102,"Items":[{"ProductTitle":"商品1"}]}

逻辑是这样的: Items 中的内容会随的 Code 的改变而改变,里面有可能是订单列表又有可能是商品列表,习惯弱类型的朋友看这种json太正常不过了,但对于强类型的我们来说,简直就是一个大写的奇葩,你这让我用什么强类型反序列化呢???,如果还没理解,请看下面的这张图吧!

api接口返回动态的json格式?我太难了,尝试一下 linq to json_jar

经过沟通,对方果然用的是弱类型的php,磨了半天,说服让对方改了返回结构,这样就可以直接用固有类匹配。

二:寻找解决办法

从业务上来说,能说服对方让步那是最好的,但从技术上来说,这种场景有什么好的解决办法呢? 问题的本质就是json是动态的,你反序列化的时候无法指定匹配类。

1. 使用 dynamic

既然是动态的,那C#中也有一个动态类型 dynamic,何不用它来做json中动态变化的那部分的接受值,将 items 定义为 dynamic。如下图:

api接口返回动态的json格式?我太难了,尝试一下 linq to json_C#_02

从图中看: rsp.Items as List<OrderItem> 返回是null,尝试失败,虽然转化失败了,但我相信你也看到了 Newtonsoft.Json.Linq.JArray,貌似这玩意可以用 linq 操控,对的, 这就是 linq to json

2. 使用 linq to json

有了linq基础,提取JArray中内容就不难了,接下来把代码改成如下:


        static void Main(string[] args)
        {
            var json = "{\"Code\":101,\"Items\":[{\"OrderTitle\":\"订单1\"}]}";

            var rsp = JsonConvert.DeserializeObject<ApiResponse>(json);

            if (rsp.Code == 101)
            {
                var items = (rsp.Items as JArray).Select(m => m["OrderTitle"].Value<string>()).ToList();

                Console.WriteLine(string.Join(",", items));
            }

            if (rsp.Code == 102)
            {
                //todo ....
            }
        }

api接口返回动态的json格式?我太难了,尝试一下 linq to json_强类型_03

从代码中可以看到,我是通过code的不同做了不同的业务逻辑处理,貌似问题通过这种半自动化的model实现了,但拥有强大好奇心的你,岂能不往下挖?

三: linq to json 分析

1. 好处

我觉得 linq to json 的最大好处就是绕过了强类型限制,可以像弱类型语言一样处理生成和读取json,给了我们在业务处理上更多的选择余地,接下来我就在Create和Query上给大家抛砖引玉吧。

2. 生成json

在没有强类型的情况下,如何构建json结构呢? 对了,不知道大家对 linq to xml 还有熟悉的吗? 还记得它是怎么一步一步构建的哈,如果你记得的话,这里也是差不多的构建方式,比如说刚才的 JArray。


            JObject json = new JObject(
                                       new JProperty("Code", 101),
                                       new JProperty("Items", new JArray(new JObject()
                                       {
                                           new JProperty("OrderTitle","订单1"),
                                           new JProperty("Created",DateTime.Now)
                                       }))
                                      );

            Console.WriteLine(json.ToString());

api接口返回动态的json格式?我太难了,尝试一下 linq to json_json_04

从图中看这种手工构建json的方式还是比较繁琐的,走的就是 linq to xml 的路子,有没有更简单的方式呢? 我觉得这里你可以用 C# 中的一个语法糖:匿名类型,虽然从 IL 上看也是强类型,但在用在这里太合适了,接下来我来改造一下:


            JObject json = JObject.FromObject(new
            {
                Code = 101,
                Items = (new[]
                {
                    new { OrderTitle="订单1",Created=DateTime.Now }
                }).ToList()
            });

            Console.WriteLine(json.ToString());

api接口返回动态的json格式?我太难了,尝试一下 linq to json_json_05

这样是不是太方便了,算是巧用 匿名类型 吧。

2. 解析json

为了让结果更可观,我准备生成一个稍微复杂一点的json,然后通过 linq to jsonjsonpath 两种方式操控json。


{
    "store":{
        "book":[
            {
                "category":"reference",
                "author":"Nigel Rees",
                "title":"Sayings of the Century",
                "price":8.95
            },
            {
                "category":"fiction",
                "author":"Evelyn Waugh",
                "title":"Sword of Honour",
                "price":12.99
            },
            {
                "category":"fiction",
                "author":"Herman Melville",
                "title":"Moby Dick",
                "isbn":"0-553-21311-3",
                "price":8.99
            },
            {
                "category":"fiction",
                "author":"J. R. R. Tolkien",
                "title":"The Lord of the Rings",
                "isbn":"0-395-19395-8",
                "price":22.99
            }
        ],
        "bicycle":{
            "color":"red",
            "price":19.95
        }
    }
}

  • 对 category 进行分组,统计每个类别的总金额

        static void Main(string[] args)
        {
            var json = System.IO.File.ReadAllText("1.txt");

            JObject obj = JObject.Parse(json);

            var dict = obj["store"]["book"].GroupBy(m => m["category"])
                                            .ToDictionary(k => k.Key,
                                                          v => v.Select(n => n.Value<decimal>("price")).Sum());

            foreach (var key in dict.Keys)
            {
                Console.WriteLine($"key={key},value={dict[key]}");
            }
        }

api接口返回动态的json格式?我太难了,尝试一下 linq to json_json_06

哈哈,分组统计在强大的linq面前就是这么简单!

  • 使用 jsonpath 处理

jsonpath 就像 xmlpath 一样,非常强大,更多的功能可以参考这个网页: https://goessner.net/articles/JsonPath/。

api接口返回动态的json格式?我太难了,尝试一下 linq to json_jar_07

根据上面的语法,我尝试着提取所有的price,使用 $..price 试试。


            var json = System.IO.File.ReadAllText("1.txt");

            JObject obj = JObject.Parse(json);

            var priceList= obj.SelectTokens("$..price");

            foreach (var price in priceList)
            {
                Console.WriteLine(price.Value<decimal>());
            }

api接口返回动态的json格式?我太难了,尝试一下 linq to json_强类型_08

四: 总结

我相信大家在90%的情况都是用强类型作为json的mapping,剩下的10%情况,可以了解下强大的 linq to json哈,太实用啦! 希望本篇对您有帮助。

如您有更多问题与我互动,扫描下方进来吧~

api接口返回动态的json格式?我太难了,尝试一下 linq to json_json_09