完成了XML的书写，JSON的小部分

2012-09-29 00:05:47 +08:00
parent 3fa5658ca2
commit 0ff868ec8c
4 changed files with 224 additions and 9 deletions
--- a/7.1.md
+++ b/7.1.md
@@ -1,13 +1,177 @@
 #7.1 XML处理
-
+XML作为一种数据交换和信息传递的格式已经得到了普及。随着Web服务日益广泛的应用，XML在开发人员的日常工作中扮演了愈来愈重要的角色。Go语言标准包里面已经有了XML包让我们可以在各种应用中实现对XML的操纵。
+
+本小节并不是介绍XML是什么，如果要了解XML可以参考其他文献，本小节主要是介绍如何用Go语言来解析XML以及如何输出XML。
+
+下面我们就来看一个例子：假如你是一名系统维护员，想把所有的服务器转换为XML文件，那么我们就可以从以下基本的XML标签开始做起：
+
+	<?xml version="1.0" encoding="utf-8"?>
+	<servers version="1">
+		<server>
+			<serverName>Shanghai_VPN</serverName>
+			<serverIP>127.0.0.1</serverIP>
+		</server>
+		<server>
+			<serverName>Beijing_VPN</serverName>
+			<serverIP>127.0.0.2</serverIP>
+		</server>
+	</servers>
+	
+以此为基础，我们就可以添加新的元素或者修改现有的元素，例如<serverName>可以分成地区和服务器编号。	

 ##解析XML
-###解析基本的XML
-###解析复杂的XML
-
-##输出XML
-
+假如有了上面这个XML，那么我们如何来解析这个XML呢？Go的XML包可以通过`xml.Unmarshal`函数来做解析，请看下面的例子：
+
+	package main
+	
+	import (
+		"encoding/xml"
+		"fmt"
+		"io/ioutil"
+		"os"
+	)
+	
+	type Recurlyservers struct {
+		XMLName     xml.Name `xml:"servers"`
+		Version     string   `xml:"version,attr"`
+		Svs         []server `xml:"server"`
+		Description string   `xml:",innerxml"`
+	}
+	
+	type server struct {
+		XMLName    xml.Name `xml:"server"`
+		ServerName string   `xml:"serverName"`
+		ServerIP   string   `xml:"serverIP"`
+	}
+	
+	func main() {
+		file, err := os.Open("servers.xml") // For read access.
+		if err != nil {
+			fmt.Printf("error: %v", err)
+			return
+		}
+		data, err := ioutil.ReadAll(file)
+		if err != nil {
+			fmt.Printf("error: %v", err)
+			return
+		}
+		v := Recurlyservers{}
+		err = xml.Unmarshal(data, &v)
+		if err != nil {
+			fmt.Printf("error: %v", err)
+			return
+		}
+	
+		fmt.Println(v)
+	}
+
+
+我们知道XML其实就是一种树形的数据格式，这个和我们Go语言里面的struct类似，所以在Go语言里面XML都是被转换成struct结构的。如上例子输出如下数据
+
+	{{ servers} 1 [{{ server} Shanghai_VPN 127.0.0.1} {{ server} Beijing_VPN 127.0.0.2}] 
+	<server>
+		<serverName>Shanghai_VPN</serverName>
+		<serverIP>127.0.0.1</serverIP>
+	</server>
+	<server>
+		<serverName>Beijing_VPN</serverName>
+		<serverIP>127.0.0.2</serverIP>
+	</server>
+	}
+
+
+通过上面的例子我们可以看到我们调用了`xml.Unmarshal`，就可以把数据解析到strcut里面，那么他是怎么解析进去的呢？我们看到我们的struct定义后面多了一个类似注释的东西`xml:"serverName"`,这个是strcut的一个特性，这个定义叫做tag，主要是用来反射用的，当反射的时候可以读取到这个信息，XML解析利用的就是reflect包，通过反射读取到这个tag的定义，然后利用这个tag的定义和XML数据存到里面。那么struct需要怎么设置这个tag呢？
+
+- 如果struct中一个string或者[]type类型的字段中tag定义了`",innerxml"`,那么这个字段会累计把这些原始的XML数据累计起来，如上Description定义。
+- 如果strcut中有一个字段类型xml.Name，叫做XMLName，那么在解析的时候就会这个element的名字
+- 如果strcut里面字段后面的tag里面定义了XML的element，那么解析的时候就会把相应的element值赋值给struct字段，如上servername和serverip定义。
+- 如果strcut里面字段后面的tag定义了`",attr"`，那么会读取该element下面的属性字段，如上version定义。
+- 如果strcut字段后面的tag定义了`"a>b>c"`,那么会解析xml元素的结构a下面的b下面的c元素。
+- 如果strcut字段后面的tag定义了`"-"`,那么这个字段不会被解析到任何数据。
+- 如果strcut字段后面的tag定义了`",any"`，如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。
+- 如果strcut字段后面的tag定义了`",comments"`,这个字段一般都是[]byte或者string类型，那么在这个元素下面的注释会累积在这个字段里面。
+
+上面详细讲述了如何设置我们的struct的tag，只要设置对了tag，那么XML解析是非常简单的，tag和xml的element是一一对应的关系，然后多个元素我们可以利用struct的slice实现，如上例子所示。
+
+>Go解析的XML文件都要首字母大写,不然在解析的时候会比较的麻烦。那我们就规范全部用大写开头。

