前言

感谢开源项目gin-vue-admin，以及1010工作室的视频教程

本人学识尚浅，如有错误，请评论指出，谢谢！

详细可见个人博客：https://linzyblog.netlify.app/

一、HTTP请求类型

http协议中一共定义了八种方法或者称之为类型来表明对请求网络资源（Request-URI）的不同的操作方式，分别是：OPTIONS、HEAD、GET、POST、PUT、DELETE、TRACE、CONNECT。

HTTP 提供了丰富的状态码供我们使用，正确的使用状态码可以让响应数据更具可读性。

• 200 OK - 对成功的 GET、PUT、PATCH 或 DELETE 操作进行响应。也可以被用在不创建新资源的 POST 操作上

• 201 Created - 对创建新资源的 POST 操作进行响应。应该带着指向新资源地址的 Location 头

• 202 Accepted - 服务器接受了请求，但是还未处理，响应中应该包含相应的指示信息，告诉客户端该去哪里查询关于本次请求的信息

• 204 No Content - 对不会返回响应体的成功请求进行响应（比如 DELETE 请求）

• 304 Not Modified - HTTP 缓存 header 生效的时候用

• 400 Bad Request - 请求异常，比如请求中的 body 无法解析

• 401 Unauthorized - 没有进行认证或者认证非法

• 403 Forbidden - 服务器已经理解请求，但是拒绝执行它

• 404 Not Found - 请求一个不存在的资源

• 405 Method Not Allowed - 所请求的 HTTP 方法不允许当前认证用户访问

• 410 Gone - 表示当前请求的资源不再可用。当调用老版本 API 的时候很有用

• 415 Unsupported Media Type - 如果请求中的内容类型是错误的

• 422 Unprocessable Entity - 用来表示校验错误

• 429 Too Many Requests - 由于请求频次达到上限而被拒绝访问

在开始动手操作之前，需要先下载postman

官网下载网址：https://www.postman.com/downloads/

二、GET请求

GET请求可以看见网址中所携带的参数，参数挂载在URI和URL。

• URI和URL的区别:https://blog.csdn.net/weixin_55635621/article/details/123681394

r := gin.Default() //携带基础中间件启动
  r.GET("/path/:id", func(c *gin.Context) {
    //返回URL参数的值
    id := c.Param("id")
    //查询它存在,返回键url查询值，
    //否则返回空字符串
    user := c.Query("user")
    pwd := c.Query("pwd")
    //JSON将给定的结构序列化为JSON到响应体中。
    //它还设置Content-Type为“application/json”。
    c.JSON(200, gin.H{
      "success": true,
      "id":      id,
      "user":    user,
      "pwd":     pwd,
    })
  })
r.Run(":8080") // listen and serve on 0.0.0.0:8080

这里利用Param将请求中的地址栏的id(这里是123提取出来)，和用Query将后面的参数user和pwd提取出来，然后将这三个参数返回，我们成功获取到网址上的参数了！

• 这个时候就有个问题了，如果我们的请求里面恰好没有给user或pwd，会怎么样?

我们发现缺少的这一项直接为空。

这个时候我们可以用DefaultQuery方法。

• DefaultQuery：如果存在，DefaultQuery返回键控url查询值，否则返回指定的defaultValue字符串。

user := c.DefaultQuery("user", "linzy") // 此方法可以设置默认值

postman访问:http://localhost:8080/path/123?pwd=123456

三、POST请求

POST 请求的参数一般通过 body 传递给服务器. body 中的数据格式有很多种。

• 表单参数可以通过PostForm()方法获取，该方法默认解析的是x-www-form-urlencoded或from-data格式的参数

r := gin.Default() //携带基础中间件启动
r.POST("/path", func(c *gin.Context) {
    user := c.DefaultPostForm("user", "linzy")
    //PostForm从POST url编码表单或多部分表单返回指定的键值
    pwd := c.PostForm("pwd")
    c.JSON(200, gin.H{
      "success": true,
      "user":    user,
      "pwd":     pwd,
    })
  })
r.Run(":8080") // listen and serve on 0.0.0.0:8080

postman访问:http://localhost:8080/path

四、DELETE请求

DELETE请求参数挂载在URI,用法与GET请求一样。

r := gin.Default() //携带基础中间件启动
r.DELETE("/path/:id", func(c *gin.Context) {
    id := c.Param("id")
    c.JSON(200, gin.H{
      "id": id,
    })
  })
r.Run(":8080") // listen and serve on 0.0.0.0:8080

postman访问:http://localhost:8080/path/linzy

五、PUT请求

PUT请求与POST请求用法一样，参数一般通过 body 传递给服务器. body 中的数据格式有很多种。

r := gin.Default() //携带基础中间件启动
r.PUT("/path", func(c *gin.Context) {
    user := c.DefaultPostForm("user", "linzy")
    pwd := c.PostForm("pwd")
    c.JSON(200, gin.H{
      "success": true,
      "user":    user,
      "pwd":     pwd,
    })
  })
r.Run(":8080") // listen and serve on 0.0.0.0:8080

postman访问:http://localhost:8080/path/linzy