[Json.net]快速入门

引言

有个朋友问了一个如何更方便的解析json格式字符串，之前也没怎么研究过json.net，就上网帮他查了一下，现学现卖的给他整了一个demo，这才发现json.net的强大，用着很方便。

Json

JSON(javasrcipt Object Notation)是一种轻量级的数据交换方式。拿最常见的应用举个例子，将javascript对象中表示的一组数据转换为字符串，然后就可以在函数之间轻松的传递这个字符串，或者在异步应用程序中将字符串从web客户机传递给服务端程序。这个字符串虽然看起来比较古怪，但是javascript很容易解释它，而且json可以表示比“名称/值对”更复杂的结构。例如，可以表示数组和复杂的对象，而不仅仅是键和值的简单列表。

在.net中，DataContractJsonSerializer和JavaScriptSerializer这两个类，可以操作json。但性能上和json.net相比，差了很多。

可以借用官网的一张图看一下：

官网地址：http://james.newtonking.com/json

将下载的压缩文件解压，Source是源码文件夹，在bin目录下，Newtonsoft.Json.dll是编译后的程序集文件，在项目中应用该dll就行了。

Json.net

在项目中引用Newtonsoft.Json.dll。

首先从最简单的例子入手，序列化DataTable对象。

引入命名空间：

 using Newtonsoft.Json; 

测试代码：

 1 using Newtonsoft.Json;

 2 using System.Data;

 3 namespace Wolfy.JsonNetDemo

 4 {

 5     class Program

 6     {

 7         static void Main(string[] args)

 8         {

 9             DataTable dt = new DataTable();

10             DataColumn name = new DataColumn("Name");

11             DataColumn gender = new DataColumn("Gender");

12             DataColumn address = new DataColumn("Address");

13             dt.Columns.Add(name);

14             dt.Columns.Add(gender);

15             dt.Columns.Add(address);

16             for (int i = 0; i < 10; i++)

17             {

18                 DataRow dr = dt.NewRow();

19                 dr[0] = "Name" + i;

20                 dr[1] = i%2==0?"男":"女";

21                 dr[2] = "Address" + i;

22                 dt.Rows.Add(dr);

23             }

24             //序列化为json

25             string json = JsonConvert.SerializeObject(dt);

26             Console.WriteLine(json);

27             Console.Read();

28         }

29     }

30 }

结果：

反序列化为Datatable

1  DataTable dt1 = JsonConvert.DeserializeObject<DataTable>(json);

2             for (int i = 0; i < dt1.Rows.Count; i++)

3             {

4                 DataRow dr = dt1.Rows[i];

5                 Console.WriteLine("{0}\t{1}\t{2}\t", dr[0], dr[1], dr[2]);

6             }

控制

实现对Json.net序列化和反序列化的控制，需要JsonSerializerSettings类。

  1 var jsonSetting = new JsonSerializerSettings(); 2 string json=JsonConvert.SerializeObject(object,jsonSetting); 

新建一个测试类：

1     public class Employee

2     {

3         public string Name { get; set; }

4         public int Age { set; get; }

5         public string Gender { set; get; }

6         public string DepartmentName { set; get; }

7         public Employee Leader { set; get; }

8     }

空值处理

针对应用类型，如果为NULL时，json.net如何处理，可以通过 jsonSetting.NullValueHandling的值来控制。如：

1             var jsonSetting = new JsonSerializerSettings();

2             jsonSetting.NullValueHandling = NullValueHandling.Ignore;

3             jsonSetting.NullValueHandling = NullValueHandling.Include;

一个例子：

 1             Employee employee = new Employee();

 2             employee.Name = "Wolfy";

 3             employee.Gender = "男";

 4             employee.Age = 26;

 5             employee.DepartmentName = ".net开发";

 6             employee.Leader = null;

 7             var jsonSetting = new JsonSerializerSettings();

 8             jsonSetting.NullValueHandling = NullValueHandling.Ignore;

 9             string json = JsonConvert.SerializeObject(employee,jsonSetting);

10             Console.WriteLine(json);

11             Console.Read();

结果：

改为NullValueHandling.Include

结果：

默认值处理

对于值类型的处理，通过设置jsonSetting.DefaultValueHandling的值来确定。同样是枚举可取Ignore，Include等，如：

 1 namespace Newtonsoft.Json

 2 {

 3     [Flags]

 4     public enum DefaultValueHandling

 5     {

 6         Include = 0,

 7         Ignore = 1,

 8         Populate = 2,

 9         IgnoreAndPopulate = 3,

10     }

11 }

 jsonSetting.DefaultValueHandling = DefaultValueHandling.Ignore;//忽略默认值 

给Employee的成员使用特性   [DefaultValue(26)]设置默认值，并引入命名空间：System.ComponentModel

 1 [DefaultValue(26)] 2 public int Age { set; get; } 

忽略默认值：

 1             Employee employee = new Employee();

 2             employee.Name = "Wolfy";

 3             employee.Gender = "男";

 4             employee.Age = 26;

 5             employee.DepartmentName = ".net开发";

 6             employee.Leader = null;

 7             var jsonSetting = new JsonSerializerSettings();

 8             jsonSetting.NullValueHandling = NullValueHandling.Include;

 9             jsonSetting.DefaultValueHandling = DefaultValueHandling.Ignore;//忽略默认值