+##输出XML
+假如我们想要输出如上所示的XML文件，那么Go如何来处理呢？Go语言的XML包里面有如下两个函数来处理`Marshal`和`MarshalIndent`，这两个函数主要的区别是第二个函数会增加前缀和缩进。下面我们来看一下如何输出如上的XML：
+
+	package main
+	
+	import (
+		"encoding/xml"
+		"fmt"
+		"os"
+	)
+	
+	type Servers struct {
+		XMLName xml.Name `xml:"servers"`
+		Version string   `xml:"version,attr"`
+		Svs     []server `xml:"server"`
+	}
+	
+	type server struct {
+		ServerName string `xml:"serverName"`
+		ServerIP   string `xml:"serverIP"`
+	}
+	
+	func main() {
+		v := &Servers{Version: "1"}
+		v.Svs = append(v.Svs, server{"Shanghai_VPN", "127.0.0.1"})
+		v.Svs = append(v.Svs, server{"Beijing_VPN", "127.0.0.2"})
+		output, err := xml.MarshalIndent(v, "  ", "    ")
+		if err != nil {
+			fmt.Printf("error: %v\n", err)
+		}
+		os.Stdout.Write([]byte(xml.Header))
+	
+		os.Stdout.Write(output)
+	}
+通过上面struct组织了xml的结构，上面的代码输出如下信息：
+
+	<?xml version="1.0" encoding="UTF-8"?>
+	<servers version="1">
+      <server>
+          <serverName>Shanghai_VPN</serverName>
+          <serverIP>127.0.0.1</serverIP>
+      </server>
+      <server>
+          <serverName>Beijing_VPN</serverName>
+          <serverIP>127.0.0.2</serverIP>
+      </server>
+	</servers>
+和我们定义的文件的格式一模一样，通过上面的例子我们知道`xml.MarshalIndent`或者`xml.Marshal`返回的信息都是不带XML头的，XML头信息XML包里面定义了Header变量，而输出的xml格式也是根据struct的tag信息。
+
+XML的element名字通过如下方式获取：
+
+- 字段名XMLName，类型xml.Name
+- 通过strcut的字段中定义的tag来获取
+- 通过strcut的字段名用来获取
+
+那么里面的结构和数据是如何输出的呢？我们需要如何设置struct里面的tag信息呢？
+
+- XMLName不会被输出
+- tag中含有`"-"`的不会输出
+- tag中含有`"name,attr"`，会以name作为字段作为名称被输出为这个XML元素的属性
+- tag中含有`",attr"`，会以这个struct的字段名作为名称作为XML元素的属性
+- tag中含有`",chardata"`，写为data数据
+- tag中含有`",innerxml"`，里面保存的是所有数据，而不会输出到XML
+- tag中含有`",comment"`，这个用来写XML的注释
+- tag中含有`"omitempty"`,这是是如果该字段的值为空值那么就不会被输出到XML，空值包括：false、0、nil或者""
+- tag中含有`"a>b>c"`，那么就会循环输出三个元素a包含b，b包含c，例如如下代码就会输出
+		
+		FirstName string   `xml:"name>first"`
+    	LastName  string   `xml:"name>last"`	
+    	
+    	<name>
+          <first>Asta</first>
+          <last>Xie</last>
+        </name>	
+
+
+通过上面的介绍我们了解了如何通过Go语言的XML包来解析XML和生成XML，XML包的这个操作都是通过反射来获取struct中的tag定义，然后来操作XML的，所以struct的tag定义非常重要，上面也列举了一些如何定义这个tag，这样我们在将来用XML开发Web应用的时候就非常方便了。

 ## links
   * [目录](<preface.md>)
