gb 遵循统一的初始化与调用模式,以简化资源管理和保证单例实例。
- 初始化: 所有模块的初始化函数均以
Init为前缀,例如gb.InitGormDB()。 - 获取实例: 初始化后,通过
Ins前缀的函数获取该模块的唯一实例,例如gb.InsDB()。
package main
import (
"fmt"
"github.com/loveyu233/gb"
)
func main() {
// 示例:初始化并使用 GORM
err := gb.InitGormDB(gb.GormConf{
// ... 数据库配置
})
if err != nil {
panic("Failed to connect to database")
}
// 在应用的任何地方,通过 InsDB() 获取 GORM 实例
db := gb.InsDB()
fmt.Println(db)
}- Gin 快速启动: 内置 Engine,并集成了一系列即用型中间件。
- 中间件套件: 提供
CORS,Trace-ID,请求日志,Recovery等常用中间件。 - JWT 认证: 基于
jwt/v5的完整解决方案,支持 Token 生成、解析与刷新。 - Swagger 文档: 自动生成 API 文档,方便接口调试与测试。
- 参数验证: 集成
validator/v10,支持自定义规则和多语言错误提示。 - 标准化响应: 提供统一的 JSON 响应封装,简化 API 输出。
- ORM 数据库: 深度集成
GORM,提供便捷的数据库操作。 - Redis: 内置
go-redis客户端,简化缓存、队列等操作。 - RedSync 分布式锁: 基于 Redis 实现的分布式锁,确保并发安全。
- Excel 操作: 使用
excelize/v2,轻松实现 Excel 导入导出及与结构体的映射。 - 高精度计算: 内置
Decimal处理,避免浮点数计算的精度问题。
- 结构化日志: 基于
zerolog的高性能结构化日志,支持多种输出格式。 - Cron 定时任务: 集成
gocron,提供流畅的 API 来安排定时作业。 - HTTP 客户端: 集成
Resty,提供链式调用的 HTTP 请求体验。 - Goroutine 池: 内置
ants协程池,有效管理和复用 Goroutine,防止大规模泄露。 - ID 生成器: 提供
Snowflake雪花算法和XID,适用于分布式ID生成。 - 密码安全: 内置
Bcrypt密码哈希与验证功能。 - Lua 脚本: 集成 Lua 引擎,方便执行动态脚本。
- 辅助函数库: 预集成
lo(Lodash for Go),gjson,copier,cast等热门工具库,极大提升开发效率。
为了保持 gb 核心库的轻量和专注,部分功能已被拆分到独立的模块中,您可以按需引入:
- 支付集成 (Pay): 支付宝、微信支付等功能。
- 消息推送 (Msg): 企业微信机器人、短信发送等。
- 服务连接 (Connection): ETCD、RocketMQ 等。
- 图形验证码快速生成 (Captcha): 滑块,旋转,点击 等。
- 快速登录(login):集成了微信小程序的一键登录
⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐
Made with ❤️ by loveyu233