150 lines
4.2 KiB
Markdown
150 lines
4.2 KiB
Markdown
# CRUD 测试用例说明
|
|
|
|
## 测试文件
|
|
|
|
### 1. `curd_func_test.go` - 不依赖数据库的测试
|
|
测试所有不依赖数据库的函数，包括：
|
|
- `TestBuildWhere` - 测试 BuildWhere 方法及其辅助函数
|
|
- `TestBuildMap` - 测试 BuildMap 方法
|
|
- `TestClearField` - 测试 ClearField 方法
|
|
- `TestBuildWhereAndOr` - 测试 BuildWhereAndOr 构建器
|
|
- `TestPaginateStruct` - 测试 Paginate 结构体
|
|
- `TestPageInfo` - 测试 pageInfo 常量
|
|
|
|
**运行方式：**
|
|
```bash
|
|
go test -v ./crud -run "TestBuild|TestClear|TestPaginate|TestPage"
|
|
```
|
|
|
|
### 2. `curd_test.go` - 依赖数据库的测试
|
|
测试所有需要数据库的 CRUD 操作方法，包括：
|
|
- `TestCrud_BuildWhere` - 完整的 BuildWhere 测试
|
|
- `TestCrud_ClearFieldPage` - 分页查询测试
|
|
- `TestCrud_ClearFieldList` - 列表查询测试
|
|
- `TestCrud_ClearFieldOne` - 单条查询测试
|
|
- `TestCrud_Value` - 字段值查询测试
|
|
- `TestCrud_DeletePri` - 按主键删除测试
|
|
- `TestCrud_DeleteWhere` - 按条件删除测试
|
|
- `TestCrud_Sum` - 求和测试
|
|
- `TestCrud_ArrayField` - 字段数组查询测试
|
|
- `TestCrud_FindPri` - 按主键查询测试
|
|
- `TestCrud_First` - 查询第一条测试
|
|
- `TestCrud_Exists` - 存在性检查测试
|
|
- `TestCrud_All` - 查询所有测试
|
|
- `TestCrud_Count` - 统计测试
|
|
- `TestCrud_Save` - 保存测试
|
|
- `TestCrud_Update` - 更新测试
|
|
- `TestCrud_UpdatePri` - 按主键更新测试
|
|
- `TestCrud_Paginate` - 分页查询测试
|
|
- `TestHelperFunctions` - 辅助函数测试
|
|
|
|
**运行方式：**
|
|
```bash
|
|
# 需要 MySQL 服务
|
|
go test -v ./crud -run TestCrud
|
|
```
|
|
|
|
**注意：** 数据库测试需要 MySQL 服务，连接信息：
|
|
- Host: 127.0.0.1:3306
|
|
- User: root
|
|
- Password: root
|
|
- Database: test
|
|
|
|
如果没有 MySQL 服务，这些测试会自动跳过。
|
|
|
|
## 运行所有测试
|
|
|
|
```bash
|
|
# 运行所有测试
|
|
go test -v ./crud
|
|
|
|
# 运行特定测试
|
|
go test -v ./crud -run TestBuildWhere
|
|
|
|
# 显示覆盖率
|
|
go test -v ./crud -cover
|
|
```
|
|
|
|
## 测试覆盖的函数列表
|
|
|
|
### 核心方法
|
|
- ✅ `BuildWhere` - 构建查询条件 map
|
|
- ✅ `BuildMap` - 构建变更条件 map
|
|
- ✅ `BuildWhereAndOr` - AND/OR 查询条件构建器
|
|
- ✅ `BuildWhereGORM` - GORM 原生语法构建器
|
|
- ✅ `ClearField` - 清理请求参数
|
|
- ✅ `ClearFieldPage` - 清理参数 + 分页查询
|
|
- ✅ `ClearFieldList` - 清理参数 + 列表查询
|
|
- ✅ `ClearFieldOne` - 清理参数 + 单条查询
|
|
|
|
### 查询方法
|
|
- ✅ `Value` - 查询单个字段值
|
|
- ✅ `FindPri` - 按主键查询单条记录
|
|
- ✅ `First` - 按条件查询第一条记录
|
|
- ✅ `Exists` - 判断记录是否存在
|
|
- ✅ `All` - 查询所有符合条件的记录
|
|
- ✅ `Count` - 统计记录总数
|
|
- ✅ `ArrayField` - 查询指定字段数组
|
|
- ✅ `Sum` - 字段求和
|
|
|
|
### 操作方法
|
|
- ✅ `Save` - 新增/更新记录
|
|
- ✅ `Update` - 按条件更新记录
|
|
- ✅ `UpdatePri` - 按主键更新记录
|
|
- ✅ `DeletePri` - 按主键删除
|
|
- ✅ `DeleteWhere` - 按条件删除
|
|
- ✅ `Paginate` - 分页查询
|
|
|
|
### 辅助函数
|
|
- ✅ `convToMap` - 类型转换为 map
|
|
- ✅ `isEmpty` - 判断值是否为空
|
|
- ✅ `strInArray` - 判断字符串是否在数组中
|
|
- ✅ `caseConvert` - 字段名风格转换
|
|
|
|
## 测试示例
|
|
|
|
### BuildWhereAndOr 使用示例
|
|
```go
|
|
func TestBuildWhereAndOr(t *testing.T) {
|
|
var crud Crud[interface{}]
|
|
|
|
// 混合使用 AND 和 OR
|
|
where := crud.BuildWhereAndOr().
|
|
AND(map[string]any{"status": 1}).
|
|
OR(
|
|
map[string]any{"age >": 25},
|
|
map[string]any{"vip": true},
|
|
).
|
|
Build()
|
|
|
|
if where == nil {
|
|
t.Error("Expected where to not be nil")
|
|
}
|
|
}
|
|
```
|
|
|
|
### BuildWhereGORM 使用示例
|
|
```go
|
|
func TestBuildWhereGORM(t *testing.T) {
|
|
var crud Crud[TestModel]
|
|
|
|
// 使用 GORM 原生语法
|
|
var results []*TestModel
|
|
err := crud.BuildWhereGORM("status = ?", 1).
|
|
Where("age > ?", 20).
|
|
Or("vip = ?", true).
|
|
Find(&results)
|
|
|
|
if err != nil {
|
|
t.Errorf("Expected no error, got %v", err)
|
|
}
|
|
}
|
|
```
|
|
|
|
## 注意事项
|
|
|
|
1. 数据库测试需要 MySQL 服务，如果不可用会自动跳过
|
|
2. 所有测试都是独立的，不会相互影响
|
|
3. 每个测试都会创建自己的测试数据
|
|
4. 测试完成后会自动清理资源
|