Go HTTP编程

时间  2020-01-11
标签 http 编程 栏目 HTTP/TCP 繁體版
原文   原文链接

目录golang

net/http介绍

Go语言标准库内建提供了net/http包，涵盖了HTTP客户端和服务端的具体实现。使用net/http包，咱们能够很方便地编写HTTP客户端或服务端的程序。json

HTTP服务端

默认的Server

首先，咱们编写一个最简单的Web服务器。编写这个Web服务只须要两步:浏览器

  1. 注册一个处理器函数（注册到DefaultServeMux）；安全

  2. 设置监听的TCP地址并启动服务；服务器

对应到咱们的代码里就是这样的：app

package main

import (
    "fmt"
    "net/http"
)

//say hello to the world
func sayHello(w http.ResponseWriter, r *http.Request) {
    //n, err := fmt.Fprintln(w, "hello world")
    _, _ = w.Write([]byte("hello world"))
}

func main() {

    //1.注册一个处理器函数
    http.HandleFunc("/", sayHello)

    //2.设置监听的TCP地址并启动服务
    //参数1:TCP地址(IP+Port)
    //参数2:handler handler参数通常会设为nil，此时会使用DefaultServeMux。
    err := http.ListenAndServe("127.0.0.1:9000", nil)
    if err != nil {
        fmt.Printf("http.ListenAndServe()函数执行错误,错误为:%v\n", err)
        return
    }
}

运行该程序，经过浏览器访问，能够看到hello world显示在了浏览器页面上函数

ListenAndServe使用指定的监听地址和处理器启动一个HTTP服务端。处理器参数一般是nil，这表示采用包变量DefaultServeMux做为处理器。post

Handle和HandleFunc函数能够向DefaultServeMux添加处理器。网站

http.HandleFunc

使用Go语言中的net/http包来编写一个简单的接收HTTP请求的Server端示例，net/http包是对net包的进一步封装，专门用来处理HTTP协议的数据。具体的代码以下：编码

处理器函数的实现原理:

经过源码可知，这个函数其实是调用了默认的serveMux的handleFunc方法, 这也解释了咱们第一步里所说的默认的实际注册到DefaultServeMux

既然说了http.ListenAndServe的第二个参数为nil时采用默认的DefaultServeMux,那么若是咱们不想采用默认的，而是想本身建立一个ServerMux该怎么办呢，http给咱们提供了方法

func NewServeMux() *ServeMux

NewServeMux建立并返回一个新的*ServeMux

若是是咱们本身建立的ServeMux，咱们只须要简单的更新一下代码:

package main

import (
    "fmt"
    "net/http"
)

//my goal is to become a gopher
func myGoal(w http.ResponseWriter, r *http.Request) {
    _, _ = w.Write([]byte("I wan`t to become a gopher."))
}

func main() {

    //1.注册一个处理器函数
    serveMux := http.NewServeMux()
    serveMux.HandleFunc("/", myGoal)

    //2.设置监听的TCP地址并启动服务
    //参数1:TCP地址(IP+Port)
    //参数2:handler 建立新的*serveMux,不使用默认的
    err := http.ListenAndServe("127.0.0.1:9000", serveMux)
    if err != nil {
        fmt.Printf("http.ListenAndServe()函数执行错误,错误为:%v\n", err)
        return
    }
}

运行修改后的代码，和采用默认ServeMux同样正常运行

http.Handle

若是是使用http的handle方法，则handle的第二个参数须要实现handler接口,要想实现这个接口，就得实现这个接口的serveHTTP方法

package main

import (
    "fmt"
    "net/http"
)
type MyHandler struct {}

//实现Handler接口
func (h *MyHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "goodbye")
}

func main() {
    var handler MyHandler
    http.Handle("/sayGoodbye", &handler)
    var err = http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Printf("http server failed, err: %v\n", err)
        return
    }
}

http.Request

一个Web服务器最基本的工做就是接收请求，作出响应。http包帮助咱们封装了一个Request结构体，咱们经过这个结构体拿到不少用户的一次HTTP请求的全部信息。这个Request结构体定义以下：

type Request struct {
    //Method指定HTTP方法（GET、POST、PUT等）。对客户端，""表明GET。
    Method string

    // 在客户端，URL的Host字段指定了要链接的服务器，
    // 而Request的Host字段（可选地）指定要发送的HTTP请求的Host头的值。
    URL *url.URL

    //接收到的请求的协议版本。本包生产的Request使用HTTP/1.1或者HTTP/2
    Proto      string // "HTTP/1.0"
    ProtoMajor int    // 1
    ProtoMinor int    // 0

    //Header字段用来表示HTTP请求的头域。
    Header Header

    //请求主题
    Body io.ReadCloser

    .....
}

我这里列举的并非完整的Request结构体定义，只是大体的说明一下。完整的定义以及这些字段的中文含义能够查看Go语言标准库中文文档,不过须要注意的是因为中文文档更新不及时(毕竟非官方)，会致使一些描述不许确，好比上面的Request结构体中的Proto请求协议版本字段在最新的Go版本中已经支持了HTTP/2，可是在其中的翻译仍是停留在老版本的只支持HTTP/1.1。因此英语好的同窗仍是更推荐看源码里的官方文档描述。

咱们经过经过浏览器能够发现，咱们一次HTTP请求会携带不少信息

这些信息，咱们能够用http.Request来获取到

示例代码:

package main

import (
    "fmt"
    "net/http"
)

