重新学习web后端开发-002-hello, world-CSDN博客

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":""}
复制代码