一、Newtonsoft.Json介绍
做 Web 开发的，没有接触过 JavaScript 的肯定很少，做前端开发，没有接触过Ajax的估计更不多了。现在的系统大多数是分布式系统，分布式系统就会涉及到数据的传输，JSON在数据传输和提交方面有着天生的优势。当我们使用Json的时候，很多时候会涉及到几个序列化对象的使用：DataContractJsonSerializer,JavaScriptSerializer 和 Json.NET即 Newtonsoft.Json。大多数人都会选择性能以及通用性较好 Json.NET，这个不是微软的类库，是一个开源的Json操作类库，速度比 DataContractJsonSerializer 快 50%，比 JavaScriptSerializer 快 250%，从下面的性能对比就可以看到它的其中之一的性能优点。
它的确很快，使用也很简单，它支持序列化的对象也很多，我刚开始以为只是支持 以实体类为基础的序列化，其实还有很多，比如，数据表（DataTable），数据集（DataSet）等，你了解越深就越喜欢它，也避免你在不知的情况下“重复造轮子”。
二、基本用法
Json.Net是支持序列化和反序列化DataTable,DataSet,Entity Framework和Entity的。下面分别举例说明序列化和反序列化。
DataTable：
1 //序列化DataTable
2 DataTable dt = new DataTable();
3 dt.Columns.Add("Age", Type.GetType("System.Int32"));
4 dt.Columns.Add("Name", Type.GetType("System.String"));
5 dt.Columns.Add("Sex", Type.GetType("System.String"));
6 dt.Columns.Add("IsMarry", Type.GetType("System.Boolean"));
7 for (int i = 0; i < 4; i++)
8 {
9 DataRow dr = dt.NewRow();
10 dr["Age"] = i + 1;
11 dr["Name"] = "Name" + i;
12 dr["Sex"] = i % 2 == 0 ? "男" : "女";
13 dr["IsMarry"] = i % 2 > 0 ? true : false;
14 dt.Rows.Add(dr);
15 }
16 Console.WriteLine(JsonConvert.SerializeObject(dt));
利用上面字符串进行反序列化
1 string json = JsonConvert.SerializeObject(dt);
2 dt=JsonConvert.DeserializeObject<DataTable>(json);
3 foreach (DataRow dr in dt.Rows)
4 {
5 Console.WriteLine("{0}\t{1}\t{2}\t{3}\t", dr[0], dr[1], dr[2], dr[3]);
6 }
Entity序列化和DataTable一样，就不过多介绍了。
三、高级用法
1.忽略某些属性
2.默认值的处理
3.空值的处理
4.支持非公共成员
5.日期处理
6.自定义序列化的字段名称
7.动态决定属性是否序列化
8.枚举值的自定义格式化问题
9.自定义类型转换
10.全局序列化设置
1.忽略某些属性
我们在序列化的过程中，并不是所有属性都需要序列化的，如果实体中有些属性不需要序列化，可以使用该特性。首先介绍Json.Net序列化的模式:OptOut 和 OptIn
| OptOut | 默认值,类中所有公有成员会被序列化,如果不想被序列化,可以用特性JsonIgnore |
| OptIn | 默认情况下,所有的成员不会被序列化,类中的成员只有标有特性JsonProperty的才会被序列化,当类的成员很多,但客户端仅仅需要一部分数据时,很有用 |
仅需要姓名属性
1 [JsonObject(MemberSerialization.OptIn)]
2 public class Person
3 {
4 public int Age { get; set; }
5
6 [JsonProperty]
7 public string Name { get; set; }
8
9 public string Sex { get; set; }
10
11 public bool IsMarry { get; set; }
12
13 public DateTime Birthday { get; set; }
14 }
不需要是否结婚属性
1 [JsonObject(MemberSerialization.OptOut)]
2 public class Person
3 {
4 public int Age { get; set; }
5
6 public string Name { get; set; }
7
8 public string Sex { get; set; }
9
10 [JsonIgnore]
11 public bool IsMarry { get; set; }
12
13 public DateTime Birthday { get; set; }
14 }
通过上面的例子可以看到，要实现不返回某些属性的需求很简单。1.在实体类上加上[JsonObject(MemberSerialization.OptOut)] 2.在不需要返回的属性上加上 [JsonIgnore]说明。
2.默认值处理
序列化时想忽略默认值属性可以通过JsonSerializerSettings.DefaultValueHandling来确定，该值为枚举值
|
序列化和反序列化时,忽略默认值 |
|
序列化和反序列化时,包含默认值 |
[DefaultValue(10)]
public int Age { get; set; } Person p = new Person { Age = 10, Name = "张三丰", Sex = "男", IsMarry = false, Birthday = new DateTime(1991, 1, 2) };
JsonSerializerSettings jsetting=new JsonSerializerSettings();
jsetting.DefaultValueHandling=DefaultValueHandling.Ignore;
Console.WriteLine(JsonConvert.SerializeObject(p, Formatting.Indented, jsetting));最终结果如下：
3.空值的处理
序列化时需要忽略值为NULL的属性，可以通过JsonSerializerSettings.NullValueHandling来确定，另外通过JsonSerializerSettings设置属性是对序列化过程中所有属性生效的，想单独对某一个属性生效可以使用JsonProperty，下面将分别展示两个方式
1）.JsonSerializerSettings
Person p = new Person { room=null,Age = 10, Name = "张三丰", Sex = "男", IsMarry = false, Birthday = new DateTime(1991, 1, 2) };
JsonSerializerSettings jsetting=new JsonSerializerSettings();
jsetting.NullValueHandling = NullValueHandling.Ignore;
Console.WriteLine(JsonConvert.SerializeObject(p, Formatting.Indented, jsetting));
2）.JsonProperty
通过JsonProperty属性设置的方法，可以实现某一属性特别处理的需求，如默认值处理，空值处理，自定义属性名处理，格式化处理。上面空值处理实现
[JsonProperty(NullValueHandling=NullValueHandling.Ignore)]
public Room room { get; set; }
4.支持非公共成员
序列化时默认都是处理公共成员，如果需要处理非公共成员，就要在该成员上加特性”JsonProperty”
[JsonProperty]
private int Height { get; set; }
5.日期处理
对于Dateime类型日期的格式化就比较麻烦了，系统自带的会格式化成iso日期标准，但是实际使用过程中大多数使用的可能是yyyy-MM-dd 或者yyyy-MM-dd HH:mm:ss两种格式的日期，解决办法是可以将DateTime类型改成string类型自己格式化好，然后在序列化。如果不想修改代码，可以采用下面方案实现。
Json.Net提供了IsoDateTimeConverter日期转换这个类，可以通过JsnConverter实现相应的日期转换
[JsonConverter(typeof(IsoDateTimeConverter))]
public DateTime Birthday { get; set; }但是IsoDateTimeConverter日期格式不是我们想要的，我们可以继承该类实现自己的日期
1 public class ChinaDateTimeConverter : DateTimeConverterBase
2 {
3 private static IsoDateTimeConverter dtConverter = new IsoDateTimeConverter { DateTimeFormat = "yyyy-MM-dd" };
4
5 public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
6 {
7 return dtConverter.ReadJson(reader, objectType, existingValue, serializer);
8 }
9
10 public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
11 {
12 dtConverter.WriteJson(writer, value, serializer);
13 }
14 }
自己实现了一个yyyy-MM-dd格式化转换类，可以看到只是初始化IsoDateTimeConverter时给的日期格式为yyyy-MM-dd即可，下面看下效果
[JsonConverter(typeof(ChinaDateTimeConverter))]
public DateTime Birthday { get; set; }
可以根据自己需求实现不同的转换类
6.自定义序列化的字段名称
实体中定义的属性名可能不是自己想要的名称，但是又不能更改实体定义，这个时候可以自定义序列化字段名称。
[JsonProperty(PropertyName = "CName")]
public string Name { get; set; }
7.动态决定属性是否序列化
这个是为了实现@米粒儿提的需求特别增加的，根据某些场景，可能A场景输出A，B，C三个属性，B场景输出E，F属性。虽然实际中不一定存在这种需求，但是json.net依然可以支持该特性。
继承默认的DefaultContractResolver类，传入需要输出的属性
重写修改了一下，大多数情况下应该是要排除的字段少于要保留的字段, 为了方便书写这里修改了构造函数加入retain表示props是需要保留的字段还是要排除的字段
1 public class LimitPropsContractResolver : DefaultContractResolver
2 {
3 string[] props = null;
4
5 bool retain;
6
7 /// <summary>
8 /// 构造函数
9 /// </summary>
10 /// <param name="props">传入的属性数组</param>
11 /// <param name="retain">true:表示props是需要保留的字段 false：表示props是要排除的字段</param>
12 public LimitPropsContractResolver(string[] props, bool retain=true)
13 {
14 //指定要序列化属性的清单
15 this.props = props;
16
17 this.retain = retain;
18 }
19
20 protected override IList<JsonProperty> CreateProperties(Type type,
21
22 MemberSerialization memberSerialization)
23 {
24 IList<JsonProperty> list =
25 base.CreateProperties(type, memberSerialization);
26 //只保留清单有列出的属性
27 return list.Where(p => {
28 if (retain)
29 {
30 return props.Contains(p.PropertyName);
31 }
32 else
33 {
34 return !props.Contains(p.PropertyName);
35 }
36 }).ToList();
37 }
public string Sex { get; set; } JsonSerializerSettings jsetting=new JsonSerializerSettings();
jsetting.ContractResolver = new LimitPropsContractResolver(new string[] { "Age", "IsMarry" });
Console.WriteLine(JsonConvert.SerializeObject(p, Formatting.Indented, jsetting));使用自定义的解析类，只输出”Age”, “IsMarry”两个属性，看下最终结果.只输出了Age属性，为什么IsMarry属性没有输出呢，因为标注了JsonIgnore
看到上面的结果想要实现pc端序列化一部分，手机端序列化另一部分就很简单了吧，我们改下代码实现一下
1 string[] propNames = null;
2 if (p.Age > 10)
3 {
4 propNames = new string[] { "Age", "IsMarry" };
5 }
6 else
7 {
8 propNames = new string[] { "Age", "Sex" };
9 }
10 jsetting.ContractResolver = new LimitPropsContractResolver(propNames);
11 Console.WriteLine(JsonConvert.SerializeObject(p, Formatting.Indented, jsetting));
8.枚举值的自定义格式化问题
默认情况下对于实体里面的枚举类型系统是格式化成改枚举对应的整型数值,那如果需要格式化成枚举对应的字符怎么处理呢？Newtonsoft.Json也帮我们想到了这点，下面看实例
1 public enum NotifyType
2 {
3 /// <summary>
4 /// Emil发送
5 /// </summary>
6 Mail=0,
7
8 /// <summary>
9 /// 短信发送
10 /// </summary>
11 SMS=1
12 }
13
14 public class TestEnmu
15 {
16 /// <summary>
17 /// 消息发送类型
18 /// </summary>
19 public NotifyType Type { get; set; }
20 }
21 JsonConvert.SerializeObject(new TestEnmu());
输出结果： 现在改造一下，输出”Type”:”Mail”
1 public class TestEnmu
2 {
3 /// <summary>
4 /// 消息发送类型
5 /// </summary>
6 [JsonConverter(typeof(StringEnumConverter))]
7 public NotifyType Type { get; set; }
8 }
其它的都不变，在Type属性上加上了JsonConverter(typeof(StringEnumConverter))表示将枚举值转换成对应的字符串,而StringEnumConverter是Newtonsoft.Json内置的转换类型,最终输出结果
9.自定义类型转换
默认情况下对于实体里面的Boolean系统是格式化成true或者false,对于true转成”是” false转成”否”这种需求改怎么实现了？我们可以自定义类型转换实现该需求，下面看实例
1 public class BoolConvert : JsonConverter
2 {
3 private string[] arrBString { get; set; }
4
5 public BoolConvert()
6 {
7 arrBString = "是,否".Split(',');
8 }
9
10 /// <summary>
11 /// 构造函数
12 /// </summary>
13 /// <param name="BooleanString">将bool值转换成的字符串值</param>
14 public BoolConvert(string BooleanString)
15 {
16 if (string.IsNullOrEmpty(BooleanString))
17 {
18 throw new ArgumentNullException();
19 }
20 arrBString = BooleanString.Split(',');
21 if (arrBString.Length != 2)
22 {
23 throw new ArgumentException("BooleanString格式不符合规定");
24 }
25 }
26
27
28 public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
29 {
30 bool isNullable = IsNullableType(objectType);
31 Type t = isNullable ? Nullable.GetUnderlyingType(objectType) : objectType;
32
33 if (reader.TokenType == JsonToken.Null)
34 {
35 if (!IsNullableType(objectType))
36 {
37 throw new Exception(string.Format("不能转换null value to {0}.", objectType));
38 }
39
40 return null;
41 }
42
43 try
44 {
45 if (reader.TokenType == JsonToken.String)
46 {
47 string boolText = reader.Value.ToString();
48 if (boolText.Equals(arrBString[0], StringComparison.OrdinalIgnoreCase))
49 {
50 return true;
51 }
52 else if (boolText.Equals(arrBString[1], StringComparison.OrdinalIgnoreCase))
53 {
54 return false;
55 }
56 }
57
58 if (reader.TokenType == JsonToken.Integer)
59 {
60 //数值
61 return Convert.ToInt32(reader.Value) == 1;
62 }
63 }
64 catch (Exception ex)
65 {
66 throw new Exception(string.Format("Error converting value {0} to type '{1}'", reader.Value, objectType));
67 }
68 throw new Exception(string.Format("Unexpected token {0} when parsing enum", reader.TokenType));
69 }
70
71 /// <summary>
72 /// 判断是否为Bool类型
73 /// </summary>
74 /// <param name="objectType">类型</param>
75 /// <returns>为bool类型则可以进行转换</returns>
76 public override bool CanConvert(Type objectType)
77 {
78 return true;
79 }
80
81
82 public bool IsNullableType(Type t)
83 {
84 if (t == null)
85 {
86 throw new ArgumentNullException("t");
87 }
88 return (t.BaseType.FullName=="System.ValueType" && t.GetGenericTypeDefinition() == typeof(Nullable<>));
89 }
90
91 public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
92 {
93 if (value == null)
94 {
95 writer.WriteNull();
96 return;
97 }
98
99 bool bValue = (bool)value;
100
101 if (bValue)
102 {
103 writer.WriteValue(arrBString[0]);
104 }
105 else
106 {
107 writer.WriteValue(arrBString[1]);
108 }
109 }
110 }
111
112
自定义了BoolConvert类型，继承自JsonConverter。构造函数参数BooleanString可以让我们自定义将true false转换成相应字符串。下面看实体里面怎么使用这个自定义转换类型
public class Person
{
[JsonConverter(typeof(BoolConvert))]
public bool IsMarry { get; set; }
} ‘
相应的有什么个性化的转换需求，都可以使用自定义转换类型的方式实现。
10.全局序列化设置
文章开头提出了Null值字段怎么不返回的问题，相应的在高级用法也给出了相应的解决方案使用jsetting.NullValueHandling = NullValueHandling.Ignore; 来设置不返回空值。这样有个麻烦的地方，每个不想返回空值的序列化都需设置一下。可以对序列化设置一些默认值方式么？下面将解答
1 Newtonsoft.Json.JsonSerializerSettings setting = new Newtonsoft.Json.JsonSerializerSettings();
2 JsonConvert.DefaultSettings = new Func<JsonSerializerSettings>(() =>
3 {
4 //日期类型默认格式化处理
5 setting.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat;
6 setting.DateFormatString = "yyyy-MM-dd HH:mm:ss";
7
8 //空值处理
9 setting.NullValueHandling = NullValueHandling.Ignore;
10
11 //高级用法九中的Bool类型转换 设置
12 setting.Converters.Add(new BoolConvert("是,否"));
13
14 return setting;
15 });
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。
文章由极客之音整理，本文链接：https://www.bmabk.com/index.php/post/51834.html
