removed all the footers; formated all the files

2012-11-01 16:10:44 +08:00
parent 77b8677ae0
commit c059171e15
73 changed files with 4576 additions and 4782 deletions
--- a/7.1.md
+++ b/7.1.md
@@ -1,4 +1,4 @@
-# 7.1 XML处理
+# 7.1 XML处理
 XML作为一种数据交换和信息传递的格式已经十分普及。而随着Web服务日益广泛的应用，现在XML在日常的开发工作中也扮演了愈发重要的角色。这一小节， 我们将就Go语言标准包中的XML相关处理的包进行介绍。

 这个小节不会涉及XML规范相关的内容（如需了解相关知识请参考其他文献），而是介绍如何用Go语言来编解码XML文件相关的知识。
@@ -16,10 +16,10 @@ XML作为一种数据交换和信息传递的格式已经十分普及。而随
 			<serverIP>127.0.0.2</serverIP>
 		</server>
 	</servers>
-	
-上面的XML文档描述了两个服务器的信息，包含了服务器名和服务器的IP信息，接下来的Go例子以此XML描述的信息进行操作。	
-
-## 解析XML
+
+上面的XML文档描述了两个服务器的信息，包含了服务器名和服务器的IP信息，接下来的Go例子以此XML描述的信息进行操作。
+
+## 解析XML
 如何解析如上这个XML文件喃呢？ 我们可以通过xml包的`Unmarshal`函数来达到我们的目的

 	func Unmarshal(data []byte, v interface{}) error
@@ -29,27 +29,27 @@ data接收的是XML数据流，v是需要输出的结构，定义为interface，
 示例代码如下：

 	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.
 		defer file.Close()
@@ -68,14 +68,14 @@ data接收的是XML数据流，v是需要输出的结构，定义为interface，
 			fmt.Printf("error: %v", err)
 			return
 		}
-	
+
 		fmt.Println(v)
 	}


 XML本质上是一种树形的数据格式，而我们可以定义与之匹配的go 语言的 struct类型，然后通过xml.Unmarshal来将xml中的数据解析成对应的struct对象。如上例子输出如下数据

-	{{ servers} 1 [{{ server} Shanghai_VPN 127.0.0.1} {{ server} Beijing_VPN 127.0.0.2}] 
+	{{ 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>
@@ -99,14 +99,14 @@ Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的

 - 如果struct的一个字段是string或者[]byte类型且它的tag含有`",innerxml"`，Unmarshal将会将此字段所对应的元素内所有内嵌的原始xml累加到此字段上，如上面例子Description定义。最后的输出是

-		<server>
-			<serverName>Shanghai_VPN</serverName>
-			<serverIP>127.0.0.1</serverIP>
-		</server>
-		<server>
-			<serverName>Beijing_VPN</serverName>
-			<serverIP>127.0.0.2</serverIP>
-		</server>	
+	<server>
+		<serverName>Shanghai_VPN</serverName>
+		<serverIP>127.0.0.1</serverIP>
+	</server>
+	<server>
+		<serverName>Beijing_VPN</serverName>
+		<serverIP>127.0.0.2</serverIP>
+	</server>

 - 如果struct中有一个叫做XMLName，且类型为xml.Name字段，那么在解析的时候就会保存这个element的名字到该字段,如上面例子中的servers。
 - 如果某个struct字段的tag定义中含有XML结构中element的名称，那么解析的时候就会把相应的element值赋值给该字段，如上servername和serverip定义。
@@ -118,8 +118,8 @@ Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的

 上面详细讲述了如何定义struct的tag。 只要设置对了tag，那么XML解析就如上面示例般简单，tag和XML的element是一一对应的关系，如上所示，我们还可以通过slice来表示多个同级元素。

->注意： 为了正确解析，go语言的xml包要求struct定义中的所有字段必须是可导出的（即首字母大写）
-
+>注意： 为了正确解析，go语言的xml包要求struct定义中的所有字段必须是可导出的（即首字母大写）
+
 ## 输出XML
 假若我们不是要解析如上所示的XML文件，而是生成它，那么在go语言中又该如何实现呢？ xml包中提供了`Marshal`和`MarshalIndent`两个函数，来满足我们的需求。这两个函数主要的区别是第二个函数会增加前缀和缩进，函数的定义如下所示：

@@ -131,24 +131,24 @@ Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的
 下面我们来看一下如何输出如上的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"})
@@ -158,22 +158,22 @@ Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的
 			fmt.Printf("error: %v\n", err)
 		}
 		os.Stdout.Write([]byte(xml.Header))
-	
+
 		os.Stdout.Write(output)
 	}
 上面的代码输出如下信息：

 	<?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>
+	<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>

 和我们之前定义的文件的格式一模一样，之所以会有`os.Stdout.Write([]byte(xml.Header))` 这句代码的出现，是因为`xml.MarshalIndent`或者`xml.Marshal`输出的信息都是不带XML头的，为了生成正确的xml文件，我们使用了xml包预定义的Header变量。

@@ -203,22 +203,19 @@ Go语言的反射机制，可以利用这些tag信息来将来自XML文件中的
 - tag中含有`",comment"`，将被当作xml注释来输出，而不会进行常规的编码过程，字段值中不能含有"--"字符串
 - tag中含有`"omitempty"`,如果该字段的值为空值那么该字段就不会被输出到XML，空值包括：false、0、nil指针或nil接口，任何长度为0的array, slice, map或者string
 - 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>	
+
+	FirstName string   `xml:"name>first"`
+	LastName  string   `xml:"name>last"`
+
+	<name>
+	<first>Asta</first>
+	<last>Xie</last>
+	</name>


-上面我们介绍了如何使用Go语言的xml包来编/解码XML文件，重要的一点是对XML的所有操作都是通过struct tag来实现的，所以学会对struct tag的运用变得非常重要，在文章中我们简要的列举了如何定义tag。更多内容或tag定义请参看相应的官方资料。
-
-## links
-   * [目录](<preface.md>)
-   * 上一节: [文本处理](<7.md>)
-   * 下一节: [Json处理](<7.2.md>)
-
-## LastModified 
-   * $Id$
+上面我们介绍了如何使用Go语言的xml包来编/解码XML文件，重要的一点是对XML的所有操作都是通过struct tag来实现的，所以学会对struct tag的运用变得非常重要，在文章中我们简要的列举了如何定义tag。更多内容或tag定义请参看相应的官方资料。
+
+## links
+   * [目录](<preface.md>)
+   * 上一节: [文本处理](<7.md>)
+   * 下一节: [Json处理](<7.2.md>)