javi-via-flickr-620x354.jpg
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:
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协议的内容，以及在正式项目实践中所需要关注的细节。
网友评论