func myHandler(w http.ResponseWriter, r *http.Request) {
    defer r.Body.Close()
    fmt.Println("Method: ", r.Method)
    fmt.Println("URL: ", r.URL)
    fmt.Println("header: ", r.Header)
    fmt.Println("body: ", r.Body)
    fmt.Println("RemoteAddr: ", r.RemoteAddr)
    w.Write([]byte("请求成功!!!"))
}
func main() {

    http.HandleFunc("/", myHandler)
    err := http.ListenAndServe("127.0.0.1:9000", nil)
    if err != nil {
        fmt.Printf("http.ListenAndServe()函数执行错误,错误为:%v\n", err)
        return
    }
}

自定义Server

要管理服务端的行为，能够建立一个自定义的Server：

import (
    "fmt"
    "net/http"
    "time"
)
type MyHandler struct {}

func (h *MyHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "hello world!")
}

func main() {
    var handler MyHandler
    var server = http.Server{
        Addr:              ":8080",
        Handler:           &handler,
        ReadTimeout:       2 * time.Second,
        MaxHeaderBytes: 1 << 20,
    }
    var err = server.ListenAndServe()
    if err != nil {
        fmt.Printf("http server failed, err: %v\n", err)
        return
    }
}

HTTP客户端

http包提供了不少访问Web服务器的函数，好比http.Get()、http.Post()、http.Head()等，读到的响应报文数据被保存在 Response 结构体中。

咱们能够看一下Response结构体的定义

type Response struct {
    Status     string // e.g. "200 OK"
    StatusCode int    // e.g. 200
    Proto      string // e.g. "HTTP/1.0"
    ProtoMajor int    // e.g. 1
    ProtoMinor int    // e.g. 0

    Header Header
    Body io.ReadCloser
    //...
}

上面只是Response的部分定义，完整的建议去查看源码。

服务器发送的响应包体被保存在Body中。可使用它提供的Read方法来获取数据内容。保存至切片缓冲区中，拼接成一个完整的字符串来查看。

结束的时候，须要调用Body中的Close()方法关闭io。

基本的HTTP/HTTPS请求

Get、Head、Post和PostForm函数发出HTTP/HTTPS请求。

resp, err := http.Get("http://example.com/")
...
resp, err := http.Post("http://example.com/upload", "image/jpeg", &buf)
...
resp, err := http.PostForm("http://example.com/form",
    url.Values{"key": {"Value"}, "id": {"123"}})

程序在使用完response后必须关闭回复的主体。

resp, err := http.Get("http://example.com/")
if err != nil {
    // handle error
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
// ...

GET请求示例

使用net/http包编写一个简单的发送HTTP请求的Client端，代码以下：

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {

    resp, err := http.Get("http://127.0.0.1:9000")
    if err != nil {
        fmt.Printf("http.Get()函数执行错误,错误为:%v\n", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)

    if err != nil {
        fmt.Printf("ioutil.ReadAll()函数执行出错,错误为:%v\n", err)
        return
    }

    fmt.Println(string(body))
}

将上面的代码保存以后编译成可执行文件，执行以后就能在终端打印请求成功!!!网站首页的内容了，咱们的浏览器其实就是一个发送和接收HTTP协议数据的客户端，咱们平时经过浏览器访问网页其实就是从网站的服务器接收HTTP数据，而后浏览器会按照HTML、CSS等规则将网页渲染展现出来。

带参数的GET请求示例

关于GET请求的参数须要使用Go语言内置的net/url这个标准库来处理。

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {

    //1.处理请求参数
    params := url.Values{}
    params.Set("name", "itbsl")
    params.Set("hobby", "fishing")

    //2.设置请求URL
    rawUrl := "http://127.0.0.1:9000"
    reqURL, err := url.ParseRequestURI(rawUrl)
    if err != nil {
        fmt.Printf("url.ParseRequestURI()函数执行错误,错误为:%v\n", err)
        return
    }

    //3.整合请求URL和参数
    //Encode方法将请求参数编码为url编码格式("bar=baz&foo=quux")，编码时会以键进行排序。
    reqURL.RawQuery = params.Encode()

    //4.发送HTTP请求
    //说明: reqURL.String() String将URL重构为一个合法URL字符串。
    resp, err := http.Get(reqURL.String())
    if err != nil {
        fmt.Printf("http.Get()函数执行错误,错误为:%v\n", err)
        return
    }
    defer resp.Body.Close()
    
    //5.一次性读取响应的全部内容
    body, err := ioutil.ReadAll(resp.Body)

    if err != nil {
        fmt.Printf("ioutil.ReadAll()函数执行出错,错误为:%v\n", err)
        return
    }

    fmt.Println(string(body))
}

对应的Server端代码以下：

package main

import (
    "fmt"
    "net/http"
)

func myHandler(w http.ResponseWriter, r *http.Request) {
    defer r.Body.Close()
    params := r.URL.Query()
    fmt.Fprintln(w, "name:", params.Get("name"), "hobby:", params.Get("hobby"))
}
func main() {

    http.HandleFunc("/", myHandler)
    err := http.ListenAndServe("127.0.0.1:9000", nil)
    if err != nil {
        fmt.Printf("http.ListenAndServe()函数执行错误,错误为:%v\n", err)
        return
    }
}

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))
}

自定义Client

要管理HTTP客户端的头域、重定向策略和其余设置，建立一个Client：

client := &http.Client{
    CheckRedirect: redirectPolicyFunc,
}
resp, err := client.Get("http://example.com")
// ...
req, err := http.NewRequest("GET", "http://example.com", nil)
// ...
req.Header.Add("If-None-Match", `W/"wyzzy"`)
resp, err := client.Do(req)
// ...

自定义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://example.com")

Client和Transport类型均可以安全的被多个goroutine同时使用。出于效率考虑，应该一次创建、尽可能重用。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程