10             string json = JsonConvert.SerializeObject(employee,jsonSetting);

11             Console.WriteLine(json);

12             Console.Read();

结果：

 

属性控制

 Json.net序列化的两种方式：OptOut和OptIn

OptOut默认值，类中所有公共成员会被序列化，如果不想被序列化，可以使用特性JsonIgnore

OptIn默认情况下，所有的成员不会被序列化，类中的成员只有标有特性JsonProperty的才会被序列化，当类的成员很多，但客户端仅仅需要一部分时很有帮助。

 1 using Newtonsoft.Json;

 2 namespace Wolfy.JsonNetDemo

 3 {

 4     [JsonObject(Newtonsoft.Json.MemberSerialization.OptIn)]

 5     public class Employee

 6     {

 7         [JsonProperty]

 8         public string Name { get; set; }

 9         

10         public int Age { set; get; }

11         public string Gender { set; get; }

12         public string DepartmentName { set; get; }

13         public Employee Leader { set; get; }

14     }

15 }

序列化：

1             Employee employee = new Employee();

2             employee.Name = "Wolfy";

3             employee.Gender = "男";

4             employee.Age = 26;

5             employee.DepartmentName = ".net开发";

6             employee.Leader = null;

7             string json = JsonConvert.SerializeObject(employee);

8             Console.WriteLine(json);

结果：

 如果想忽略某个属性，比如忽略领导信息。则可以这样写：

 1 namespace Wolfy.JsonNetDemo

 2 {

 3     [JsonObject(Newtonsoft.Json.MemberSerialization.OptOut)]

 4     public class Employee

 5     {

 6         public string Name { get; set; }

 7         

 8         public int Age { set; get; }

 9         public string Gender { set; get; }

10         public string DepartmentName { set; get; }

11         [JsonIgnore]

12         public Employee Leader { set; get; }

13     }

14 }

 [JsonObject(Newtonsoft.Json.MemberSerialization.OptOut)]可以不写，已经默认

测试：

1             Employee employee = new Employee();

2             employee.Name = "Wolfy";

3             employee.Gender = "男";

4             employee.Age = 26;

5             employee.DepartmentName = ".net开发";

6             employee.Leader = new Employee() {Name = "老大",Gender = "男",Age = 29, DepartmentName = ".net开发"};

7             string json = JsonConvert.SerializeObject(employee);

8             Console.WriteLine(json);

结果：

不忽略结果对比：

非公共成员序列化

 Json.net序列化对象，默认只序列化公共成员，非公共成员序列互时，需加上 [JsonProperty]特性。

日期处理

两种日期格式：IsoDateTimeConverter和JavaScriptDateTimeConverter

这是json.net中带的2个日期类，默认是IsoDateTimeConverter，格式“yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK”。另一个是JavaScriptDateTimeConverter，格式“new Date(ticks)”，返回Javascript的Date对象。

一个例子

 1     public class Employee

 2     {

 3         public string Name { get; set; }

 4         public int Age { set; get; }

 5         public string Gender { set; get; }

 6         public string DepartmentName { set; get; }

 7         //[JsonIgnore]

 8         public Employee Leader { set; get; }

 9         public DateTime BirthDay { set; get; }

10         public DateTime EmployeDate { set; get; }

11     }

序列化为Javascript格式：

 1             Employee employee = new Employee();

 2             employee.Name = "Wolfy";

 3             employee.Gender = "男";

 4             employee.Age = 26;

 5             employee.DepartmentName = ".net开发";

 6             employee.Leader = new Employee() {Name = "老大",Gender = "男",Age = 29, DepartmentName = ".net开发"};

 7             employee.BirthDay = new DateTime(1987,3,22);

 8             employee.EmployeDate = new DateTime(2011,6,22);

 9             string json = JsonConvert.SerializeObject(employee,new JavaScriptDateTimeConverter());

10             Console.WriteLine(json);

序列化

如果想要不同的日期类型成员序列化后，以不同的形式显示。

则可以通过设置特性实现

 1     public class Employee

 2     {

 3         public string Name { get; set; }

 4         public int Age { set; get; }

 5         public string Gender { set; get; }

 6         public string DepartmentName { set; get; }

 7         //[JsonIgnore]

 8         public Employee Leader { set; get; }

 9         [JsonConverter(typeof(IsoDateTimeConverter))]

10         public DateTime BirthDay { set; get; }

11         [JsonConverter(typeof(JavaScriptDateTimeConverter))]

12         public DateTime EmployeDate { set; get; }

13     }

结果：

自定义日期格式：

1             IsoDateTimeConverter newFormatTime = new IsoDateTimeConverter() { DateTimeFormat="yyyy年MM月dd日"};

2             string json = JsonConvert.SerializeObject(employee, newFormatTime);

3             Console.WriteLine(json);

结果：

总结

json.net简单操作就介绍到这里，之后总结Linq to json的用法。

参考

http://james.newtonking.com/json

http://www.360doc.com/content/13/0328/22/11741424_274568478.shtml