继续浏览精彩内容
慕课网APP
程序员的梦工厂
打开
继续
感谢您的支持,我会继续努力的
赞赏金额会直接到老师账户
将二维码发送给自己后长按识别
微信支付
支付宝支付

Go Web 编程之 请求

慕函数6118139
关注TA
已关注
手记 3
粉丝 0
获赞 3

概述

前面我们学习了处理器和处理器函数,如何编写和注册处理器。这里我们将学习如何从请求中获取信息。

请求的结构

通过前面的学习,我们知道处理器函数需要符合下面的签名:

golang
FUNC(W http.ResponseWriter,R * http.Request) 其中, http.Request 就是请求的类型客户端传递的数据都可以通过这个结构来获取结构。'请求“定义在包网/ HTTP中: golang // SRC / NET / HTTP / request.go类型请求结构{方法字符串URL * url.URL原字符串ProtoMajor INT ProtoMinor INT标头标头io.ReadCloser的ContentLength INT / /省略一些逗号…} 我们来看一下几个重要的细分。###方法请求中的 ``表示客户端想要调用服务器的一种方法。在[第一篇文章(https://darjun.github.io)中,我们提到过HTTP协议方法。其取值有GET / POST / PUT / DELETE等。服务器根据请求方法的不同会进行不同的处理,例如“ GET方法只是获取信息(用户基本信息,商品信息等),POST`方法创建新的资源(注册新用户,上架新商品等)。### URLURL Tim Berners-Lee在创造地球的同时,也约会了使用串口来表示互联网资 。他称该字符串为统一资源标识符(URI,统一资源标识符)。URI由两部分组成。一部分表示资源的名称,即统一资源名称(URN,统一资源)。)。名称)。另一部分表示资源的位置,即统一资源定位符(URL,统一资源位置)。在HTTP请求中,使用URL来对要操作的资源位置进行描述。URL的一般格式为:```

