UNIX is very simple, it just needs a genius to understand its simplicity. —— Dennis M.Ritchie
作者剛開始學(xué)習(xí)編程的時(shí)候游盲，學(xué)習(xí)的就是C語(yǔ)言。寫的第一個(gè)入門例子就是在控制臺(tái)上打印一句“hello, world"再登。后來(lái)陸續(xù)接觸了php溅固、java付秕、python、go等語(yǔ)言侍郭，發(fā)現(xiàn)入門第一個(gè)例子都是打印"hello, world"询吴。這已經(jīng)成為了業(yè)內(nèi)的慣例。那么我們也從這里開始亮元。
1. 第一個(gè)接口
話不多說(shuō)猛计，直接上代碼
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
r.GET("/hello", func(c *gin.Context) {
c.String(200, "hello, world")
})
r.GET("/helloJson", func(c *gin.Context) {
c.JSON(200, gin.H{"code": 0, "msg": "", "body": "hello, world"})
})
r.Run(":9800") // listen and serve on 0.0.0.0:9800
}
這段代碼非常簡(jiǎn)潔明了，運(yùn)行后將會(huì)在機(jī)器上綁定9800端口爆捞，映射了url "/hello"和"/helloJson"奉瘤，當(dāng)通過(guò)瀏覽器訪=問(wèn)"/hello"時(shí)，將在頁(yè)面上顯示hello, world煮甥，當(dāng)訪問(wèn)"/helloJson"時(shí)毛好，則會(huì)顯示一個(gè)json串
{"body":"hello, world","code":0,"msg":""}
Tip:
- 這兩個(gè)接口返回的區(qū)別一個(gè)返回的是字符串望艺，一個(gè)返回的是json串。
- 這里使用了go著名的web開源框架gin肌访，它簡(jiǎn)潔小巧且性能不錯(cuò)找默。
- go版本是1.11，沒(méi)有使用任何第三方包管理吼驶。當(dāng)前go版本開始內(nèi)置包管理工具：go module惩激，但還不是非常成熟，期待后續(xù)版本能較好的解決包管理問(wèn)題蟹演。因此风钻，你需要先通過(guò)go get安裝gin包。具體請(qǐng)參考gin文檔酒请。
- 可以直接clone git上的代碼骡技，點(diǎn)此查看，分支為feature/001-hello_world
2. 看看背后發(fā)生的事
2.1 "/hello" web交互過(guò)程
打開chrome瀏覽器羞反，并在地址欄輸入：http://localhost:9800/hello 布朦， 頁(yè)面將會(huì)顯示hello, world。實(shí)際上昼窗，我們向服務(wù)器9800端口發(fā)起了一個(gè)http請(qǐng)求是趴，同時(shí)服務(wù)器返回了一個(gè)http響應(yīng)。信息就在這類似”一問(wèn)一答“的方式下進(jìn)行傳輸交互澄惊。我們也可以使用chrome開發(fā)者工具唆途，看一看具體傳輸?shù)臄?shù)據(jù)內(nèi)容。
2.1.1 http請(qǐng)求
首先我們發(fā)起了了一個(gè)http請(qǐng)求掸驱，采用GET請(qǐng)求的方式肛搬，請(qǐng)求http://localhost:9800/hello ，請(qǐng)求的數(shù)據(jù)如下：
GET /hello HTTP/1.1
Host: localhost:9800
Connection: keep-alive
Pragma: no-cache
Cache-Control: no-cache
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
Accept-Encoding: gzip, deflate, br
Accept-Language: en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7
<上面一行是一個(gè)空行CRLF, 同時(shí)請(qǐng)忽略本行的說(shuō)明文字>
根據(jù)http v1.1協(xié)議規(guī)范[RFC 7230]毕贼，請(qǐng)求消息的格式為：
- 請(qǐng)求行 (例如: GET /hello HTTP/1.1)
- 請(qǐng)求頭 (例如: Host: localhost:9800)
- 一個(gè)空行滚婉，由CRLF，即回車(CR, ASCII 13, \r) 換行(LF, ASCII 10, \n)組成帅刀。
- 可選body消息
Tip:
- 請(qǐng)求行和請(qǐng)求頭必須要以CRLF結(jié)尾。
- 空行必須只包含CRLF远剩，不能包含其它字符包括空格扣溺。
- 除去可選body消息外，其余三個(gè)部分都是必須要有的瓜晤。
后續(xù)將會(huì)詳細(xì)介紹http請(qǐng)求的具體內(nèi)容锥余。
2.1.2 http響應(yīng)
服務(wù)接收到請(qǐng)求后返回響應(yīng)，響應(yīng)消息如下：
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Date: Tue, 15 Jan 2019 02:56:59 GMT
Content-Length: 12
hello, world
根據(jù)http v1.1協(xié)議規(guī)范痢掠，響應(yīng)消息格式為：
- 狀態(tài)行驱犹，包括狀態(tài)碼和簡(jiǎn)單描述 (例如：HTTP/1.1 200 OK)
- 響應(yīng)頭 (例如：Content-Type: text/plain; charset=utf-8)
- 一個(gè)空行
- 可選body消息
Tip:
- 狀態(tài)行和響應(yīng)頭必須要以CRLF結(jié)尾嘲恍。
- 空行必須只包含CRLF，不能包含其它字符包括空格雄驹。
2.2 "/helloJson" web交互過(guò)程
該接口返回的數(shù)據(jù)和"/hello"主要區(qū)別就是返回內(nèi)容的格式不一樣佃牛，一個(gè)是純文本字符串，一個(gè)是json字符串医舆。通過(guò)分析下http數(shù)據(jù)的交互俘侠，來(lái)了解下兩者之間的區(qū)別。
2.2.1 http請(qǐng)求
請(qǐng)求的部分除了GET部分蔬将，其它都一樣
GET /helloJson HTTP/1.1
...
2.2.2 http響應(yīng)
HTTP/1.1 200 OK
Content-Length: 41
Content-Type: application/json; charset=utf-8
Date: Wed, 16 Jan 2019 16:48:50 GMT
{"body":"hello, world","code":0,"msg":""}
響應(yīng)的部分主要區(qū)別在響應(yīng)頭的字段Content-Type的值不一樣爷速。這里是：application/json; charset=utf-8，意思是告訴客戶端返回的數(shù)據(jù)內(nèi)容格式為json霞怀，且編碼為utf-8
Tip: 當(dāng)今主流的web后端開發(fā)惫东，隨著前后端分離，主要就是接口開發(fā)毙石，其主要使用的數(shù)據(jù)格式是JSON廉沮。無(wú)論從可讀性，支持語(yǔ)言廣泛胁黑、客戶端易于解析等方面來(lái)看废封，JSON是現(xiàn)在主流的數(shù)據(jù)交換格式之一。
3. 小結(jié)
本節(jié)通過(guò)簡(jiǎn)單的接口實(shí)例丧蘸，介紹了背后http傳輸?shù)幕拘畔⑵蟆Ｏ乱还?jié)開始，我們將詳細(xì)介紹作為web后端開發(fā)人員力喷，必須要了解掌握的http協(xié)議的內(nèi)容刽漂，以及在正式項(xiàng)目實(shí)踐中所需要關(guān)注的細(xì)節(jié)。