--- a/7.2.md
+++ b/7.2.md
@@ -1,4 +1,55 @@
-#7.2 Json处理
+#7.2 JSON处理
+JSON（Javascript Object Notation）是一种轻量级的数据交换语言，以文字为基础，具有自我描述性且易于让人阅读。尽管JSON是在Javascript的一个子集，但JSON是独立于语言的文本格式，并且采用了类似于C语言家族的一些习惯。JSON与XML最大的不同在于XML是一个完整的标记语言，而JSON不是。JSON由于比XML更小、更快，更易解析,以及浏览器的内建快速解析支持,使得其更适用于网络数据传输领域。目前我们看到很多的开放平台，基本上所有的接口都是采用了JSON作为他们的数据交互。那么JSON在Web开发中如此重要，Go语言对于JSON支持的怎么样呢？其实Go语言的标准库里面已经非常好的支持了JSON，可以对JSON包进行解析、生成JSON数据。
+
+我们还是假设目前想要描述所有的服务器列表，通过JSON如何来表达，请看下面的描述
+
+	{"servers":[{"serverName":"Shanghai_VPN","serverIP":"127.0.0.1"},{"serverName":"Beijing_VPN","serverIP":"127.0.0.2"}]}
+
+接下来的例子以此JSON数据为基础，我们来进行JSON的解析和生成。	
+##解析JSON
+
+###解析到结构体
+假如有了上面的JSON串，那么我们如何来解析这个JSON串呢？Go的JSON包中有如下函数
+	
+	func Unmarshal(data []byte, v interface{}) error
+
+通过这个函数我们就可以实现解析的目的，详细的解析例子请看如下代码：
+
+	package main
+	
+	import (
+		"encoding/json"
+		"fmt"
+	)
+	
+	type Server struct {
+		ServerName string
+		ServerIP   string
+	}
+	
+	type Serverslice struct {
+		Servers []Server
+	}
+	
+	func main() {
+		var s Serverslice
+		str := `{"servers":[{"serverName":"Shanghai_VPN","serverIP":"127.0.0.1"},{"serverName":"Beijing_VPN","serverIP":"127.0.0.2"}]}`
+		json.Unmarshal([]byte(str), &s)
+		fmt.Println(s)
+	}
+
+通过上面的例子我们可以看到我们首先定义了结构体，结构体和JSON的数据一一对应，数组对应slice，字段名对应JSON里面的KEY，那么解析的时候如何解析到对应的字段的呢？例如JSON的key是`Foo`，那么怎么找对应的字段呢？
+
+- 首先查找字段的tag里面带有`Foo`的导出字段(首字母大写)
+- 其次查找字段名是`Foo`的导出字段
+- 最后查找类似`FOO`或者`FoO`这样的除了首字母之外其他大小写不敏感的导出字段
+
+聪明的你一定注意到了一点，能够输出的数据必须是导出字段，其他字段是不能输出的。同时JSON解析的时候只会解析能找得到的字段，如果找不到的字段会被忽略，这样的一个好处是在于当你接收到一个很大的JSON数据的时候，你如果只想部分数据，那么用这种方式就可以轻松的解决了。
+
+###解析到interface
+我们知道上面哪种解析方式是当我们了解了JSON的数据结构的情况下来进行的解析，那么如果我们在不知道JSON格式的情况下，如何来解析JSON呢？
+
+##生成JSON

 ## links
   * [目录](<preface.md>)
--- a/7.md
+++ b/7.md
@@ -5,7 +5,7 @@ XML是目前很多标准接口的交互语言，很多时候和一些Java编写

 ## 目录
   * 1. [XML处理](7.1.md)
-   * 2. [Json处理](7.2.md)
+   * 2. [JSON处理](7.2.md)
   * 3. [正则处理](7.3.md)
   * 4. [模板处理](7.4.md)
   * 5. [小结](7.5.md)
--- a/preface.md
+++ b/preface.md
@@ -42,7 +42,7 @@
 - 6.5 [小结](6.5.md)
 * 7.[文本处理](7.md)
 - 7.1 [XML处理](7.1.md)
- - 7.2 [Json处理](7.2.md) 
+ - 7.2 [JSON处理](7.2.md) 
 - 7.3 [正则处理](7.3.md)
 - 7.4 [模板处理](7.4.md)
 - 7.5 [小结](7.5.md)