[方案:] [?查询] [// [userinfo的@]主机] [/]的路径[#片段] *`scheme:协议名,常见的有`httphttpsftp`;*` userInfo`:若有,则表示用户信息,如用户名和密码可写`dj:password`;*`host`:表示主机域名或地址,和一个可选的端口信息。 80。例如`www.example.com`,`www.example.com:8080`,`127.0.0.1:8080`;*` path` :资源在主机上的路径,以`/`分隔,如`/ posts`;*`query`:任选的查询字符串,客户端传输过来的键值对参数,键值直接用`=`,多个键值对之间用`&`连接,如`page = 1&count = 10`;*`fragment`:片段,又叫锚点。表示一个页面中的位置信息。由浏览器发起的请求URL中,通常没有这部分信息。但是可以通过`ajax`等代码的方式发送这个数据;我们来看一个完整的URL:

http:// dj:password@www.example.com/posts?page = 1&count = 10#fmt


Go 中的 URL 结构定义在`net/url`包中:

```golang
// net/url/url.go
type URL struct {
    Scheme      string
    Opaque      string
    User        *Userinfo
    Host        string
    Path        string
    RawPath     string
    RawQuery    string
    Fragment    string
}

可以通过请求对象中的URL变量获取这些信息。接着,我们编写一个程序来具体看看(使用上一篇文章讲的Web。)程序基本结构,只需要增加处理器函数和注册即可):

func urlHandler(w http.ResponseWriter, r *http.Request) {
    URL := r.URL
    
    fmt.Fprintf(w, "Scheme: %s\n", URL.Scheme)
    fmt.Fprintf(w, "Host: %s\n", URL.Host)
    fmt.Fprintf(w, "Path: %s\n", URL.Path)
    fmt.Fprintf(w, "RawPath: %s\n", URL.RawPath)
    fmt.Fprintf(w, "RawQuery: %s\n", URL.RawQuery)
    fmt.Fprintf(w, "Fragment: %s\n", URL.Fragment)
}

// 注册
mux.HandleFunc("/url", urlHandler)

运行服务器,通过浏览器访问localhost:8080/url/posts?page=1&count=10#main

Scheme: 
Host: 
Path: /url/posts
RawPath: 
RawQuery: page=1&count=10
Fragment:

为什么会出现空洞?注意原始Request结构中URL界上有一段注释:

// URL specifies either the URI being requested (for server
// requests) or the URL to access (for client requests).
//
// For server requests, the URL is parsed from the URI
// supplied on the Request-Line as stored in RequestURI.  For
// most requests, fields other than Path and RawQuery will be
// empty. (See RFC 7230, Section 5.3)
//
// For client requests, the URL's Host specifies the server to
// connect to, while the Request's Host field optionally
// specifies the Host header value to send in the HTTP
// request.

大意是作为服务器收到的请求时,URL中除了Path状语从句:RawQuery,其它字段大多为空。对于这个问题,围棋的Github的仓库上发行28940有过讨论。

我们还可以通过URL结构得到一个URL字符串:

URL := &net.URL {
    Scheme:     "http",
    Host:       "example.com",
    Path:       "/posts",
    RawQuery:   "page=1&count=10",
    Fragment:   "main",
}
fmt.Println(URL.String())

上面的程序运行输出字符串:

http://example.com/posts?page=1&count=10#main

Proto/ProtoMajor/ProtoMinor

Proto表示HTTP协议版本,如HTTP/1.1ProtoMajor表示大版本,ProtoMinor表示小版本。

func protoFunc(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Proto: %s\n", r.Proto)
    fmt.Fprintf(w, "ProtoMajor: %d\n", r.ProtoMajor)
    fmt.Fprintf(w, "ProtoMinor: %d\n", r.ProtoMinor)
}

mux.HandleFunc("/proto", protoFunc)

启动服务器,浏览器请求localhost:8080返回:

Proto: HTTP/1.1
ProtoMajor: 1
ProtoMinor: 1

当前HTTP / 1.1是主流的版本。

Header

Header中存放的客户端发送过来的首部信息,键-值对的形式。Header类型暂时其实是map[string][]string

// src/net/http/header.go
type Header map[string][]string

每个首部的键和值都是字符串,可以设置多个相同的键。注意Header变量[]string类型,放置相同的键的多个值。浏览器发起HTTP请求的时候,会自动添加一些首部。编写一个程序来看看:

func headerHandler(w http.ResponseWriter, r *http.Request) {
    for key, value := range r.Header {
        fmt.Fprintf(w, "%s: %v\n", key, value)
    }
}

mux.HandleFunc("/header", headerHandler)

启动服务器,浏览器请求localhost:8080/header返回:

Accept-Encoding: [gzip, deflate, br]
Sec-Fetch-Site: [none]
Sec-Fetch-Mode: [navigate]
Connection: [keep-alive]
Upgrade-Insecure-Requests: [1]
User-Agent: [Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36]
Sec-Fetch-User: [?1]
Accept: [text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3]
Accept-Language: [zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7]

我使用的是Chrome浏览器,不同的浏览器添加的首部不完全相同。

常见的首部有:

  • Accept:客户端所需服务器发送的内容类型;
  • Accept-Charset:表示客户端能接受的字符编码;
  • Content-Length:请求主体的字节长度,一般在POST / PUT请求中位数;
  • Content-Type:当包含请求主体的时候,这个首部用于记录主体内容的类型。在发送POST或PUT请求时,内容的类型为x-www-form-urlecoded。。但是在上传文件时,应该设置类型为multipart/form-data
  • User-Agent:用于描述发起请求的客户端信息,如什么浏览器。

Content-Length/Body

Content-Length表示请求体的字节长度,请求体的内容可以从Body分段中读取。细心的朋友可能发现了Body片段是一个io.ReadCloser接口。在读取之后要关闭它,否则会有资源替代。可以使用defer简化代码编写

func bodyHandler(w http.ResponseWriter, r *http.Request) {
    data := make([]byte, r.ContentLength)
    r.Body.Read(data) // 忽略错误处理
    defer r.Body.Close()
    
    fmt.Fprintln(w, string(data))
}

mux.HandleFunc("/body", bodyHandler)

上面的代码将客户端传来的请求体内容回传给客户端。还可以使用io/ioutil包简化读取操作:

data, _ := ioutil.ReadAll(r.Body)

直接在浏览器中输入URL发起的是GET请求,无法携带请求体。有很多种方式可以发起带请求体的请求,下面介绍两种:

使用表格

通过HTML的表单我们可以向服务器发送POST请求,将表单中的内容作为请求体发送。

func indexHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, `
<html>
    <head>
        <title>Go Web 编程之 request</title>
    </head>
    <body>
        <form method="post" action="/body">
            <label for="username">用户名:</label>
            <input type="text" id="username" name="username">
            <label for="email">邮箱:</label>
            <input type="text" id="email" name="email">
            <button type="submit">提交</button>
        </form>
    </body>
</html>
`)
}

mux.HandleFunc("/", indexHandler)

在HTML中使用form来显示一个表单。点击提交按钮后,浏览器会发送一个POST请求到路径/body上,将用户名和邮箱作为请求包体。

启动服务器,进入主页localhost:8080/,显示表单。填写信息,点击提交:

浏览器向服务器发送POST请求,URL为/bodybodyHandler处理完成后将包体回传给客户端。最后客户端显示:

顶部的数据使用了x-www-form-urlencoded编码,这是表单的替代编码。后文还有替代。

使用邮递员

Postman是一款功能非常强大的API测试工具。

  • 支持HTTP协议的所有方法请求(GET/POST/PUT/DELETE)。
  • 可以在请求中携带首部信息,请求体的内容;
  • 支持json/xml/http等各种格式的内容;
  • 界面友好。

接下来我们看看如何使用PostMan测试我们的bodyHandler

  • 黑色部分:选择HTTP协议方法,此处选择POST可以打开请求体;
  • 绿色部分:请求的URL;
  • 蓝色部分:可以设置请求的首部,请求体;
  • 淡红色部分:请求体支持多种格式,这里选择原始格式;
  • 灰色部分:请求体的具体内容;
  • 红色部分:发送之后显示的响应信息,可以查看响应首部,Cookie,响应体等。可以看到是原样返回。

获取请求参数

上面我们分析了Go中HTTP请求的通用分支。在实际开发中,客户端通常需要在请求中传递一些参数。参数传递的方式一般有两种方式:

  • URL中的键值对,又叫查询字符串,即查询字符串;
  • 表单。

下面依次来介绍。

URL键值对

前文中介绍URL的一般格式时提到过,URL的后面可以跟一个可选的查询字符串,以?与路径分隔,形如key1=value1&key2=value2

URL结构中有一个RawQuery细分。这个细分就是查询字符串。

func queryHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, r.URL.RawQuery)
}

mux.HandleFunc("/query", queryHandler)

如果我们以localhost:8080/query?name=dj&age=20请求,查询字符串name=dj&age=20会原样传回客户端。但是RawQuery是串行类型的,使用串行方法解析也能用,但是太麻烦了!!!

表单

表单狭义上说是通过表单发送请求,广义上说可以将数据放在请求实体中发送到服务器。接下来我们简单地编写一个HTML页面,通过页面表单发送HTTP请求:

<html>
    <head>
        <title>Go Web 编程之 request</title>
    </head>
    
    <body>
        <form action="/form?lang=cpp&name=dj" method="post" enctype="application/x-www-form-urlencoded">
            <label>Form:</label>
            <input type="text" name="lang" />
            <input type="text" name="age" />
            <button type="submit">提交</button>
        </form>
    </body>
</html>
  • action表示提交表单时请求的URL,method表示请求的方法。如果使用GET请求,由于GET方法没有请求体,参数将会分解到URL尾部
  • enctype指定请求体的编码方式,替代为application/x-www-form-urlencoded。如果需要发送文件,必须指定为multipart/form-data

介绍我们什么一下的英文urlencoded编码.RFC 3986中定义了URL中的保留字以及非保留字,所有保留字符都需要进行URL编码.URL编码会把字符转换成它在ASCII编码中对应的字节值,接着把这个字节值表示为一个两个长的十六进制数字,最后在这个数字前面加上一个百分号(%)。例如空格的ASCII编码为32,十六进制为20,故URL编码为%20

Form初步

使用x-www-form-urlencoded编码的请求体,在处理时首先调用请求的ParseForm方法解析,然后从Form分段中取数据:

func formHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseForm()
    fmt.Fprintln(w, r.Form)
}

mux.HandleFunc("/form", formHandler)

运行程序,验证结果:

Form初始的类型url.Values实际实际上是map[string][]string。调用ParseForm方法之后,可以使用url.Values的方法操作数据。

使用ParseForm还能解析查询字符串,将上面的表单替换:

<html>
    <head>
        <title>Go Web 编程之 request</title>
    </head>
    
    <body>
        <form action="/form?lang=cpp&name=dj" method="post" enctype="application/x-www-form-urlencoded">
            <label>Form:</label>
            <input type="text" name="lang" />
            <input type="text" name="age" />
            <button type="submit">提交</button>
        </form>
    </body>
</html>

请求结果:

可以抛光,查询字符串中的键值对和表单中解析处理的合并到一起了。同一个键下,表单值总是排在前面,如[golang cpp]

PostForm初步

如果一个请求,同时有URL键值对和表单数据,而用户只想获取表单数据,可以使用PostForm细分。

使用PostForm只会返回表单数据,不包括URL键值。如果把上面的程序中,r.Form改为r.PostForm,那么程序将显示以下结果:

MultipartForm初步

如果要处理上传的文件,那么就必须使用multipart/form-data编码。与之前的Form/PostForm类似,处理multipart/form-data编码的请求时,也需要先解析后使用。只不过使用的方法不同,解析使用ParseMultipartForm,之后从MultipartForm分段取值。

<form action="/multipartform?lang=cpp&name=dj" method="post" enctype="multipart/form-data">
	<label>MultipartForm:</label>
    <input type="text" name="lang" />
    <input type="text" name="age" />
    <input type="file" name="uploaded" />
    <button type="submit">提交</button>
</form>
func multipartFormHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseMultipartForm(1024)
    fmt.Fprintln(w, r.MultipartForm)
    
    fileHeader := r.MultipartForm.File["uploaded"][0]
	file, err := fileHeader.Open()
	if err != nil {
		fmt.Println("Open failed: ", err)
		return
	}

	data, err := ioutil.ReadAll(file)
	if err == nil {
		fmt.Fprintln(w, string(data))
	}
}

mux.HandleFunc("/multipartform", multipartFormHandler)

运行程序:

MultipartForm包含两个map类型的细分,一个表示表单键值对,另一个为上传的文件信息。

使用表单中文件控件名称获取MultipartForm.File通过该控件上传的文件,可以是多个。得到的是multipart.FileHeader类型,通过该类型可以获取文件的各个属性。

需要注意的是,这种方式用来处理文件。为了安全,ParseMultipartForm方法需要传一个参数,表示最大使用内存,避免上传的文件占用空间过大。

FormValue/PostFormValue

为了方便地获取值,net/http包提供了FormValue/PostFormValue方法。它们在需要时会自动调用ParseForm/ParseMultipartForm方法。

FormValue报道查看方法的请求字段中指定键的值。如果同一个键对应多个值,报道查看那么第一个如果需要电子杂志全部值,直接使用。字段下面代码将返回。你好对应的第一个值:

golang fmt.Fprintln(W,r.FormValue(“你好”)) PostFormValue报道查看方法的请求PostForm字段中指定键的值。如果同一个键对应多个值,报道查看那么第一个如果需要电子杂志全部值,直接使用。PostForm字段注意:编码当被指定为的多部分/格式数据的时,FormValue / PostFormValue将不会返回任何值,这些读取的是窗体/ PostForm细分,而ParseMultipartForm将数据写入`

分段####其他格式通过AJAX之类的技术可以发送其他格式的数据,例如,'应用/ JSON'等这种情况下:*首先通过首部'的内容类型的来获知具体是什么格式; *通过r.Body读取字节流; *解码使用。##译者总结介绍了网/ HTTP包中请求的各方面内容。从'请求'结构到如何传递参数,最后介绍各种编码的请求如何处理。##参考1个转到网络编程](HTTPS ://book.douban.com/subject/27204133/)2。[net / http](https://golang.org/pkg/net/http/)标准库文档##我[我的博客](https ://darjun.github.io

打开App,阅读手记
0人推荐
发表评论
随时随地看视频慕课网APP