sqlbuilder

go-toolbox/pkg/sqlbuilder

一个功能丰富、高性能的 Go 语言 GORM 仓储层封装库，提供类型安全的 CRUD 操作、复杂查询构建和便利方法

📖 特性 & 文档导航

📖 完整文档：查看 文档中心 了解所有功能和学习路径

📦 安装

go get github.com/HitGameAI/apex-toolbox/pkg/sqlbuilder

🚀 快速开始

import (
    "github.com/HitGameAI/apex-toolbox/pkg/sqlbuilder/db"
    "github.com/HitGameAI/apex-toolbox/pkg/sqlbuilder/repository"
)

// 1. 定义模型
type User struct {
    repository.BaseModel
    Name  string `gorm:"type:varchar(100)"`
    Email string `gorm:"type:varchar(100);uniqueIndex"`
}

// 2. 创建 Repository
handler, _ := db.NewGormHandler(gormDB)
repo := repository.NewBaseRepository[User](handler, logger, "users")

// 3. CRUD 操作
user, err := repo.Create(ctx, &User{Name: "张三"})
user, err = repo.Get(ctx, 1)
user, err = repo.Update(ctx, user)
err = repo.Delete(ctx, 1)

💡 详细教程：查看 📘 快速入门文档 了解完整的安装和使用步骤

🏗️ 核心特性

// 内置模型：BaseModel、AuditModel
type User struct { repository.BaseModel; Name string }

// 配置选项：自动字段、批处理、超时、预加载等
repo := repository.NewBaseRepository[User](handler, logger, "users",
    repository.WithAutoFields[User](),
    repository.WithBatchSize[User](200),
)

📖 详细说明：查看 📔 模型定义 和 📘 快速入门 了解更多配置

🧪 测试

go test ./... -v                    # 运行所有测试
go test ./... -cover                # 测试覆盖率
go test -v -run TestBaseRepository  # 运行特定测试

📚 相关资源

• 📖 完整文档中心 - 所有功能文档和学习路径
• 🐛 问题反馈 - 报告 bug 或提出建议
• 📝 更新日志 - 版本更新记录
• 💬 讨论区 - 技术交流

📦 依赖

• GORM - 数据库 ORM
• go-toolbox - 错误处理和工具
• go-toolbox/pkg/logger - 结构化日志

🤝 贡献

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '✨ feat: Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 开启 Pull Request

📋 Git Commit Emoji 规范

📄 许可证

MIT License - 详见 LICENSE

👨‍💻 作者

Kamal Yang (@kamalyes)