Go语言学习笔记【17】 Go语言常见库：net/http、log

【声明】

非完全原创，部分内容来自于学习其他人的理论。如果有侵权，请联系我，可以立即删除掉。

一、net/http

该基础库提供了HTTP客户端和服务端的实现。使用此包，可以很方便地编写HTTP客户端或服务端的程序

1、http协议

超文本传输协议（Hyper Text Transfer Protocol，HTTP）是一个简单的请求-响应协议，它通常运行在TCP之上。它指定了客户端可能发送给服务器什么样的消息以及得到什么样的响应。请求和响应消息的头以ASCII形式给出；

HTTP协议通常承载于TCP协议之上，有时也承载于TLS或SSL协议层之上，这个时候，就成了我们常说的HTTPS。

1.1、http请求报文

HTTP 请求报文由请求行、请求头部、空行、请求包体4个部分组成

1.1.1、请求行

请求行由方法字段、URL 字段 和HTTP 协议版本字段 3 个部分组成，他们之间使用空格隔开。常用的 HTTP 请求方法有 GET、POST

• GET
  （1）当客户端要从服务器中读取某个资源时，使用GET 方法。GET 方法要求服务器将URL 定位的资源放在响应报文的数据部分，回送给客户端，即向服务器请求某个资源。
  （2）使用GET方法时，请求参数和对应的值附加在 URL 后面，利用一个问号(“?”)代表URL 的结尾与请求参数的开始，传递参数长度受限制，因此GET方法不适合用于上传数据。
  （3）通过GET方法来获取网页时，参数会显示在浏览器地址栏上，因此保密性很差
  （4）GET类似于读取资源，反复读取不应该对访问的数据有副作用，没有副作用被称为“幂等”。对GET请求数据的缓存可以做到浏览器本身上（彻底避免浏览器发请求），也可以做到代理上（如nginx），或者做到server端（用Etag，至少可以减少带宽消耗）

• POST
  （1）当客户端给服务器提供信息较多时可以使用POST 方法，POST 方法向服务器提交数据，比如完成表单数据的提交，将数据提交给服务器处理
  （2）GET 一般用于获取/查询资源信息，POST 会附带用户数据，一般用于更新资源信息。POST 方法将请求参数封装在HTTP 请求数据中，而且长度没有限制，因为POST携带的数据，在HTTP的请求正文中，以名称/值的形式出现，可以传输大量数据
  （3）POST请求的事往往有副作用、不幂等，即不能随意多次执行，因此也就不能缓存。如，POST下一个单，服务器创建了新的订单，然后返回订单成功的界面。这个页面不能被缓存

1.1.2、请求头部

请求头部为请求报文添加了一些附加信息，由“名/值”对组成，每行一对，名和值之间使用冒号分隔。
请求头部通知服务器有关于客户端请求的信息，典型的请求头有：

请求头	含义
User-Agent	请求的浏览器类型
Accept	客户端可识别的响应内容类型列表，星号“ * ”用于按范围将类型分组，用“ / ”指示可接受全部类型，用“ type/* ”指示可接受 type 类型的所有子类型
Accept-Language	客户端可接受的自然语言
Accept-Encoding	客户端可接受的编码压缩格式
Accept-Charset	可接受的应答的字符集
Host	请求的主机名，允许多个域名同处一个IP 地址，即虚拟主机
connection	连接方式(close或keepalive)
Cookie	存储于客户端扩展字段，向同一域名的服务端发送属于该域的cookie

1.1.3、空行

最后一个请求头之后是一个空行，发送回车符和换行符，通知服务器以下不再有请求头。

1.1.4、请求包体

请求包体不在GET方法中使用，而是POST方法中使用。
POST方法适用于需要客户填写表单的场合。与请求包体相关的最常使用的是包体类型Content-Type和包体长度Content-Length

1.2、http响应报文

HTTP 响应报文由状态行、响应头部、空行、响应包体4个部分组成

1.2.1、状态行

状态行由 HTTP 协议版本字段、状态码和状态码的描述文本3个部分组成，他们之间使用空格隔开。

状态码：
状态码由三位数字组成，第一位数字表示响应的类型，常用的状态码有五大类

状态码	含义
1xx	表示服务器已接收了客户端请求，客户端可继续发送请求
2xx	表示服务器已成功接收到请求并进行处理
3xx	表示服务器要求客户端重定向
4xx	表示客户端的请求有非法内容
5xx	表示服务器未能正常处理客户端的请求而出现意外错误

常见的状态码举例：

状态码	含义
200 OK	客户端请求成功
400 Bad Request	请求报文有语法错误
401 Unauthorized	未授权
403 Forbidden	服务器拒绝服务
404 Not Found	请求的资源不存在
500 Internal Server Error	服务器内部错误
503 Server Unavailable	服务器临时不能处理客户端请求(稍后可能可以)

1.2.2、响应头部

响应头	含义
Location	Location响应报头域用于重定向接受者到一个新的位置
Server	Server 响应报头域包含了服务器用来处理请求的软件信息及其版本
Vary	指示不可缓存的请求头列表
Connection	连接方式

1.2.3、空行

最后一个响应头部之后是一个空行，发送回车符和换行符，通知服务器以下不再有响应头部。

1.2.4、响应包体

服务器返回给客户端的文本信息

2、http客户端

2.1、客户端的代码格式

2.1.1、使用http默认的参数

Get、Head、Post和PostForm函数发出HTTP/ HTTPS请求。程序在使用完回复后必须关闭回复的主体。

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

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

2.1.2、自定义参数

要管理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)
// ...

要管理代理、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类型都可以安全的被多个go程同时使用。出于效率考虑，应该一次建立、尽量重用。

2.2、简单的GET请求示例

package main

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

func main() {
   
	resp, err := http.Get("http://www.baidu.com")
	if err != nil {
   
		log.Print(err)
		return
	}

	defer resp.Body.Close() //关闭

	fmt.Println("header = ", resp.Header)
	fmt.Printf("resp status %s\nstatusCode %d\n", resp.Status, resp.StatusCode)
	fmt.Printf("body type = %T\n", resp.Body)

	buf := make([]byte, 2048) //切片缓冲区
	var tmp string

	for {
   
		n, err := resp.Body.