From 01b71d46ec811b917d061955f0bad71343c39013 Mon Sep 17 00:00:00 2001 From: dake Date: Sun, 1 Nov 2015 01:37:04 +0800 Subject: [PATCH] =?UTF-8?q?=E9=98=85=E8=AF=BB=E5=B9=B6=E6=A0=A1=E5=AF=B912?= =?UTF-8?q?.8=E5=88=B012.10?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- eBook/12.10.md | 20 +++---- eBook/12.8.md | 36 ++++++------- eBook/12.9.md | 132 ++++++++++++++++++++++----------------------- eBook/directory.md | 2 + 4 files changed, 96 insertions(+), 94 deletions(-) diff --git a/eBook/12.10.md b/eBook/12.10.md index e95750a..5d0bc48 100644 --- a/eBook/12.10.md +++ b/eBook/12.10.md @@ -1,5 +1,5 @@ -# XML数据格式 -下面是与12.9节json例子等价的XML版本: +# XML 数据格式 +下面是与 12.9 节 JSON 例子等价的 XML 版本: ```xml Laura @@ -7,11 +7,11 @@ ``` -如同json包中`Marshal()`和`UnMarshal()`函数一样,从XML中编码和解码数据;但这个更通用,可以从文件中读取和写入(或者任何实现了io.Reader和io.Writer接口的类型) +如同 json 包一样,也有 `Marshal()` 和 `UnMarshal()` 从 XML 中编码和解码数据;但这个更通用,可以从文件中读取和写入(或者任何实现了 io.Reader 和 io.Writer 接口的类型) -和json的方式一样,xml数据可以序列化为结构,或者从结构反序列化为xml数据;这些可以在例子15.8(twitter_status.go)中看到。 +和 JSON 的方式一样,XML 数据可以序列化为结构,或者从结构反序列化为 XML 数据;这些可以在例子 15.8(twitter_status.go)中看到。 -encoding/xml包实现了一个简单的xml解析器(SAX),用来解析XML数据内容。下面的例子说明如何使用解析器: +encoding/xml 包实现了一个简单的 XML 解析器(SAX),用来解析 XML 数据内容。下面的例子说明如何使用解析器: 示例 12.17 [xml.go](examples/chapter_12/xml.go): @@ -68,14 +68,14 @@ End of token */ ``` -包中定义了若干XML标签类型:StartElement,Chardata(这是从开始标签到结束标签之间的实际文本),EndElement,Comment,Directive 或 ProcInst. +包中定义了若干 XML 标签类型:StartElement,Chardata(这是从开始标签到结束标签之间的实际文本),EndElement,Comment,Directive 或 ProcInst。 -包中同样定义了一个结构解析器:`NewParser`方法持有一个io.Reader(这里具体类型是strings.NewReader)并生成一个解析器类型的对象。还有一个`Token()`方法返回输入流里的下一个XML token。在输入流的结尾处,会返回(nil, io.EOF) +包中同样定义了一个结构解析器:`NewParser` 方法持有一个 io.Reader(这里具体类型是 strings.NewReader)并生成一个解析器类型的对象。还有一个 `Token()` 方法返回输入流里的下一个 XML token。在输入流的结尾处,会返回(nil,io.EOF) -XML文本被循环处理直到`Token()`返回一个错误,因为已经到达文件尾部,再没有内容可供处理了。通过一个type-switch可以根据一些XML标签进一步处理。Chardata中的内容只是一个[]byte,通过字符串转换让其变得可读性强一些。 +XML 文本被循环处理直到 `Token()` 返回一个错误,因为已经到达文件尾部,再没有内容可供处理了。通过一个 type-switch 可以根据一些 XML 标签进一步处理。Chardata 中的内容只是一个 []byte,通过字符串转换让其变得可读性强一些。 ## 链接 - [目录](directory.md) -- 上一节:[Json数据格式](12.9.md) -- 下一节:[XML数据格式](12.11.md) +- 上一节:[Json 数据格式](12.9.md) +- 下一节:[用 gob 传输数据](12.11.md) diff --git a/eBook/12.8.md b/eBook/12.8.md index 8a6823a..392864d 100644 --- a/eBook/12.8.md +++ b/eBook/12.8.md @@ -1,6 +1,6 @@ -# 一个使用接口的实际例子:fmt.Fprintf +# 一个使用接口的实际例子:fmt.Fprintf -例子程序`io_interfaces.go`很好的阐述了io包中的接口概念。 +例子程序 `io_interfaces.go` 很好的阐述了 io 包中的接口概念。 示例 12.15 [io_interfaces.go](examples/chapter_12/io_interfaces.go): ```go @@ -31,40 +31,40 @@ func main() { hello world! - unbuffered hello world! - buffered ``` -下面是`fmt.Fprintf()`函数的实际签名 +下面是 `fmt.Fprintf()` 函数的实际签名 ```go - func Fprintf(w io.Writer, format string, a ...interface{}) (n int, err error) +func Fprintf(w io.Writer, format string, a ...interface{}) (n int, err error) ``` -其不是写入一个文件,而是写入一个`io.Writer`接口类型的变量,下面是`Writer`接口在io包中的定义: +其不是写入一个文件,而是写入一个 `io.Writer` 接口类型的变量,下面是 `Writer` 接口在 io 包中的定义: ```go - type Writer interface { - Write(p []byte) (n int, err error) - } +type Writer interface { + Write(p []byte) (n int, err error) +} ``` -`fmt.Fprintf()`依据指定的格式向第一个参数内写入字符串,第一参数必须实现了`io.Writer`接口。`Fprintf()`能够写入任何类型,只要其实现了`Write`方法,包括`os.Stdout`,文件(例如os.File),管道,网络连接,通道等等,同样的也可以使用bufio包中缓冲写入。bufio包中定义了`type Writer struct{...}` +`fmt.Fprintf()` 依据指定的格式向第一个参数内写入字符串,第一参数必须实现了 `io.Writer` 接口。`Fprintf()` 能够写入任何类型,只要其实现了 `Write` 方法,包括 `os.Stdout`,文件(例如 os.File),管道,网络连接,通道等等,同样的也可以使用 bufio 包中缓冲写入。bufio 包中定义了 `type Writer struct{...}` -bufio.Writer实现了Write方法: +bufio.Writer 实现了 Write 方法: ```go - func (b *Writer) Write(p []byte) (nn int, err error) +func (b *Writer) Write(p []byte) (nn int, err error) ``` -它还有一个工厂函数:传给它一个`io.Writer`类型的参数,它会返回一个缓冲的`bufio.Writer`类型的`io.Writer`: +它还有一个工厂函数:传给它一个 `io.Writer` 类型的参数,它会返回一个缓冲的 `bufio.Writer` 类型的 `io.Writer`: ```go - func NewWriter(wr io.Writer) (b *Writer) +func NewWriter(wr io.Writer) (b *Writer) ``` 其适合任何形式的缓冲写入。 -在缓冲写入的最后千万不要忘了使用`Flush()`,否则最后的输出不会被写入。 +在缓冲写入的最后千万不要忘了使用 `Flush()`,否则最后的输出不会被写入。 -在15.2-15.8章节,我们将使用`fmt.Fprint`函数向`http.ResponseWriter`写入,其同样实现了io.Writer接口。 +在 15.2-15.8 章节,我们将使用 `fmt.Fprint` 函数向 `http.ResponseWriter` 写入,其同样实现了 io.Writer 接口。 **练习 12.7**:[remove_3till5char.go](exercises/chapter_12/remove_3till5char.go) -下面的代码有一个输入文件`goprogram.go`,然后以每一行为单位读取,从读取的当前行中截取第3到第5的字节写入另一个文件。然而当你运行这个程序,输出的文件却是个空文件。找出程序逻辑中的bug,修正它并测试。 +下面的代码有一个输入文件 `goprogram.go`,然后以每一行为单位读取,从读取的当前行中截取第 3 到第 5 的字节写入另一个文件。然而当你运行这个程序,输出的文件却是个空文件。找出程序逻辑中的 bug,修正它并测试。 ```go package main @@ -102,5 +102,5 @@ func main() { ## 链接 - [目录](directory.md) -- 上一节:[用defer关闭文件](12.7.md) -- 下一节:[格式化Json数据](12.9.md) +- 上一节:[用 defer 关闭文件](12.7.md) +- 下一节:[格式化 Json 数据](12.9.md) diff --git a/eBook/12.9.md b/eBook/12.9.md index 73e73e2..01b402d 100644 --- a/eBook/12.9.md +++ b/eBook/12.9.md @@ -1,23 +1,23 @@ -# Json数据格式 +# Json 数据格式 -数据结构要在网络中传输或保存到文件,就必须对其编码和解码;目前存在很多编码格式:JSON,XML,gob,Google缓冲协议等等。Go语言支持所有这些编码格式;在后面的章节,我们将讨论前三种格式。 +数据结构要在网络中传输或保存到文件,就必须对其编码和解码;目前存在很多编码格式:JSON,XML,gob,Google 缓冲协议等等。Go 语言支持所有这些编码格式;在后面的章节,我们将讨论前三种格式。 -结构能够包含二进制数据,如果作为文本打印,那么可读性是很差的。另外结构内部包含命名字段,所以不清楚数据的用意。 +结构可能包含二进制数据,如果将其作为文本打印,那么可读性是很差的。另外结构内部可能包含匿名字段,而不清楚数据的用意。 -通过把数据转换成纯文本,使用命名的字段来标注,让其具有可读性。这样的数据格式可以通过网络传输,而且是与平台无关的,任何类型的应用都能够读取和输出,不用关系操作系统和编程语言的类型。 +通过把数据转换成纯文本,使用命名的字段来标注,让其具有可读性。这样的数据格式可以通过网络传输,而且是与平台无关的,任何类型的应用都能够读取和输出,不与操作系统和编程语言的类型相关。 下面是一些术语说明: -- 数据结构 --> 指定格式 = `序列化`或`编码`(传输之前) -- 指定格式 --> 数据格式 = `反序列化`或`解码`(传输之后) +- 数据结构 --> 指定格式 = `序列化` 或 `编码`(传输之前) +- 指定格式 --> 数据格式 = `反序列化` 或 `解码`(传输之后) -序列化是在内存中把数据转换成指定格式(data -> string),反之亦然(string -> data structure) +序列化是在内存中把数据转换成指定格式(data -> string),反之亦然(string -> data structure) -编码也是一样的,只是输出一个数据流(实现了io.Writer接口);解码是从一个数据流(实现了io.Reader)输出到一个数据结构。 +编码也是一样的,只是输出一个数据流(实现了 io.Writer 接口);解码是从一个数据流(实现了 io.Reader)输出到一个数据结构。 -我们都比较熟悉XML格式(参阅12.10);但有些时候JSON(JavaScript Object Notation,参阅 [http://json.org](http://json.org))被作为首选,主要是由于其格式上非常简洁。通常json被用在web后端和浏览器之间通讯,但是在其它场景也同样的有用。 +我们都比较熟悉 XML 格式(参阅 [12.10](12.9.md));但有些时候 JSON(JavaScript Object Notation,参阅 [http://json.org](http://json.org))被作为首选,主要是由于其格式上非常简洁。通常 JSON 被用于 web 后端和浏览器之间的通讯,但是在其它场景也同样的有用。 -这是一个简短的JSON片段: +这是一个简短的 JSON 片段: ```javascript { @@ -28,11 +28,11 @@ } ``` -尽管XML被广泛的应用,但是JSON更加简洁、轻量(其占用更少的内存、磁盘及网络带宽)和更好的可读性,这也说明他越来越受欢迎。 +尽管 XML 被广泛的应用,但是 JSON 更加简洁、轻量(占用更少的内存、磁盘及网络带宽)和更好的可读性,这也说明它越来越受欢迎。 -go语言的json包可以让你在程序中方便的读取和写入JSON数据。 +Go 语言的 json 包可以让你在程序中方便的读取和写入 JSON 数据。 -我们将在下面的例子里使用json包,并使用练习10.1 vcard.go中一个简化版本的Address和VCard结构(为了简单起见,我们忽略了很多错误处理,不过在实际应用中你必须要合理的处理这些错误,参阅13章) +我们将在下面的例子里使用 json 包,并使用练习 10.1 vcard.go 中一个简化版本的 Address 和 VCard 结构(为了简单起见,我们忽略了很多错误处理,不过在实际应用中你必须要合理的处理这些错误,参阅 13 章) 示例 12.16 [json.go](examples/chapter_12/json.go): @@ -81,7 +81,7 @@ func main() { ``` -`json.Marshal()`的函数签名是 `func Marshal(v interface{}) ([]byte, error)`,下面是数据编码后的json文本(实际上是一个[]bytes): +`json.Marshal()` 的函数签名是 `func Marshal(v interface{}) ([]byte, error)`,下面是数据编码后的 JSON 文本(实际上是一个 []bytes): ```javascript { @@ -100,94 +100,94 @@ func main() { } ``` -处于安全考虑,在web应用中最好使用`json.MarshalforHTML()`函数,其对数据执行HTML转码,所以文本会被安全的嵌在HTML`