8-常用標準庫之-Http
Http
Go語言內建的net/http包十分的優秀,提供了HTTP客戶端和服務端的實現。
1.1.1. net/http介紹
Go語言內建的net/http包提供了HTTP客戶端和服務端的實現。
1.1.2. HTTP協議
超文字傳輸協議(HTTP,HyperText Transfer Protocol)是網際網路上應用最為廣泛的一種網路傳輸協議,所有的WWW檔案都必須遵守這個標準。設計HTTP最初的目的是為了提供一種釋出和接收HTML頁面的方法。
1.1.3. HTTP客戶端
基本的HTTP/HTTPS請求 Get、Head、Post和PostForm函式發出HTTP/HTTPS請求。
resp, err := http.Get("http://5lmh.com/") ... resp, err := http.Post("http://5lmh.com/upload", "image/jpeg", &buf) ... resp, err := http.PostForm("http://5lmh.com/form", url.Values{"key": {"Value"}, "id": {"123"}})
程式在使用完response後必須關閉回覆的主體。
resp, err := http.Get("http://5lmh.com/")
if err != nil {
// handle error
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
// ...
1.1.4. GET請求示例
使用net/http包編寫一個簡單的傳送HTTP請求的Client端,程式碼如下:
package main import ( "fmt" "io/ioutil" "net/http" ) func main() { resp, err := http.Get("https://www.5lmh.com/") if err != nil { fmt.Println("get failed, err:", err) return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("read from resp.Body failed,err:", err) return } fmt.Print(string(body)) }
將上面的程式碼儲存之後編譯成可執行檔案,執行之後就能在終端列印liwenzhou.com網站首頁的內容了,我們的瀏覽器其實就是一個傳送和接收HTTP協議資料的客戶端,我們平時通過瀏覽器訪問網頁其實就是從網站的伺服器接收HTTP資料,然後瀏覽器會按照HTML、CSS等規則將網頁渲染展示出來。
1.1.5. 帶引數的GET請求示例
關於GET請求的引數需要使用Go語言內建的net/url這個標準庫來處理。
func main() { apiUrl := "http://127.0.0.1:9090/get" // URL param data := url.Values{} data.Set("name", "枯藤") data.Set("age", "18") u, err := url.ParseRequestURI(apiUrl) if err != nil { fmt.Printf("parse url requestUrl failed,err:%v\n", err) } u.RawQuery = data.Encode() // URL encode fmt.Println(u.String()) resp, err := http.Get(u.String()) if err != nil { fmt.Println("post failed, err:%v\n", err) return } defer resp.Body.Close() b, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("get resp failed,err:%v\n", err) return } fmt.Println(string(b)) }
對應的Server端HandlerFunc如下:
func getHandler(w http.ResponseWriter, r *http.Request) {
defer r.Body.Close()
data := r.URL.Query()
fmt.Println(data.Get("name"))
fmt.Println(data.Get("age"))
answer := `{"status": "ok"}`
w.Write([]byte(answer))
}
1.1.6. Post請求示例
上面演示了使用net/http包傳送GET請求的示例,傳送POST請求的示例程式碼如下:
package main
import (
"fmt"
"io/ioutil"
"net/http"
"strings"
)
// net/http post demo
func main() {
url := "http://127.0.0.1:9090/post"
// 表單資料
//contentType := "application/x-www-form-urlencoded"
//data := "name=枯藤&age=18"
// json
contentType := "application/json"
data := `{"name":"枯藤","age":18}`
resp, err := http.Post(url, contentType, strings.NewReader(data))
if err != nil {
fmt.Println("post failed, err:%v\n", err)
return
}
defer resp.Body.Close()
b, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("get resp failed,err:%v\n", err)
return
}
fmt.Println(string(b))
}
對應的Server端HandlerFunc如下:
func postHandler(w http.ResponseWriter, r *http.Request) {
defer r.Body.Close()
// 1. 請求型別是application/x-www-form-urlencoded時解析form資料
r.ParseForm()
fmt.Println(r.PostForm) // 列印form資料
fmt.Println(r.PostForm.Get("name"), r.PostForm.Get("age"))
// 2. 請求型別是application/json時從r.Body讀取資料
b, err := ioutil.ReadAll(r.Body)
if err != nil {
fmt.Println("read request.Body failed, err:%v\n", err)
return
}
fmt.Println(string(b))
answer := `{"status": "ok"}`
w.Write([]byte(answer))
}
1.1.7. 自定義Client
要管理HTTP客戶端的頭域、重定向策略和其他設定,建立一個Client:
client := &http.Client{
CheckRedirect: redirectPolicyFunc,
}
resp, err := client.Get("http://5lmh.com")
// ...
req, err := http.NewRequest("GET", "http://5lmh.com", nil)
// ...
req.Header.Add("If-None-Match", `W/"wyzzy"`)
resp, err := client.Do(req)
// ...
1.1.8. 自定義Transport
要管理代理、TLS配置、keep-alive、壓縮和其他設定,建立一個Transport:
tr := &http.Transport{
TLSClientConfig: &tls.Config{RootCAs: pool},
DisableCompression: true,
}
client := &http.Client{Transport: tr}
resp, err := client.Get("https://5lmh.com")
Client和Transport型別都可以安全的被多個go程同時使用。出於效率考慮,應該一次建立、儘量重用。
1.1.9. 服務端
預設的Server
ListenAndServe使用指定的監聽地址和處理器啟動一個HTTP服務端。處理器引數通常是nil,這表示採用包變數DefaultServeMux作為處理器。
Handle和HandleFunc函式可以向DefaultServeMux新增處理器。
http.Handle("/foo", fooHandler)
http.HandleFunc("/bar", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello, %q", html.EscapeString(r.URL.Path))
})
log.Fatal(http.ListenAndServe(":8080", nil))
預設的Server示例
使用Go語言中的net/http包來編寫一個簡單的接收HTTP請求的Server端示例,net/http包是對net包的進一步封裝,專門用來處理HTTP協議的資料。具體的程式碼如下:
// http server
func sayHello(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello 枯藤!")
}
func main() {
http.HandleFunc("/", sayHello)
err := http.ListenAndServe(":9090", nil)
if err != nil {
fmt.Printf("http server failed, err:%v\n", err)
return
}
}
將上面的程式碼編譯之後執行,開啟你電腦上的瀏覽器在位址列輸入127.0.0.1:9090回車,此時就能夠看到 Hello 枯藤!
自定義Server
要管理服務端的行為,可以建立一個自定義的Server:
s := &http.Server{
Addr: ":8080",
Handler: myHandler,
ReadTimeout: 10 * time.Second,
WriteTimeout: 10 * time.Second,
MaxHeaderBytes: 1 << 20,
}
log.Fatal(s.ListenAndServe())