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

作者刚开始学习编程的时候，学习的就是C语言。写的第一个入门例子就是在控制台上打印一句“hello, world"。后来陆续接触了 php 、 java 、 python 、 go 等语言，发现入门第一个例子都是打印"hello, world"。这已经成为了业内的惯例。那么我们也从这里开始。

<!-- more -->

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":""}

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消息

后续将会详细介绍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消息

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协议的内容，以及在正式项目实践中所需要关注的细节。

本文为作者原创作品，属于《重新学习web后端开发》专辑中的一篇，转载时请备注作者信息及来源。本文原文地址： https://www.donnyzhang.com/20...