Golang使用Reqhttp客户端创建HTTP请求

GoReq教程展示了如何使用Reqhttp客户端创建HTTP请求。http客户端发送HTTP请求并从由URL标识的资源接收HTTP响应。

$ go version
go version go1.18.1 linux/amd64

我们使用Go版本1.18。

HTTP

超文本传输​​协议(HTTP)是分布式协作超媒体信息系统的应用协议。HTTP协议是万维网数据通信的基础。

要求

Req是一个具有很多功能的第三方HTTP客户端。它具有许多方便的功能，便于配置、调试和测试。

响应状态码

HTTP响应状态代码指示特定HTTP请求是否已成功完成。有五个组可用：

• 信息响应(100-199)
• 成功响应(200-299)
• 重定向(300-399)
• 客户端错误(400-499)
• 服务器错误(500-599)

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.Get("http://webcode.me")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res.Status)
    fmt.Println(res.StatusCode)
}

该示例创建了一个对小型网站的GET请求。我们得到请求的状态码。

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

我们导入req包。

res, err := req.Get("http://webcode.me")

Get

fmt.Println(res.Status)
fmt.Println(res.StatusCode)

StatusStatusCode

进入请求开发模式

DevMode

package main

import (
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    req.DevMode()

    _, err := req.Get("http://webcode.me")

    if err != nil {
        log.Fatal(err)
    }
}

我们在开发模式下创建一个简单的GET请求。

$ go run main.go
2022/05/31 12:39:14.685055 DEBUG [req] HTTP/1.1 GET http://webcode.me
GET / HTTP/1.1
Host: webcode.me
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...
Accept-Encoding: gzip

HTTP/1.1 200 OK
Server: nginx/1.6.2
Date: Tue, 31 May 2022 10:39:14 GMT
Content-Type: text/html
...

GoReqGET请求

以下示例在Req中创建一个简单的GET请求。

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.Get("http://webcode.me")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)

    bytes, err := res.ToBytes()

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(string(bytes))
}

webcode.me

res, err := req.Get("http://webcode.me")

Get

if err != nil {
    log.Fatal(err)
}

我们检查错误。

fmt.Println(res)

我们打印响应。

bytes, err := res.ToBytes()
...
fmt.Println(string(bytes))

或者，我们可以获取字节并将它们转换为字符串。

GoReqHEAD请求

如果使用HTTPGET方法请求指定的资源，则HTTPHEAD方法请求返回的标头。

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.Head("http://webcode.me")

    if err != nil {
        log.Fatal(err)
    }

    for k, v := range res.Header {
        fmt.Printf("%s %s\n", k, v)
    }
}

Head

$ go run main.go
Connection [keep-alive]
Etag ["61ed305d-18a"]
Content-Type [text/html]
Content-Length [394]
Last-Modified [Sun, 23 Jan 2022 10:39:25 GMT]
Server [nginx/1.6.2]
Date [Tue, 31 May 2022 10:50:54 GMT]
Accept-Ranges [bytes]

去请求用户代理

User-Agent

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.C().SetUserAgent("Go program").
        R().Get("http://webcode.me/ua.php")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

SetUserAgent

res, err := req.C().SetUserAgent("Go program").
    R().Get("http://webcode.me/ua.php")

CR

$ go run main.go 
Go program

查询参数

查询参数是统一资源定位器(URL)的一部分，它为指定的参数赋值。这是将数据发送到目标服务器的一种方式。

http://example.com/api/users?name=John%20Doe&occupation=gardener

%20

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.C().R().Get("http://localhost:8080/hello?name=Peter")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

name=PeterSetQueryParam

为了测试示例，我们使用Echo框架创建了一个简单的服务器。

package main

import (
    "fmt"
    "net/http"

    "github.com/labstack/echo/v4"
)

func main() {

    e := echo.New()

    e.GET("/hello/:name/", func(c echo.Context) error {

        name := c.Param("name")
        msg := fmt.Sprintf("Hello %s!", name)
        return c.String(http.StatusOK, msg)
    })

    e.Logger.Fatal(e.Start(":8080"))
}

Param

路径参数

值可以通过查询参数或路径参数发送到服务器。path参数直接在URL路径中指定。

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    res, err := req.C().R().SetPathParam("name", "Peter").
        Get("http://localhost:8080/hello/{name}/")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

SetPathParam

以下服务器示例处理带有路径变量的请求。

package main

import (
    "fmt"
    "net/http"

    "github.com/labstack/echo/v4"
)

func main() {

    e := echo.New()

    e.GET("/hello/:name/", func(c echo.Context) error {

        name := c.Param("name")
        msg := fmt.Sprintf("Hello %s!", name)
        return c.String(http.StatusOK, msg)
    })

    e.Logger.Fatal(e.Start(":8080"))
}

Param

下载文件

以下示例下载一个二进制文件。

package main

import (
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    client := req.C()

    url := "http://webcode.me/favicon.ico"

    _, err := client.R().SetOutputFile("favicon.ico").Get(url)

    if err != nil {
        log.Fatal(err)
    }
}

SetOutputFile

上传文件

下一个示例上传一个二进制文件。

package main

import (
    "fmt"
    "log"

    "github.com/imroc/req/v3"
)

func main() {

    client := req.C()

    res, err := client.R().
        SetFile("file", "sid.png").
        Post("http://localhost:8080/upload")

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res.Status)
}

SetFile

我们创建一个服务器来处理请求。

package main

import (
    "io"
    "net/http"
    "os"

    "github.com/labstack/echo/v4"
)

func upload(c echo.Context) error {

    file, err := c.FormFile("file")

    if err != nil {
        return err
    }

    src, err := file.Open()

    if err != nil {
        return err
    }

    defer src.Close()

    dst, err := os.Create(file.Filename)

    if err != nil {
        return err
    }

    defer dst.Close()

    if _, err = io.Copy(dst, src); err != nil {
        return err
    }

    return c.HTML(http.StatusOK, "File uploaded")
}

func main() {

    e := echo.New()

    e.POST("/upload", upload)

    e.Logger.Fatal(e.Start(":8080"))
}

服务器从请求中读取二进制数据并将其写入文件系统。

在本教程中，我们使用了ReqHTTP客户端。

列出所有Go教程。