用 Go 和 Redis 构建一个简单的任务管理系统

在这篇博客中，我们将使用 Go 语言结合 Gin 框架和 Redis，一步步创建一个简单的任务管理系统。本系统可用于执行关键的 CRUD（创建、读取、更新、删除）操作，我们特别关注如何通过 Redis 作为数据存储实现这些功能。

介绍

任务管理系统的特点在于能够让用户轻松地创建、查看和删除任务。现代的应用程序需要快速的数据写入和读取，而 Redis 提供了这样的能力，因此非常适合我们的需求。

项目初始化

1. 创建项目目录并初始化 Go 模块

首先，开始创建项目目录，并在我们的新目录中初始化 Go 模块：

mkdir task-manager
cd task-manager
go mod init task-manager

此操作将创建一个 go.mod 文件，用于管理我们的项目依赖。

安装依赖项

下面我们来安装必要的依赖库——Gin 用于处理 HTTP 请求，Go-Redis 用于连接和操作 Redis：

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

这些库将为我们后续的开发提供强大的功能支持。

配置 Redis 连接

在项目根目录下创建 main.go 文件，用于初始化 Redis 连接和启动服务器：

package mainimport ("task-manager/controllers""github.com/gin-gonic/gin""github.com/go-redis/redis/v8"
)var rdb *redis.Clientfunc initRedis() {rdb = redis.NewClient(&redis.Options{Addr: "localhost:6379", // 设置 Redis 地址})
}func main() {initRedis()r := gin.Default()// 设置路由r.POST("/tasks", controllers.CreateTask)r.GET("/tasks", controllers.GetTasks)r.DELETE("/tasks/:id", controllers.DeleteTask)r.Run(":8080")
}

代码解释

Redis 客户端初始化：我们使用 go-redis 客户端连接到本地 Redis 服务器。
Gin 路由设置：通过 Gin，我们将不同的 HTTP 路径绑定到相应的处理函数。

实现控制器逻辑

在项目的根目录下创建一个 controllers 目录，并创建 task.go 文件：

package controllersimport ("context""net/http""task-manager/models""github.com/gin-gonic/gin""strconv"
)var ctx = context.Background()func CreateTask(c *gin.Context) {var task models.Taskif err := c.ShouldBindJSON(&task); err != nil {c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}task.ID = models.GenerateID()models.Rdb.Set(ctx, strconv.Itoa(task.ID), task.Title, 0)c.JSON(http.StatusOK, gin.H{"message": "Task created successfully", "id": task.ID})
}func GetTasks(c *gin.Context) {keys, _ := models.Rdb.Keys(ctx, "*").Result()var tasks []models.Taskfor _, key := range keys {title, _ := models.Rdb.Get(ctx, key).Result()id, _ := strconv.Atoi(key)tasks = append(tasks, models.Task{ID: id, Title: title})}c.JSON(http.StatusOK, tasks)
}func DeleteTask(c *gin.Context) {id := c.Param("id")models.Rdb.Del(ctx, id)c.JSON(http.StatusOK, gin.H{"message": "Task deleted successfully"})
}

代码解释

创建任务: 从请求中绑定任务数据后，在 Redis 中以键值对的形式存储。
获取所有任务: 遍历 Redis 中的所有键，获取并返回所有任务。
删除任务: 根据任务 ID 在 Redis 中删除相应的记录。

定义任务模型

在 models 目录下创建 task.go 文件来定义任务的数据模型：

package modelsimport ("github.com/go-redis/redis/v8"
)type Task struct {ID    int    `json:"id"`Title string `json:"title" binding:"required"`
}var Rdb *redis.Clientfunc SetRedisClient(client *redis.Client) {Rdb = client
}func GenerateID() int {return int(Rdb.Incr(ctx, "task_id_counter").Val())
}

代码解释

Task 结构体：定义了任务的基本信息，包括 ID 和标题。
ID 生成: 使用 Redis 的自增功能自动为每个任务生成唯一 ID。

使用 Postman 进行测试

1. 创建任务 (POST /tasks)

步骤：

1.打开 Postman，创建一个新的请求。
2.设置请求方法为 POST，请求 URL 为 http://localhost:8080/tasks。
3.在请求的 Body 部分，选择 raw 和 JSON 格式。
4.输入任务数据，例如：

{"title": "Buy groceries"
}

点击 Send。

期望响应：
服务器返回 200 OK，并带有任务创建成功的消息和新任务的 ID：

{"message": "Task created successfully","id": 1
}

2. 获取任务列表 (GET /tasks)

步骤：

1.在 Postman 中创建一个新的请求。
2.设置请求方法为 GET，请求 URL 为 http://localhost:8080/tasks。
3.点击 Send。

期望响应：

服务器返回 200 OK，并返回所有任务的列表：

[{"id": 1,"title": "Buy groceries"}// 可以有更多任务
]

3. 删除任务 (DELETE /tasks/:id)

步骤：
1.在 Postman 中创建一个新的请求。
2.设置请求方法为 DELETE，将请求 URL 设置为 http://localhost:8080/tasks/1，其中 1 替换为您想要删除的任务的 ID。
3.点击 Send.

期望响应：
服务器返回 200 OK，并带有任务删除成功的消息：

{"message": "Task deleted successfully"
}

其他注意事项

数据格式：确保在发送请求时，Body 的 JSON 格式数据正确，避免请求因格式问题而失败。
错误处理：测试用例应包括错误处理，例如尝试获取或删除不存在的任务以查看系统的错误响应。
Redis 可视化工具：可以使用 Redis 可视化工具（如 RedisInsight）查看任务在 Redis 中的存储情况。

通过这些步骤，您可以用 Postman 充分验证任务管理系统的功能，并确保系统正确地处理数据。您还可以进一步扩展功能，例如添加更新任务的能力或用户身份验证机制，加强系统的实用性。