3.5版本dll下載:http://pan.baidu.com/s/1c0vgNWchtml
手機端應用講究速度快,體驗好。恰好手頭上的一個項目服務端接口有性能問題,須要進行優化。在接口屢次修改中,實體添加了不少字段用於中間計算或者存儲,而後最終用Newtonsoft.Json進行序列化返回數據,通過分析一個簡單的列表接口每一行數據返回了16個字段,可是手機APP端只用到了其中7個字段,剩餘9個字段的數據所有都是多餘的,若是接口返回數據爲40K大小,也就是說大約20K的數據爲無效數據,3G網絡下20K下載差很少須要1s,不返回無效數據至少能夠節約1s的時間,大大提升用戶體驗。本篇將爲你們介紹Newtonsoft.Json的一些高級用法,能夠修改不多的代碼解決上述問題。前端
閱讀目錄node
在作開發的時候,不少數據交換都是以json格式傳輸的。而使用Json的時候,咱們不少時候會涉及到幾個序列化對象的使用:DataContractJsonSerializer,JavaScriptSerializer 和 Json.NET即Newtonsoft.Json。大多數人都會選擇性能以及通用性較好Json.NET,這個不是微軟的類庫,可是一個開源的世界級的Json操做類庫,從下面的性能對比就能夠看到它的其中之一的性能優勢。json
齊全的API介紹,使用方式簡單bootstrap
Json.Net是支持序列化和反序列化DataTable,DataSet,Entity Framework和Entity的。下面分別舉例說明序列化和反序列化。後端
DataTable:數組
//序列化DataTable DataTable dt = new DataTable(); dt.Columns.Add("Age", Type.GetType("System.Int32")); dt.Columns.Add("Name", Type.GetType("System.String")); dt.Columns.Add("Sex", Type.GetType("System.String")); dt.Columns.Add("IsMarry", Type.GetType("System.Boolean")); for (int i = 0; i < 4; i++) { DataRow dr = dt.NewRow(); dr["Age"] = i + 1; dr["Name"] = "Name" + i; dr["Sex"] = i % 2 == 0 ? "男" : "女"; dr["IsMarry"] = i % 2 > 0 ? true : false; dt.Rows.Add(dr); } Console.WriteLine(JsonConvert.SerializeObject(dt));
利用上面字符串進行反序列化網絡
string json = JsonConvert.SerializeObject(dt); dt=JsonConvert.DeserializeObject<DataTable>(json); foreach (DataRow dr in dt.Rows) { Console.WriteLine("{0}\t{1}\t{2}\t{3}\t", dr[0], dr[1], dr[2], dr[3]); }
Entity序列化和DataTable同樣,就不過多介紹了。數據結構
1.忽略某些屬性mvc
2.默認值的處理
3.空值的處理
4.支持非公共成員
5.日期處理
6.自定義序列化的字段名稱
7.動態決定屬性是否序列化
8.枚舉值的自定義格式化問題
9.自定義類型轉換
10.全局序列化設置
一.忽略某些屬性
相似本問開頭介紹的接口優化,實體中有些屬性不須要序列化返回,可使用該特性。首先介紹Json.Net序列化的模式:OptOut 和 OptIn
OptOut | 默認值,類中全部公有成員會被序列化,若是不想被序列化,能夠用特性JsonIgnore |
OptIn | 默認狀況下,全部的成員不會被序列化,類中的成員只有標有特性JsonProperty的纔會被序列化,當類的成員不少,但客戶端僅僅須要一部分數據時,頗有用 |
僅須要姓名屬性
[JsonObject(MemberSerialization.OptIn)] public class Person { public int Age { get; set; } [JsonProperty] public string Name { get; set; } public string Sex { get; set; } public bool IsMarry { get; set; } public DateTime Birthday { get; set; } }
不須要是否結婚屬性
[JsonObject(MemberSerialization.OptOut)] public class Person { public int Age { get; set; } public string Name { get; set; } public string Sex { get; set; } [JsonIgnore] public bool IsMarry { get; set; } public DateTime Birthday { get; set; } }
經過上面的例子能夠看到,要實現不返回某些屬性的需求很簡單。1.在實體類上加上[JsonObject(MemberSerialization.OptOut)] 2.在不須要返回的屬性上加上 [JsonIgnore]說明。
二.默認值處理
序列化時想忽略默認值屬性能夠經過JsonSerializerSettings.DefaultValueHandling來肯定,該值爲枚舉值
DefaultValueHandling.Ignore |
序列化和反序列化時,忽略默認值 |
DefaultValueHandling.Include |
序列化和反序列化時,包含默認值 |
[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));
最終結果以下:
三.空值的處理
序列化時須要忽略值爲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; }
四.支持非公共成員
序列化時默認都是處理公共成員,若是須要處理非公共成員,就要在該成員上加特性"JsonProperty"
[JsonProperty] private int Height { get; set; }
五.日期處理
對於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日期格式不是咱們想要的,咱們能夠繼承該類實現本身的日期
public class ChinaDateTimeConverter : DateTimeConverterBase { private static IsoDateTimeConverter dtConverter = new IsoDateTimeConverter { DateTimeFormat = "yyyy-MM-dd" }; public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) { return dtConverter.ReadJson(reader, objectType, existingValue, serializer); } public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) { dtConverter.WriteJson(writer, value, serializer); } }
本身實現了一個yyyy-MM-dd格式化轉換類,能夠看到只是初始化IsoDateTimeConverter時給的日期格式爲yyyy-MM-dd便可,下面看下效果
[JsonConverter(typeof(ChinaDateTimeConverter))] public DateTime Birthday { get; set; }
能夠根據本身需求實現不一樣的轉換類
六.自定義序列化的字段名稱
實體中定義的屬性名可能不是本身想要的名稱,可是又不能更改實體定義,這個時候能夠自定義序列化字段名稱。
[JsonProperty(PropertyName = "CName")] public string Name { get; set; }
七.動態決定屬性是否序列化
這個是爲了實現@米粒兒提的需求特別增長的,根據某些場景,可能A場景輸出A,B,C三個屬性,B場景輸出E,F屬性。雖然實際中不必定存在這種需求,可是json.net依然能夠支持該特性。
繼承默認的DefaultContractResolver類,傳入須要輸出的屬性
重寫修改了一下,大多數狀況下應該是要排除的字段少於要保留的字段, 爲了方便書寫這裏修改了構造函數加入retain表示props是須要保留的字段仍是要排除的字段
public class LimitPropsContractResolver : DefaultContractResolver { string[] props = null; bool retain; /// <summary> /// 構造函數 /// </summary> /// <param name="props">傳入的屬性數組</param> /// <param name="retain">true:表示props是須要保留的字段 false:表示props是要排除的字段</param> public LimitPropsContractResolver(string[] props, bool retain=true) { //指定要序列化屬性的清單 this.props = props; this.retain = retain; } protected override IList<JsonProperty> CreateProperties(Type type, MemberSerialization memberSerialization) { IList<JsonProperty> list = base.CreateProperties(type, memberSerialization); //只保留清單有列出的屬性 return list.Where(p => { if (retain) { return props.Contains(p.PropertyName); } else { return !props.Contains(p.PropertyName); } }).ToList(); }
public int Age { get; set; } [JsonIgnore] public bool IsMarry { get; set; } 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端序列化一部分,手機端序列化另外一部分就很簡單了吧,咱們改下代碼實現一下
string[] propNames = null; if (p.Age > 10) { propNames = new string[] { "Age", "IsMarry" }; } else { propNames = new string[] { "Age", "Sex" }; } jsetting.ContractResolver = new LimitPropsContractResolver(propNames); Console.WriteLine(JsonConvert.SerializeObject(p, Formatting.Indented, jsetting));
八.枚舉值的自定義格式化問題
默認狀況下對於實體裏面的枚舉類型系統是格式化成改枚舉對應的整型數值,那若是須要格式化成枚舉對應的字符怎麼處理呢?Newtonsoft.Json也幫咱們想到了這點,下面看實例
public enum NotifyType { /// <summary> /// Emil發送 /// </summary> Mail=0, /// <summary> /// 短信發送 /// </summary> SMS=1 } public class TestEnmu { /// <summary> /// 消息發送類型 /// </summary> public NotifyType Type { get; set; } } JsonConvert.SerializeObject(new TestEnmu());
輸出結果: 如今改造一下,輸出"Type":"Mail"
public class TestEnmu { /// <summary> /// 消息發送類型 /// </summary> [JsonConverter(typeof(StringEnumConverter))] public NotifyType Type { get; set; } }
其它的都不變,在Type屬性上加上了JsonConverter(typeof(StringEnumConverter))表示將枚舉值轉換成對應的字符串,而StringEnumConverter是Newtonsoft.Json內置的轉換類型,最終輸出結果
九.自定義類型轉換
默認狀況下對於實體裏面的Boolean系統是格式化成true或者false,對於true轉成"是" false轉成"否"這種需求改怎麼實現了?咱們能夠自定義類型轉換實現該需求,下面看實例
public class BoolConvert : JsonConverter { private string[] arrBString { get; set; } public BoolConvert() { arrBString = "是,否".Split(','); } /// <summary> /// 構造函數 /// </summary> /// <param name="BooleanString">將bool值轉換成的字符串值</param> public BoolConvert(string BooleanString) { if (string.IsNullOrEmpty(BooleanString)) { throw new ArgumentNullException(); } arrBString = BooleanString.Split(','); if (arrBString.Length != 2) { throw new ArgumentException("BooleanString格式不符合規定"); } } public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) { bool isNullable = IsNullableType(objectType); Type t = isNullable ? Nullable.GetUnderlyingType(objectType) : objectType; if (reader.TokenType == JsonToken.Null) { if (!IsNullableType(objectType)) { throw new Exception(string.Format("不能轉換null value to {0}.", objectType)); } return null; } try { if (reader.TokenType == JsonToken.String) { string boolText = reader.Value.ToString(); if (boolText.Equals(arrBString[0], StringComparison.OrdinalIgnoreCase)) { return true; } else if (boolText.Equals(arrBString[1], StringComparison.OrdinalIgnoreCase)) { return false; } } if (reader.TokenType == JsonToken.Integer) { //數值 return Convert.ToInt32(reader.Value) == 1; } } catch (Exception ex) { throw new Exception(string.Format("Error converting value {0} to type '{1}'", reader.Value, objectType)); } throw new Exception(string.Format("Unexpected token {0} when parsing enum", reader.TokenType)); } /// <summary> /// 判斷是否爲Bool類型 /// </summary> /// <param name="objectType">類型</param> /// <returns>爲bool類型則能夠進行轉換</returns> public override bool CanConvert(Type objectType) { return true; } public bool IsNullableType(Type t) { if (t == null) { throw new ArgumentNullException("t"); } return (t.BaseType.FullName=="System.ValueType" && t.GetGenericTypeDefinition() == typeof(Nullable<>)); } public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) { if (value == null) { writer.WriteNull(); return; } bool bValue = (bool)value; if (bValue) { writer.WriteValue(arrBString[0]); } else { writer.WriteValue(arrBString[1]); } } }
自定義了BoolConvert類型,繼承自JsonConverter。構造函數參數BooleanString可讓咱們自定義將true false轉換成相應字符串。下面看實體裏面怎麼使用這個自定義轉換類型
public class Person { [JsonConverter(typeof(BoolConvert))] public bool IsMarry { get; set; } }
‘
相應的有什麼個性化的轉換需求,均可以使用自定義轉換類型的方式實現。
十.全局序列化設置
文章開頭提出了Null值字段怎麼不返回的問題,相應的在高級用法也給出了相應的解決方案使用jsetting.NullValueHandling = NullValueHandling.Ignore; 來設置不返回空值。這樣有個麻煩的地方,每一個不想返回空值的序列化都需設置一下。能夠對序列化設置一些默認值方式麼?下面將解答
Newtonsoft.Json.JsonSerializerSettings setting = new Newtonsoft.Json.JsonSerializerSettings(); JsonConvert.DefaultSettings = new Func<JsonSerializerSettings>(() => {
//日期類型默認格式化處理 setting.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat; setting.DateFormatString = "yyyy-MM-dd HH:mm:ss";
//空值處理 setting.NullValueHandling = NullValueHandling.Ignore;
//高級用法九中的Bool類型轉換 設置 setting.Converters.Add(new BoolConvert("是,否")); return setting; });
這樣設置之後,之後使用序列化的地方就不須要單獨設置了,我的最喜歡設置的是空值處理這一塊。
Newtonsoft.Json序列化庫替咱們想了不少特性,也實現了不少特性,除了上面介紹的幾種高級用法外,還有其它的特殊用法,能夠去官網進行學習。固然這裏我目前最喜歡的特性就是那個忽略部分屬性序列化的功能,很小的代碼改動實現了接口的優化,提高了用戶體驗。
出處:http://www.cnblogs.com/yanweidie/p/4605212.html
=============================================================
閱讀目錄
"動態改變屬性序列化名稱"顧名思義:在不一樣場景下實體字段序列化後字段名稱不一樣,好比有下面實體A,正常序列化後json爲{"Id":"123"}
public class A { public string Id { get; set; } }
如今有兩種新場景A場景下 字段Id須要序列化爲Key,B場景下字段Id須要序列化爲id,那麼如何在不改變實體代碼情形下完成該功能呢?下面以樹形結構數據爲例子進行講解。
各類各樣的前端樹形控件所要求數據格式不同,下面列舉幾種常見的樹形控件數據格式。
//bootstrap treeview,數據結構爲 [ { id:'1', //節點id text: '父節點', //節點顯示文本 icon: 'glyphicon glyphicon-cloud-download', //節點圖標樣式 nodes:[{id:'2',text:'子節點'}] //子節點 } ] //zTree [ { "id" : "1", "name" : "父節點1", "children" : [{id:'4',name:'子節點1'}] }, { "id" : "2", "name" : "父節點2", "children" : [{id:'5',name:'子節點2'}] }, { "id" : "3", "name" : "父節點3", "children" : [{id:'6',name:'子節點3'}] } ]
二者之間字段對比
treeview | zTree | |
節點id | id | id |
顯示文本 | text | name |
圖標 | icon | icon |
子節點 | nodes | children |
標紅部分是數據格式區別,假設後臺定義的樹形實體以下
/// <summary> /// 樹形實體 /// </summary> public class Tree { /// <summary> /// 當前ID /// </summary> public string Id { get; set; } /// <summary> /// 文本 /// </summary> public string Text { get; set; } /// <summary> /// 附加信息 /// </summary> public string Tag { get; set; } /// <summary> /// 節點圖標 /// </summary> public string Icon { get; set; } /// <summary> /// 子級 /// </summary> public List<Tree> Childrens { get; set; } }
/// <summary> /// 樹形實體 /// </summary> public class Tree { /// <summary> /// 當前ID /// </summary> public string id { get; set; } /// <summary> /// 文本 /// </summary> public string text { get; set; } /// <summary> /// 附加信息 /// </summary> public string Tag { get; set; } /// <summary> /// 節點圖標 /// </summary> public string Icon { get; set; } /// <summary> /// 子級 /// </summary> public List<Tree> nodes { get; set; } }
其中標紅部分是修改的,固然還須要修改對Tree實體賦值的代碼,這裏就不列出了。
方法二 前臺js處理
var data=[ {"Id":"1","Text":"父節點1","Childrens":[ {"Id":"3","Text":"子節點1","Childrens":[{"Id":"5","Text":"子節點1-1"}]}, {"Id":"4","Text":"子節點2"} ]}, {"Id":"2","Text":"父節點2","Childrens":[ {"Id":"5","Text":"子節點3"} ]}] //將後臺返回數據轉換成treeview所需格式數據 handleChild(data); console.log(data); //轉換後臺實體數據爲treeview符合的數據格式 function handleChild(childs){ for(var i=0,length=childs.length;i<length;i++){ var item=childs[i]; item.id=item.Id; item.text=item.Text; item.nodes=item.Childrens; //處理子節點 if(item.Childrens){ handleChild(item.Childrens); } delete item.Id; delete item.Text; delete item.Childrens; } }
/// <summary> /// 動態屬性轉換約定 /// </summary> /// <remarks> /// 處理場景 樹形結構數據 後臺代碼實體定義 爲 Id Childrens 可是前臺樹形控件所需數據結構爲 id,nodes /// 這個時候可使用該屬性約定轉換類 動態設置 序列化後字段名稱 /// </remarks> /// <example> /// JsonSerializerSettings setting = new JsonSerializerSettings(); /// setting.ContractResolver = new PropsContractResolver(new Dictionary<string, string> { { "Id", "id" }, { "Text", "text" }, { "Childrens", "nodes" } }); /// string AA = JsonConvert.SerializeObject(cc, Formatting.Indented, setting); /// </example> public class PropsContractResolver : DefaultContractResolver { Dictionary<string, string> dict_props = null; /// <summary> /// 構造函數 /// </summary> /// <param name="props">傳入的屬性數組</param> public PropsContractResolver(Dictionary<string, string> dictPropertyName) { //指定字段要序列化成什麼名稱 this.dict_props = dictPropertyName; } protected override string ResolvePropertyName(string propertyName) { string newPropertyName = string.Empty; if (dict_props != null && dict_props.TryGetValue(propertyName, out newPropertyName)) { return newPropertyName; } else { return base.ResolvePropertyName(propertyName); } } }
調用代碼實例
string type="zTree"; //字段映射關係 Dictionary<string, string> _dictProp = null; if(type=="zTree"){ _dictProp = new Dictionary<string, string> { { "Icon", "icon" }, { "Text", "name" }, { "Childrens", "children" } }; }else if(type=="treeview"){ _dictProp = new Dictionary<string, string> { { "Icon", "icon" }, { "Text", "text" }, { "Childrens", "nodes" } }; } // 序列化設置 JsonSerializerSettings PropSettings = new JsonSerializerSettings { ContractResolver = new PropsContractResolver(_dictProp) }; return JsonConvert.SerializeObject(new List<Tree>(), Formatting.None, PropSettings);
默認狀況下對於實體裏面的枚舉類型系統是格式化成改枚舉對應的整型數值,那若是須要格式化成枚舉對應的字符怎麼處理呢?Newtonsoft.Json也幫咱們想到了這點,下面看實例
public enum NotifyType { /// <summary> /// Emil發送 /// </summary> Mail=0, /// <summary> /// 短信發送 /// </summary> SMS=1 } public class TestEnmu { /// <summary> /// 消息發送類型 /// </summary> public NotifyType Type { get; set; } } JsonConvert.SerializeObject(new TestEnmu());
輸出結果: 如今改造一下,輸出"Type":"Mail"
public class TestEnmu { /// <summary> /// 消息發送類型 /// </summary> [JsonConverter(typeof(StringEnumConverter))] public NotifyType Type { get; set; } }
其它的都不變,在Type屬性上加上了JsonConverter(typeof(StringEnumConverter))表示將枚舉值轉換成對應的字符串,而StringEnumConverter是Newtonsoft.Json內置的轉換類型,最終輸出結果
全局參數設置功能是我最喜歡使用的功能,如今作的mvc項目,我都會先設定空值處理,減小沒必要要的流量損耗。上篇文章開篇說了,最初研究Newtonsoft.Json是從移動端項目開始的,無用字段空值字段不返回。
Newtonsoft.Json.JsonSerializerSettings setting = new Newtonsoft.Json.JsonSerializerSettings(); JsonConvert.DefaultSettings = new Func<JsonSerializerSettings>(() => { //日期類型默認格式化處理 setting.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat; setting.DateFormatString = "yyyy-MM-dd HH:mm:ss"; //空值處理 setting.NullValueHandling = NullValueHandling.Ignore;return setting; });
另外有關自定義類型轉換問題能夠參考Newtonsoft.Json高級用法第九條。序列化庫深刻使用以後,由衷的佩服做者,能夠將一個序列化庫作的如此強大,在學習它源代碼的同時對本身代碼設計理念也產生了很大的影響。感謝Newtonsoft.Json,後續有好的問題會在本篇文章進行續寫。
出處:http://www.cnblogs.com/yanweidie/p/5155268.html