【Go Web开发】Web初识、RESTful架构和RESTful API详解、Gin框架的安装和简单使用

• 博主简介：努力学习的大一在校计算机专业学生，热爱学习和创作。目前在学习和分享：数据结构、Go，Java等相关知识。
• 博主主页： @是瑶瑶子啦
• 所属专栏: Go语言核心编程
• 近期目标：写好专栏的每一篇文章

一、什么是Web

• 全称：“万维网”（World Wide Web）

• 本质：系统（基于互联网）.由一系列的超文本文档Hypertext Documents）组成

• 作用：用户可以通过浏览器/APP，在Web上访问各种网站、资源

• 原理（重要）：
  

• Web的核心技术：

  • 超文本标记语言(HTML等）：用于组织和创建Web页面
  • 超文本传输协议（HTTP）：Web客户端和服务器之间传输数据的协议
  • 网页浏览器（Web Browser）：用于显示Web页面的软件
  • 统一资源定位符（URL）：表示Web资源的地址

• 发展历程

  • 静态Web：由静态页面组成，该系统的内容是静态的、固定的，无法根据用户需求进行更新
  • 动态Web：使用服务器端脚本语言(PHP、ASP、JSP）和数据库用于处理用户请求，动态生成页面内容
  • Web2.0：强调用户参与、互动、分享社交
    • 用户生成内容（User-generated content）：比如瑶瑶子现在在CSDN上写博客，就是让我这个用户，也成为了Web内容的创造者和分享者
    • 社交互动（Social interaction）你在评论区给瑶瑶子评论、或者加入瑶瑶子的社区，我们分享信息、建立联系，这就是用户之间的互动
    • 富媒体应用（Rich media applications）：在线视频、游戏等

二、RESTful架构

‍♂️推荐阅读：阮一峰 理解RESTful架构

2.1：RESTful介绍

RESTful（Representational State Transfer，表述性状态转移）是一种软件架构风格，它基于HTTP协议，用于设计和开发网络应用程序。RESTful架构风格强调资源的标识和状态的转移，使得客户端和服务器之间的交互变得简单和可扩展。

• 资源（Resource）：
  在RESTful框架中，任何可以被标识和访问的对象都是资源（如网页、图片、视频、数据库记录等）

• 每一个URI（Uniform Resource Identifier:统一资源定位符）对应一个资源实体
  URL（Uniform Resource Locator：统一资源定位器）和 URN（Uniform Resource Name：统一资源名称）都是URI的子集。作用是在互联网上唯一标识资源，便于资源的访问和管理。

  • URL：由协议名、主机名、路径、查询参数组成。作用：定位资源的具体位置和信息。当我们在浏览器输入一个URL时，浏览器会根据URL信息向服务器发送请求，获取对应资源（网页、图片、视频等）。
  • URN：由命名空间和资源名称组成，和URL不同的是它不包含用于定位资源的具体信息。作用：指定持久性资源的名称，比如数字对象标识符（DOI）、国际标准书号（ISBN）、国际标准音像制品编号（ISRC）等，便于资源的唯一标识和长期管理。

• HTTP方法：
  RESTful架构使用http协议定义了一组方法：来对服务器的资源进行操作

  • GET:获取资源
  • POST:创建资源
  • PUT:更新资源
  • DELETE:删除资源

• 表示（Representation）
   是客户端（用户）和服务器之间交换数据的一种格式，通常由客户端发送给服务器或者由服务器发送给客户端。Representation可以是任何格式的数据，如：XML、JSON、HTML等
   客户端和服务器可以使用不同的表示格式进行交互，只要它们都能够解析和处理这个表示即可。因此，表示的灵活性和可扩展性是RESTful架构的重要特点之一
   ‍♀️举例：瑶瑶子把她博客的链接（本质就是URL：这篇文章的资源标识符）分享给你，你在浏览器输入这个链接，按回车，就是从客户端向CSDN的服务器发送了一个请求，CSDN的服务器可以将这篇文章的内容以某种格式的表示（HTML）返回给你（客户端），你的浏览器可以解析这个Representation，提取文章内容并进行显示和处理~

• 状态转移（State Transfer)
   是客户端和服务器之间通过http方法和表示，来实现状态的转移。这个状态，指的是资源的状态，可以是任何属性或者信息。
   ‍♀️举例：瑶瑶子又要肝博客啦！于是瑶瑶子在CSDN的客户端给CSDN的服务器发送了一个http的post请求，请求的URI指向博客文章资源的集合。请求中包含新文章的表示（representation),表示中包含：文章标题、内容等信息。这个适合服务器根据我的请求，创建了一个新的文章，并且返回了http响应，响应中包含了新文章的URI和状态码。这个过程，客户端和服务器就实现了状态转移的过程，从原来：没有新文章的状态，通过Http 的post请求和表示，客户端和服务器之间转移到了新的状态：瑶瑶子的主页内多了一篇新博客！

