gopl-zh.github.com/ch1/ch1-07.md

164 lines
7.7 KiB
Markdown
Raw Normal View History

2015-12-09 07:45:11 +00:00
## 1.7. Web服務
2015-12-23 05:30:19 +00:00
Go語言的內置庫讓我們寫一個像fetch這樣例子的web服務器變得異常地簡單。在本節中我們會展示一個微型服務器這個服務的功能是返迴當前用戶正在訪問的URL。也就是説比如用戶訪問的是 http://localhost:8000/hello 那麽響應是URL.Path = "hello"。
2015-12-09 07:45:11 +00:00
```go
gopl.io/ch1/server1
// Server1 is a minimal "echo" server.
package main
import (
2015-12-23 05:30:19 +00:00
"fmt"
"log"
"net/http"
2015-12-09 07:45:11 +00:00
)
func main() {
2015-12-23 05:30:19 +00:00
http.HandleFunc("/", handler) // each request calls handler
log.Fatal(http.ListenAndServe("localhost:8000", nil))
2015-12-09 07:45:11 +00:00
}
// handler echoes the Path component of the request URL r.
func handler(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
fmt.Fprintf(w, "URL.Path = %q\n", r.URL.Path)
2015-12-09 07:45:11 +00:00
}
```
2015-12-26 12:05:30 +00:00
我們隻用了八九行代碼就實現了一個個Web服務程序這都是多虧了標準庫里的方法已經幫我們處理了大量的工作。main函數會將所有發送到/路徑下的請求和handler函數關聯起來/開頭的請求其實就是所有發送到當前站點上的請求我們的服務跑在了8000端口上。發送到這個服務的“請求”是一個http.Request類型的對象這個對象中包含了請求中的一繫列相關字段其中就包括我們需要的URL。當請求到達服務器時這個請求會被傳給handler函數來處理這個函數會將/hello這個路徑從請求的URL中解析出來然後把其發送到響應中這里我們用的是標準輸出流的fmt.Fprintf。Web服務會在第7.7節中詳細闡述。
2015-12-09 07:45:11 +00:00
2015-12-27 07:13:12 +00:00
讓我們在後台運行這個服務程序。如果你的操作繫統是Mac OS X或者Linux那麽在運行命令的末尾加上一個&符號卽可讓程序簡單地跑在後台而在windows下你需要在另外一個命令行窗口去運行這個程序了。
2015-12-09 07:45:11 +00:00
```
$ go run src/gopl.io/ch1/server1/main.go &
```
2015-12-18 02:53:03 +00:00
現在我們可以通過命令行來發送客戶端請求了:
2015-12-09 07:45:11 +00:00
```
$ go build gopl.io/ch1/fetch
$ ./fetch http://localhost:8000
URL.Path = "/"
$ ./fetch http://localhost:8000/help
URL.Path = "/help"
```
2015-12-18 06:49:31 +00:00
另外我們還可以直接在瀏覽器里訪問這個URL然後得到返迴結果如圖1.2
2015-12-23 05:30:19 +00:00
2015-12-09 07:45:11 +00:00
![](../images/ch1-02.png)
2015-12-26 12:05:30 +00:00
在這個服務的基礎上疊加特性是很容易的。一種比較實用的脩改是爲訪問的url添加某種狀態。比如下面這個版本輸出了同樣的內容但是會對請求的次數進行計算對URL的請求結果會包含各種URL被訪問的總次數直接對/count這個URL的訪問要除外。
2015-12-09 07:45:11 +00:00
```go
gopl.io/ch1/server2
// Server2 is a minimal "echo" and counter server.
package main
import (
2015-12-23 05:30:19 +00:00
"fmt"
"log"
"net/http"
"sync"
2015-12-09 07:45:11 +00:00
)
var mu sync.Mutex
var count int
func main() {
2015-12-23 05:30:19 +00:00
http.HandleFunc("/", handler)
http.HandleFunc("/count", counter)
log.Fatal(http.ListenAndServe("localhost:8000", nil))
2015-12-09 07:45:11 +00:00
}
// handler echoes the Path component of the requested URL.
func handler(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
mu.Lock()
count++
mu.Unlock()
fmt.Fprintf(w, "URL.Path = %q\n", r.URL.Path)
2015-12-09 07:45:11 +00:00
}
// counter echoes the number of calls so far.
func counter(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
mu.Lock()
fmt.Fprintf(w, "Count %d\n", count)
mu.Unlock()
2015-12-09 07:45:11 +00:00
}
```
2016-01-18 03:22:04 +00:00
這個服務器有兩個請求處理函數請求的url會決定具體調用哪一個對/count這個url的請求會調用到count這個函數其它所有的url都會調用默認的處理函數。如果你的請求pattern是以/結尾那麽所有以該url爲前綴的url都會被這條規則匹配。在這些代碼的背後服務器每一次接收請求處理時都會另起一個goroutine這樣服務器就可以同一時間處理多數請求。然而在併發情況下假如眞的有兩個請求同一時刻去更新count那麽這個值可能併不會被正確地增加這個程序可能會被引發一個嚴重的bug競態條件參見9.1。爲了避免這個問題我們必須保證每次脩改變量的最多隻能有一個goroutine這也就是代碼里的mu.Lock()和mu.Unlock()調用將脩改count的所有行爲包在中間的目的。第九章中我們會進一步講解共享變量。
2015-12-09 07:45:11 +00:00
2015-12-26 12:05:30 +00:00
下面是一個更爲豐富的例子handler函數會把請求的http頭和請求的form數據都打印出來這樣可以讓檢査和調試這個服務更爲方便
2015-12-09 07:45:11 +00:00
```go
gopl.io/ch1/server3
// handler echoes the HTTP request.
func handler(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
fmt.Fprintf(w, "%s %s %s\n", r.Method, r.URL, r.Proto)
for k, v := range r.Header {
fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
}
fmt.Fprintf(w, "Host = %q\n", r.Host)
fmt.Fprintf(w, "RemoteAddr = %q\n", r.RemoteAddr)
if err := r.ParseForm(); err != nil {
log.Print(err)
}
for k, v := range r.Form {
fmt.Fprintf(w, "Form[%q] = %q\n", k, v)
}
2015-12-09 07:45:11 +00:00
}
```
2015-12-26 12:05:30 +00:00
我們用http.Request這個struct里的字段來輸出下面這樣的內容
2015-12-09 07:45:11 +00:00
```
GET /?q=query HTTP/1.1
Header["Accept-Encoding"] = ["gzip, deflate, sdch"] Header["Accept-Language"] = ["en-US,en;q=0.8"]
Header["Connection"] = ["keep-alive"]
Header["Accept"] = ["text/html,application/xhtml+xml,application/xml;..."] Header["User-Agent"] = ["Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5)..."] Host = "localhost:8000"
RemoteAddr = "127.0.0.1:59911"
Form["q"] = ["query"]
```
2015-12-26 12:05:30 +00:00
可以看到這里的ParseForm被嵌套在了if語句中。Go語言允許這樣的一個簡單的語句結果作爲循環的變量聲明出現在if語句的最前面這一點對錯誤處理很有用處。我們還可以像下面這樣寫當然看起來就長了一些
2015-12-09 07:45:11 +00:00
```go
err := r.ParseForm()
if err != nil {
2015-12-23 05:30:19 +00:00
log.Print(err)
2015-12-09 07:45:11 +00:00
}
```
2015-12-23 05:30:19 +00:00
2015-12-18 06:49:31 +00:00
用if和ParseForm結合可以讓代碼更加簡單併且可以限製err這個變量的作用域這麽做是很不錯的。我們會在2.7節中講解作用域。
2015-12-09 07:45:11 +00:00
2015-12-26 12:05:30 +00:00
在這些程序中我們看到了很多不同的類型被輸出到標準輸出流中。比如前面的fetch程序就把HTTP的響應數據拷貝到了os.Stdout或者在lissajous程序里我們輸出的是一個文件。fetchall程序則完全忽略到了HTTP的響應體隻是計算了一下響應體的大小這個程序中把響應體拷貝到了ioutil.Discard。在本節的web服務器程序中則是用fmt.Fprintf直接寫到了http.ResponseWriter中。
2015-12-09 07:45:11 +00:00
2015-12-26 12:05:30 +00:00
盡管這三種具體的實現流程併不太一樣他們都實現一個共同的接口卽當它們被調用需要一個標準流輸出時都可以滿足。這個接口叫作io.Writer在7.1節中會詳細討論。
2015-12-09 07:45:11 +00:00
2015-12-26 12:05:30 +00:00
Go語言的接口機製會在第7章中講解爲了在這里簡單説明接口能做什麽讓我們簡單地將這里的web服務器和之前寫的lissajous函數結合起來這樣GIF動畵可以被寫到HTTP的客戶端而不是之前的標準輸出流。隻要在web服務器的代碼里加入下面這幾行。
2015-12-09 07:45:11 +00:00
2015-12-23 05:30:19 +00:00
```Go
2015-12-09 07:45:11 +00:00
handler := func(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
lissajous(w)
2015-12-09 07:45:11 +00:00
}
http.HandleFunc("/", handler)
```
或者另一種等價形式:
2015-12-23 05:30:19 +00:00
```Go
2015-12-09 07:45:11 +00:00
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
2015-12-23 05:30:19 +00:00
lissajous(w)
2015-12-09 07:45:11 +00:00
})
```
2015-12-18 02:53:03 +00:00
HandleFunc函數的第二個參數是一個函數的字面值也就是一個在使用時定義的匿名函數。這些內容我們會在5.6節中講解。
2015-12-09 07:45:11 +00:00
2015-12-23 05:30:19 +00:00
做完這些脩改之後,在瀏覽器里訪問 http://localhost:8000 。每次你載入這個頁面都可以看到一個像圖1.3那樣的動畵。
**練習 1.12** 脩改Lissajour服務從URL讀取變量比如你可以訪問 http://localhost:8000/?cycles=20 這個URL這樣訪問可以將程序里的cycles默認的5脩改爲20。字符串轉換爲數字可以調用strconv.Atoi函數。你可以在dodoc里査看strconv.Atoi的詳細説明。
2015-12-09 07:45:11 +00:00
![](../images/ch1-03.png)