diff --git a/README.md b/README.md index 9c4dba9..759845c 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,7 @@ - [@domainname](https://github.com/domainname) - [@leisore](https://github.com/leisore) - [@dake](https://github.com/dake) + - [@glight2000](https://github.com/glight2000) ## 授权许可 diff --git a/README_gc.md b/README_gc.md index d8d56f0..3dc7b19 100644 --- a/README_gc.md +++ b/README_gc.md @@ -18,6 +18,7 @@ - [@domainname](https://github.com/domainname) - [@leisore](https://github.com/leisore) - [@dake](https://github.com/dake) +- [@glight2000](https://github.com/glight2000) ## 适用人群 @@ -31,3 +32,4 @@ Golang 编程:245386165 |更新日期 |更新内容 |----------|------------------ |2015-11-25|13.10 性能调试:分析并优化 Go 程序 +|2015-12-10|15.0 15.1 15.2 diff --git a/eBook/15.1.md b/eBook/15.1.md index 48f1764..c9354cd 100644 --- a/eBook/15.1.md +++ b/eBook/15.1.md @@ -183,8 +183,8 @@ func main() { con.Close() } ``` -**练习 15.1** 编写新版本的客户端和服务器(client1.to / server1.go): -* 增加一个检查错误的函数`checkError(error)`;讨论如下方案的利弊:为什么这个重构可能并没有那么理想?看看在示例15.14中它是如何被解决的 +**练习 15.1** 编写新版本的客户端和服务器([client1.go](exercises/chapter_15/client1.go) / [server1.go](exercises/chapter_15/server1.go)): +* 增加一个检查错误的函数`checkError(error)`;讨论如下方案的利弊:为什么这个重构可能并没有那么理想?看看在[示例15.14](examples/chapter_15/template_validation.go)中它是如何被解决的 * 使客户端可以通过发送一条命令SH来关闭服务器 * 让服务器可以保存已经连接的客户端列表(他们的名字);当客户端发送WHO指令的时候,服务器将显示如下列表: @@ -286,8 +286,7 @@ func checkError(error error, info string) { (**译者注:应该是由于go版本的更新,会提示os.EAGAIN undefined ,修改后的代码:[simple_tcp_server_v1.go](examples/chapter_15/simple_tcp_server_v1.go)**) 都有哪些改进? - -(1)服务器地址和端口不再是硬编码,而是通过命令行传入参数并通过`flag`包来读取这些参数。这里使用了`flag.NArg()`检查是否按照期望传入了2个参数: +* 服务器地址和端口不再是硬编码,而是通过命令行传入参数并通过`flag`包来读取这些参数。这里使用了`flag.NArg()`检查是否按照期望传入了2个参数: ```go if flag.NArg() != 2{ panic("usage: host port") @@ -297,11 +296,11 @@ func checkError(error error, info string) { ```go hostAndPort := fmt.Sprintf("%s:%s", flag.Arg(0), flag.Arg(1)) ``` -(2)在`initServer`函数中通过`net.ResolveTCPAddr`指定了服务器地址和端口,这个函数最终返回了一个`*net.TCPListener` -(3)每一个连接都会以携程的方式运行`connectionHandler`函数。这些开始于当通过`conn.RemoteAddr()`获取到客户端的地址 -(4)它使用`conn.Write`发送改进的go-message给客户端 -(5)它使用一个25字节的缓冲读取客户端发送的数据并一一打印出来。如果读取的过程中出现错误,代码会进入`switch`语句的`default`分支关闭连接。如果是操作系统的`EAGAIN`错误,它会重试。 -(6)所有的错误检查都被重构在独立的函数'checkError'中,用来分发出现的上下文错误。 +* 在`initServer`函数中通过`net.ResolveTCPAddr`指定了服务器地址和端口,这个函数最终返回了一个`*net.TCPListener` +* 每一个连接都会以携程的方式运行`connectionHandler`函数。这些开始于当通过`conn.RemoteAddr()`获取到客户端的地址 +* 它使用`conn.Write`发送改进的go-message给客户端 +* 它使用一个25字节的缓冲读取客户端发送的数据并一一打印出来。如果读取的过程中出现错误,代码会进入`switch`语句的`default`分支关闭连接。如果是操作系统的`EAGAIN`错误,它会重试。 +* 所有的错误检查都被重构在独立的函数'checkError'中,用来分发出现的上下文错误。 在命令行中输入`simple_tcp_server localhost 50000`来启动服务器程序,然后在独立的命令行窗口启动一些client.go的客户端。当有两个客户端连接的情况下服务器的典型输出如下,这里我们可以看到每个客户端都有自己的地址: ``` @@ -320,6 +319,7 @@ package net type Error interface{ Timeout() bool // 错误是否超时 Temporary() bool // 是否是临时错误 +} ``` 通过类型断言,客户端代码可以用来测试`net.Error`,从而区分哪些临时发生的错误或者必然会出现的错误。举例来说,一个网络爬虫程序在遇到临时发生的错误时可能会休眠或者重试,如果是一个必然发生的错误,则他会放弃继续执行。 ```go diff --git a/eBook/15.2.md b/eBook/15.2.md new file mode 100644 index 0000000..138a790 --- /dev/null +++ b/eBook/15.2.md @@ -0,0 +1,111 @@ +# 15.2 一个简单的网页服务器 + +Http是一个比tcp更高级的协议,它描述了客户端浏览器如何与网页服务器进行通信。Go有自己的`net/http`包,我们来看看它。我们从一些简单的示例开始, +首先编写一个“Hello world!”:[查看示例15.6](examples/chapter_15/hello_world_webserver.go) + +我们引入了`http`包并启动了网页服务器,和15.1的`net.Listen("tcp", "localhost:50000")`函数的tcp服务器是类似的,使用`http.ListenAndServe("localhost:8080", nil)`函数,如果成功会返回空,否则会返回一个错误(可以指定localhost为其他地址,8080是指定的端口号) + +`http.URL`描述了web服务器的地址,内含存放了url字符串的`Path`属性;`http.Request`描述了客户端请求,内含一个`URL`属性 + +如果`req`请求是一个POST类型的html表单,“var1”就是html表单中一个输入属性的名称,然后用户输入的值就可以通过GO代码:`req.FormValue("var1")`获取到(请看[章节15.4](15.4.md))。还有一种方法就是先执行`request.ParseForm()`然后再获取`request.Form["var1"]的第一个返回参数,就像这样: +```go + var1, found := request.Form["var1"] +``` +第二个参数`found`就是`true`,如果`var1`并未出现在表单中,`found`就是`false` + +表单属性实际上是一个`map[string][]string`类型。网页服务器返回了一个`http.Response`,它是通过`http.ResponseWriter`对象输出的,这个对象整合了HTTP服务器的返回结果;通过对它写入内容,我们就讲数据发送给了HTTP客户端。 + +现在我们还需要编写网页服务器必须执行的程序,它是如何处理请求的呢。这是在`http.HandleFunc`函数中完成的,就是在这个例子中当根路径“/”(url地址是http://localhost:8080)被请求的时候(或者这个服务器上的其他地址),`HelloServer`函数就被执行了。这个函数是`http.HandlerFunc`类型的,它们通常用使用Prehandler来命名,在前边加了一个Pref前缀。 + +`http.HandleFunc`注册了一个处理函数(这里是`HelloServer`)来处理对应`/`的请求。 + +`/`可以被替换为其他特定的url比如`/create`,`/edit`等等;你可以为每一个特定的url定义一个单独的处理函数。这个函数需要两个参数:第一个是`ReponseWriter`类型的`w`;第二个是请求`req`。程序向`w`写入了`Hello`和`r.URL.Path[1:]`组成的字符串后边的`[1:]`表示“创建一个从第一个字符到结尾的子切片”,用来丢弃掉路径开头的“/”,`fmt.Fprintf()`函数完成了本次写入(请看[章节12.8](12.8.md));另外一种写法是`io.WriteString(w, "hello, world!\n")` + +总结:第一个参数是请求的路径,第二个参数是处理这个路径请求的函数的引用。 + +示例 15.6 [hello_world_webserver.go](examples/chapter_15/hello_world_webserver.go): +```go +package main + +import ( + "fmt" + "log" + "net/http" +) + +func HelloServer(w http.ResponseWriter, req *http.Request) { + fmt.Println("Inside HelloServer handler") + fmt.Fprintf(w, "Hello,"+req.URL.Path[1:]) +} + +func main() { + http.HandleFunc("/", HelloServer) + err := http.ListenAndServe("localhost:8080", nil) + if err != nil { + log.Fatal("ListenAndServe: ", err.Error()) + } +} +``` +使用命令行启动程序,会打开一个命令窗口显示如下文字: +``` +Starting Process E:/Go/GoBoek/code_examples/chapter_14/hello_world_webserver.exe +... +``` +然后打开你的浏览器并输入url地址:`http://localhost:8080/world`,浏览器就会出现文字:`Hello, world`,网页服务器会响应你在`:8080/`后边输入的内容 + +使用`fmt.Println`在控制台打印状态,在每个handler被请求的时候,在他们内部打印日志会很有帮助 + +注: +1)前两行(没有错误处理代码)可以替换成以下写法: +```go +http.ListenAndServe(":8080", http.HandlerFunc(HelloServer)) +``` +2)`fmt.Fprint`和`fmt.Fprintf`都是用来写入`http.ResponseWriter`的不错的函数(他们实现了`io.Writer`)。 +比如我们可以使用 +```go +fmt.Fprintf(w, "