UNIX is very simple, it just needs a genius to understand its simplicity. —— Dennis M.Ritchie
作者刚开始学习编程的时候,学习的就是C语言。写的第一个入门例子就是在控制台上打印一句“hello, world"。后来陆续接触了php、java、python、go等语言,发现入门第一个例子都是打印"hello, world"。这已经成为了业内的惯例。那么我们也从这里开始。
1. 第一个接口
话不多说,直接上代码
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
}
这段代码非常简洁明了,运行后将会在机器上绑定9800端口,映射了url "/hello"和"/helloJson",当通过浏览器访=问"/hello"时,将在页面上显示hello, world,当访问"/helloJson"时,则会显示一个json串
{"body":"hello, world","code":0,"msg":""}
Tip:
- 这两个接口返回的区别一个返回的是字符串,一个返回的是json串。
- 这里使用了go著名的web开源框架gin,它简洁小巧且性能不错。
- go版本是1.11,没有使用任何第三方包管理。当前go版本开始内置包管理工具:go module,但还不是非常成熟,期待后续版本能较好的解决包管理问题。因此,你需要先通过go get安装gin包。具体请参考gin文档。
- 可以直接clone git上的代码,点此查看,分支为feature/001-hello_world
2. 看看背后发生的事
2.1 "/hello" web交互过程
打开chrome浏览器,并在地址栏输入:http://localhost:9800/hello , 页面将会显示hello, world。实际上,我们向服务器9800端口发起了一个http请求,同时服务器返回了一个http响应。信息就在这类似”一问一答“的方式下进行传输交互。我们也可以使用chrome开发者工具,看一看具体传输的数据内容。
2.1.1 http请求
首先我们发起了了一个http请求,采用GET请求的方式,请求http://localhost:9800/hello ,请求的数据如下:
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
<上面一行是一个空行CRLF, 同时请忽略本行的说明文字>
根据http v1.1协议规范[RFC 7230],请求消息的格式为:
- 请求行 (例如: GET /hello HTTP/1.1)
- 请求头 (例如: Host: localhost:9800)
- 一个空行,由CRLF,即回车(CR, ASCII 13, \r) 换行(LF, ASCII 10, \n)组成。
- 可选body消息
Tip:
- 请求行和请求头必须要以CRLF结尾。
- 空行必须只包含CRLF,不能包含其它字符包括空格。
- 除去可选body消息外,其余三个部分都是必须要有的。
后续将会详细介绍http请求的具体内容。
2.1.2 http响应
服务接收到请求后返回响应,响应消息如下:
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
根据http v1.1协议规范,响应消息格式为:
- 状态行,包括状态码和简单描述 (例如:HTTP/1.1 200 OK)
- 响应头 (例如:Content-Type: text/plain; charset=utf-8)
- 一个空行
- 可选body消息
Tip:
- 状态行和响应头必须要以CRLF结尾。
- 空行必须只包含CRLF,不能包含其它字符包括空格。
2.2 "/helloJson" web交互过程
该接口返回的数据和"/hello"主要区别就是返回内容的格式不一样,一个是纯文本字符串,一个是json字符串。通过分析下http数据的交互,来了解下两者之间的区别。
2.2.1 http请求
请求的部分除了GET部分,其它都一样
GET /helloJson HTTP/1.1
...
2.2.2 http响应
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":""}
响应的部分主要区别在响应头的字段Content-Type的值不一样。这里是:application/json; charset=utf-8,意思是告诉客户端返回的数据内容格式为json,且编码为utf-8
Tip: 当今主流的web后端开发,随着前后端分离,主要就是接口开发,其主要使用的数据格式是JSON。无论从可读性,支持语言广泛、客户端易于解析等方面来看,JSON是现在主流的数据交换格式之一。
3. 小结
本节通过简单的接口实例,介绍了背后http传输的基本信息。下一节开始,我们将详细介绍作为web后端开发人员,必须要了解掌握的http协议的内容,以及在正式项目实践中所需要关注的细节。