2.2：RESTful API

2.2.1：什么是API？

 API的全称是：Application Programming Interface,是一种软件接口（注意，Web本质其实也是一个软件），用于定义软件组件（或者叫作软件模块）之间的通信协议。

 当不同的软件模块进行相互通信时，它们之间需要一种规范化的方式来传递数据和指令，也就是需要一个双方都认同的通信协议（这样，双方才知道你说了啥，给了我啥，我要做出上面反应）。

 API就是定义这种规范的方式，它来规定不同软件组件之间如何进行通信、传递数据。且客户端和服务端都需要遵守API的定义的规范，才能正确地进行数据和指令的传递。

 通过使用API，开发人员可以根据API的规范，使用API，轻松的访问和使用不同软件组件的功能，无需了解其内部实现细节。

分类

• Web API：通过网络进行通信的API，使用http协议+表示(representation)进行数据交换，包括：RESTful API和SOAP API等
• 程序库API：访问和使用特定编程语言的或框架中的函数和类
• 操作系统API：访问和使用操作系统中的函数和类
• 第三方API：由第三方开发者提供的API，用于访问和使用其服务或者平台

2.2.2：RESTful API

RESTful API是基于RESTful架构风格（上面已讲）的Web API。是通过http协议和表示来实现的API设计模式。

RESTful API的核心就是客户端和Web服务器进行交互的适合，使用http协议中的四个请求方法，代表对资源的不同操作

• GET:获取资源
• POST:创建资源
• PUT:更新资源
• DELETE:删除资源

只要API程序都遵循了REST风格，那么就将其称为RESTful API.

RESRful API设计和开发和规范

1. 资源和URL：资源是指应用程序中的实体或者对象，每一个资源有唯一的URL地址，可以通过http方法对其进行操作。客户端可以通过URL地址，对资源进行CRUD。URL需要简洁、有意义，使用名词进行资源描述（因为动作已经由get\ post等这些方法确定了

2. http方法：RESTful API使用http协议中不同的方法来表示不同的操作,实现对资源的CRUD

   • GET:获取资源
   • POST:创建资源
   • PUT:更新资源
   • DELETE:删除资源

3. 数据格式：RESTful API使用标准的数据格式来表示请求和响应数据，如：JSON、XML等。且请求和响应的数据格式应该统一，方便客户端的处理和解析‘

4. 状态码： RESTful API使用标准的HTTP状态码来表示请求和处理结果。常用的状态码包括200 OK、201 Created、400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、500 Internal Server Error等。客户端可以根据状态码来判断请求是否成功，并根据不同的状态码进行相应的处理。

5. 超媒体： RESTful API应该使用超媒体（Hypermedia）来表示资源之间的关系和链接。客户端可以通过超媒体链接轻松地导航和访问不同的资源，从而实现应用程序的动态性和可扩展性。

三、 初始Gin框架

Gin 是一个用 Go (Golang) 编写的 HTTP Web 框架

Gin框架支持开发RESTful API

3.1：安装和使用

• 下载安装

go get -u github.com/gin-gonic/gin

• 将gin引入到当前包，以使用gin框架

import "github.com/gin-gonic/gin"

• gin使用快速入门

package main

import "github.com/gin-gonic/gin"

func main() {
	//创建一个默认的路由引擎（引导别人访问什么地址。执行什么函数）
	r := gin.Default()

	//指定用户使用GET请求访问/hello时，执行sayHello这个函数
	r.GET("/hello", func(c *gin.Context) {
		//c.JSON，返回JSON格式数据
		c.JSON(200, gin.H{
			"message": "yyz",
		})
	})
	//启动http服务，默认在0.0.0.0:8080
	r.Run()
}

• 路由（Routing）是指根据URL请求路径（或者请求参数）来确定应用程序中相应的代码执行路径的过程。在Web开发中，路由通常指将HTTP请求的URL路径与应用程序中的相应处理函数进行绑定，以便在收到请求时能够正确地路由请求到相应的处理函数中。

• Web应用程序中的路由通常由路由引擎来管理，路由引擎根据URL路径（或者请求参数）来匹配相应的处理函数，并将HTTP请求转发到相应的处理函数中。

---

欢迎在评论区交流和留下你的想法和建议

如果对你有用，还请：评论+点赞+⭐收藏+➕关注

• Java岛冒险记【从小白到大佬之路】
  
• LeetCode每日一题–进击大厂
• 算法
• C/C++
• Go语言核心编程
• 数据结构