JsonBuilder初出茅廬

　　互聯網這股東風不久前刮到了甘涼國，國王老甘獨具慧眼，想趕忙趁着東風未停大力發展移動互聯網，由於他篤信布斯雷的理論：「站在風口上，豬都能飛起來」。無奈地方偏僻落後，國內無可用之才啊。老甘束手無策的低頭凝思應聲被打斷，「啓奏陛下，有四個從東土大唐來的和尚前來更換通關文牒」，聽到「東土大唐」四個字，老甘心頭一喜，答道：「請他們去正堂等候」。

唐僧：貧僧唐三藏，自東土大唐而來，前往西天拜佛求經，今途徑貴國，懇請陛下更換通關文牒。
國王：高僧從東方而來，想必對互聯網略知一二。
唐僧：貧僧也是略有耳聞，不過個人徒兒對此很有研究。
國王：寡人現有一需求，還請高僧幫忙處理一下，事成以後，定放大家西行。需求文檔一會發你。
唐僧：遵命，謝陛下。
國王：（發文檔），@三藏。
唐僧：收到。
唐僧：@悟淨，處理下文檔中的需求。
沙僧：收到。

　　對接接口繁瑣複雜，還要多方聯調。悟空雖然水平高，可是脾氣很差，怕打起來；八戒好吃懶惰，恐難當此任；悟淨，爲師只有辛苦你了。唐僧內心想到此，不禁得嘆氣一聲。

沙僧：師傅，這文檔寫的亂七八糟、語句不通，不少入參、出參模糊不清，對方測試環境時好時壞，給他們打電話，他們說很忙暫時沒時間管我。
唐僧：悟淨，這些爲師都知道。程序員都沒什麼文化，註釋、文檔老是寫很差；並且很是苦逼，老是熬夜加班，因此沒有時間。你應該理解如下。
沙僧：哎。。。入參報文格式爲json，且很是複雜，我拼了一上午報文，每次都返回入參報文格式不正確。
唐僧：你是怎麼拼json格式的報文呢？
沙僧：傳統方法啊，先用Map和List組合好，再轉成json字符串。
唐僧：若是json很是複雜的話，要定義好多Map和List，光起些好點兒的名字就夠頭大的，還要再互相嵌套起來，稍有不慎，很容易出錯。真是夠夠的了。並且要寫不少代碼。
沙僧：誰說不是呢，師傅有什麼好方法嗎？
唐僧：json結構你應該很熟悉，它是一個自我嵌套的遞歸結構。那咱們就來設計一個構建器來直接構建json字符串，就叫JsonBuilder吧。
沙僧：我忽然想起StringBuilder，它的流式api很是好用，快捷方便。只是字符串是一維的，只有前後順序，但json是二維的，既有前後順序，還有內外順序。
唐僧：你說的內外順序其實就是父子關係，這也很好處理。
　　1)只需維護一個指向當前級別的指針，若是隻是添加簡單的key-value，當前級別保持不變。
　　2)若是添加了複合value（子節點），當前指針指向新添加的級別（深刻一級），此時該級別就成了新的當前級別。
　　3)當前級別結束後只需回到父級別（退出一級），此時父級別就又成了新的當前級別，如此往復下去便可。
沙僧：師傅，恕徒兒愚鈍，您講的太抽象了，能不能舉個例子。
唐僧：看下面的json，

{
  "string":"編程新說",
  "int":33,
  "boolean":true,
  "double":3.14,
  "null":null,
  "sub1":{
    "string":"編程新說",
    "int":33,
    "boolean":true,
    "double":3.14,
    "null":null
  },
  "sub2":[
    {
      "string":"編程新說",
      "int":33,
      "boolean":true,
      "double":3.14,
      "null":null
    },
    {
      "string":"編程新說",
      "int":33,
      "boolean":true,
      "double":3.14,
      "null":null
    }
  ],
  "sub3":[
    "編程新說",
    33,
    true,
    3.14,
    null
  ]
}
　　1)首先指針指向最外層級別，此時添加5個簡單的key-value，整個添加過程級別保持不變，即這5個值都添加給了當前級別。
　　2)而後添加sub1節點，它是一個複合節點，因此當前指針指向新添加的節點級別，此時添加5個簡單的key-value，都添加給了sub1，結束後指針回退到上一級。
　　3)此時再添加sub2，當前指針指向sub2，因sub2是一個數組，也是複合節點。
　　4)數組裏包含的又是複合節點，只不過沒有名字而已。添加一個無名字節點，當前指針指向該節點，此時能夠爲它添加5個key-value，而後回到上一級，即數組級別
　　5)而後添加第二個無名字節點，爲它添加5個key-value，回到上一級，再回到上一級。
　　6)而後添加sub3，由於它的value都是簡單值，因此添加value時當前級別不變，停留在數組級別。完成以後回到上一級，即最外層級別。
沙僧：這麼一講解卻是很是直觀，層次也很清晰，所見即所得。仍是師傅厲害。
唐僧：爲師也沒那麼厲害了，只是趁着大家打妖怪的時候，多琢磨了一下子。提及來簡單，實現起來仍是有些許難度的，要不你來試試。能夠參考這個示例。

JsonBuilder jb = new JsonBuilder();
jb.kv("string", "編程新說")
.kv("int", 33)
.kv("boolean", true)
.kv("double", 3.14)
.kv("null", null)
.ko("sub1")
    .kv("string", "編程新說")
    .kv("int", 33)
    .kv("boolean", true)
    .kv("double", 3.14)
    .kv("null", null)
.end()
.ka("sub2")
    .io()
        .kv("string", "編程新說")
        .kv("int", 33)
        .kv("boolean", true)
        .kv("double", 3.14)
        .kv("null", null)
    .end()
    .io()
        .kv("string", "編程新說")
        .kv("int", 33)
        .kv("boolean", true)
        .kv("double", 3.14)
        .kv("null", null)
    .end()
.end()
.ka("sub3")
    .iv("編程新說")
    .iv(33)
    .iv(true)
    .iv(3.14)
    .iv(null)
.end();
沙僧：好的，只是這變量名字有點。。。但別光我一人啊，也讓廣大羣衆試試吧。

　　悟淨獲得師傅的指點後，有一點小小的豁然開朗，決定本身去實現一把。但想到又開始去對接口，不禁得嘆氣一聲，哎。。。

 

PS：也能夠按照此方法寫一個MapBuilder。
PS：也能夠按照此方法寫一個XmlBuilder。

 

 

（完）

 

編程新說

---

用獨特的視角說技術