阅读 75

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

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:

  • 这两个接口返回的区别一个返回的是字符串,一个返回的是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协议的内容,以及在正式项目实践中所需要关注的细节。