在当今互联网时代，RESTful API（Representational State Transfer，表述性状态转移）是一种广泛使用的 Web API 模式。具有 RESTful API 接口的应用程序可以使用标准的 HTTP 方法，例如 GET、POST、DELETE 等，通过 Web 请求处理数据，并以某种格式进行响应。
Go 语言是近年来快速崛起的一门编程语言，它具有简单、高效和强大等诸多特点。在本篇文章中，我们将介绍如何使用 Go 语言创建 RESTful API，让你掌握这种常用 API 手段。
1. 初始化项目
第一步是初始化 Go 项目，可以使用 go mod init 命令实现：
$ go mod init example.com/restful-api
该命令创建了一个名为 restful-api 的新模块，并在当前目录中生成一个 go.mod 文件。我们可以使用这个文件来跟踪我们在项目中使用的任何包和依赖项。
2. 添加依赖项
下一步是添加几个必要的依赖项。
我们将使用 Gin 框架来处理 HTTP 路由、中间件、请求和响应等方面的功能。使用以下命令添加 Gin 依赖项：
$ go get -u github.com/gin-gonic/gin
我们还将使用 GORM 库来处理数据库事务。使用以下命令添加 GORM 依赖项：
$ go get -u gorm.io/gorm $ go get -u gorm.io/driver/sqlite
3. 编写代码
接下来是编写代码，创建 RESTful API 并处理 HTTP 路由和数据库事务。
3.1 数据库模型和迁移
我们需要先定义一个数据库模型，因为我们将使用 GORM 来管理数据库。在这个例子中，我们将创建一个名为 User 的用户模型：
type User struct {
gorm.Model
Name string `json:"name"`
Email string `json:"email"`
}这里使用了 GORM 的 gorm.Model 结构体。它包含了四个字段：ID、CreatedAt、UpdatedAt 和 DeletedAt。这些字段将被用于追踪每个数据库实例的创建时间、更新时间和删除时间。
我们还需要定义一个函数来迁移我们的数据库：
-- -------------------- ---- -------
---- --------- -
--- --- -- --------------------------------- ---------------
-- --- -- --- -
------------- -- ------- ----------
-
-- ----
-----------------------
-这个函数连接到 SQLite 数据库，并将模型映射到数据库表。
3.2 路由和控制器
接下来，我们需要定义路由和控制器来处理请求和响应。在这个例子中，我们将使用 Gin 框架来处理这些功能。以下是示例代码：
-- -------------------- ---- -------
---- ------ -
-- ------
---------
-- -----
------ -- -------------
-- ----
--------------------- -----------
-- ------
-------------------- ---------
-- ------
------------------------ --------
-- ----
------------------------ -----------
-- ----
--------------------------- -----------
-- -----
-------------------
-
---- ------------ ------------- -
--- ---- ----
-----------------
--- --- -- --------------------------------- ---------------
-- --- -- --- -
----------------------------------------
------
-
----------------
--------------------- ------------- ------
-
---- ---------- ------------- -
--- ----- ------
--- --- -- --------------------------------- ---------------
-- --- -- --- -
----------------------------------------
------
-
---------------
--------------------- ------------- -------
-
---- --------- ------------- -
--- ---- ----
--- --- -- --------------------------------- ---------------
-- --- -- --- -
----------------------------------------
------
-
-- -- -------------
--------------- ---
--------------------- ------------- ------
-
---- ------------ ------------- -
--- ---- ----
--- --- -- --------------------------------- ---------------
-- --- -- --- -
----------------------------------------
------
-
-- -- -------------
--------------- ---
-----------------
--------------
--------------------- ------------- ------
-
---- ------------ ------------- -
--- ---- ----
--- --- -- --------------------------------- ---------------
-- --- -- --- -
----------------------------------------
------
-
-- -- -------------
--------------- ---
----------------
------------------------------
-在上面的代码中，我们定义了五个路由：
- POST /users：创建用户
- GET /users：获取所有用户
- GET /users/:id：获取单个用户
- PUT /users/:id：更新用户
- DELETE /users/:id：删除用户
这些路由分别对应五个控制器函数 createUser、getUsers、getUser、updateUser 和 deleteUser。
3.3 运行应用程序
现在，我们已经定义了路由和控制器，并编写了运行服务器的代码，接下来运行应用程序：
$ go run main.go
现在，我们的应用程序正在监听端口号 8080。现在可以使用 HTTP 客户端向我们的 API 发出请求，并响应请求。
4. 总结
本文展示了如何使用 Go 语言创建 RESTful API。我们使用了 Gin 框架来处理路由和中间件，并使用 GORM 库来处理数据库事务。通过使用这种模式，我们可以轻松地构建可伸缩而且易于维护的 Web 应用程序。
完整的示例代码可以在 GitHub 上找到。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64d193e5b5eee0b5258ce681