hoteas
b755519fc6
- 将Redis连接方式改为连接池模式，提升连接复用效率 - 修复缓存注释错误，统一标识数据库缓存逻辑 - 添加数据检索结果非空验证，避免空指针异常 - 在数据库操作中添加读写锁保护，确保并发安全性 - 实现数据库查询和执行操作的重试机制，增强稳定性 - 更新配置文件中的缓存和数据库设置，优化缓存策略 - 重构README文档，补充框架特性和性能测试数据 - 添加示例路由配置，完善快速入门指南
227 lines
5.7 KiB
Markdown
227 lines
5.7 KiB
Markdown
# HoTime
|
||
|
||
**高性能 Go Web 服务框架**
|
||
|
||
## 特性
|
||
|
||
- **高性能** - 单机 10万+ QPS，支持百万级并发用户
|
||
- **多数据库支持** - MySQL、SQLite3，支持主从分离
|
||
- **三级缓存系统** - Memory > Redis > DB，自动穿透与回填
|
||
- **Session管理** - 内置会话管理，支持多种存储后端
|
||
- **自动代码生成** - 根据数据库表自动生成 CRUD 接口
|
||
- **丰富工具类** - 上下文管理、类型转换、加密解密等
|
||
|
||
## 快速开始
|
||
|
||
### 安装
|
||
|
||
```bash
|
||
go get code.hoteas.com/golang/hotime
|
||
```
|
||
|
||
### 最小示例
|
||
|
||
```go
|
||
package main
|
||
|
||
import (
|
||
. "code.hoteas.com/golang/hotime"
|
||
. "code.hoteas.com/golang/hotime/common"
|
||
)
|
||
|
||
func main() {
|
||
appIns := Init("config/config.json")
|
||
|
||
appIns.Run(Router{
|
||
"app": {
|
||
"test": {
|
||
"hello": func(that *Context) {
|
||
that.Display(0, Map{"message": "Hello World"})
|
||
},
|
||
},
|
||
},
|
||
})
|
||
}
|
||
```
|
||
|
||
访问: http://localhost:8081/app/test/hello
|
||
|
||
## 性能测试报告
|
||
|
||
### 测试环境
|
||
|
||
| 项目 | 配置 |
|
||
|------|------|
|
||
| CPU | 24 核心 |
|
||
| 系统 | Windows 10 |
|
||
| Go 版本 | 1.19.3 |
|
||
|
||
### 测试结果
|
||
|
||
| 并发数 | QPS | 成功率 | 平均延迟 | P99延迟 |
|
||
|--------|-----|--------|----------|---------|
|
||
| 500 | 99,960 | 100% | 5.0ms | 25.2ms |
|
||
| **1000** | **102,489** | **100%** | **9.7ms** | **56.8ms** |
|
||
| 2000 | 75,801 | 99.99% | 26.2ms | 127.7ms |
|
||
| 5000 | 12,611 | 99.95% | 391.4ms | 781.4ms |
|
||
|
||
### 性能总结
|
||
|
||
```
|
||
最高 QPS: 102,489 请求/秒
|
||
最佳并发数: 1,000
|
||
```
|
||
|
||
### 并发用户估算
|
||
|
||
| 使用场景 | 请求频率 | 可支持用户数 |
|
||
|----------|----------|--------------|
|
||
| 高频交互 | 1次/秒 | ~10万 |
|
||
| 活跃用户 | 1次/5秒 | ~50万 |
|
||
| 普通浏览 | 1次/10秒 | ~100万 |
|
||
| 低频访问 | 1次/30秒 | ~300万 |
|
||
|
||
**生产环境建议**: 保留 30-50% 性能余量，安全并发用户数约 **50万 - 70万**
|
||
|
||
### 与主流框架性能对比
|
||
|
||
| 框架 | 典型QPS | 基础实现 | 性能评级 |
|
||
|------|---------|----------|----------|
|
||
| **HoTime** | **~100K** | net/http | 第一梯队 |
|
||
| Fiber | ~100K+ | fasthttp | 第一梯队 |
|
||
| Gin | ~60-80K | net/http | 第二梯队 |
|
||
| Echo | ~60-80K | net/http | 第二梯队 |
|
||
| Chi | ~50-60K | net/http | 第二梯队 |
|
||
|
||
## 框架对比
|
||
|
||
### 功能特性对比
|
||
|
||
| 特性 | HoTime | Gin | Echo | Fiber |
|
||
|------|--------|-----|------|-------|
|
||
| 性能 | 100K QPS | 70K QPS | 70K QPS | 100K QPS |
|
||
| 内置ORM | ✅ | ❌ | ❌ | ❌ |
|
||
| 内置缓存 | ✅ 三级缓存 | ❌ | ❌ | ❌ |
|
||
| Session | ✅ 内置 | ❌ 需插件 | ❌ 需插件 | ❌ 需插件 |
|
||
| 代码生成 | ✅ | ❌ | ❌ | ❌ |
|
||
| 微信/支付集成 | ✅ 内置 | ❌ | ❌ | ❌ |
|
||
| 路由灵活性 | 中等 | 优秀 | 优秀 | 优秀 |
|
||
| 社区生态 | 较小 | 庞大 | 较大 | 较大 |
|
||
|
||
### HoTime 优势
|
||
|
||
1. **开箱即用** - 内置 ORM + 缓存 + Session，无需额外集成
|
||
2. **三级缓存** - Memory > Redis > DB，自动穿透与回填
|
||
3. **开发效率高** - 链式查询语法简洁，内置微信/云服务SDK
|
||
4. **性能优异** - 100K QPS，媲美最快的 Fiber 框架
|
||
|
||
### 适用场景
|
||
|
||
| 场景 | 推荐度 | 说明 |
|
||
|------|--------|------|
|
||
| 中小型后台系统 | ⭐⭐⭐⭐⭐ | 完美适配，开发效率最高 |
|
||
| 微信小程序后端 | ⭐⭐⭐⭐⭐ | 内置微信SDK |
|
||
| 快速原型开发 | ⭐⭐⭐⭐⭐ | 代码生成 + 全功能集成 |
|
||
| 高并发API服务 | ⭐⭐⭐⭐ | 性能足够 |
|
||
| 大型微服务 | ⭐⭐⭐ | 建议用Gin/Echo |
|
||
|
||
### 总体评价
|
||
|
||
| 维度 | 评分 | 说明 |
|
||
|------|------|------|
|
||
| 性能 | 95分 | 第一梯队，媲美Fiber |
|
||
| 功能集成 | 90分 | 远超主流框架 |
|
||
| 开发效率 | 85分 | 适合快速开发 |
|
||
| 生态/社区 | 50分 | 持续建设中 |
|
||
|
||
> **总结**: HoTime 是"小而全"的高性能框架，性能不输主流，集成度远超主流，适合独立开发者或小团队快速构建中小型项目。
|
||
|
||
---
|
||
|
||
## 数据库操作
|
||
|
||
### 基础 CRUD
|
||
|
||
```go
|
||
// 查询单条
|
||
user := that.Db.Get("user", "*", Map{"id": 1})
|
||
|
||
// 查询列表
|
||
users := that.Db.Select("user", "*", Map{"status": 1, "ORDER": "id DESC"})
|
||
|
||
// 插入数据
|
||
id := that.Db.Insert("user", Map{"name": "test", "age": 18})
|
||
|
||
// 更新数据
|
||
rows := that.Db.Update("user", Map{"name": "new"}, Map{"id": 1})
|
||
|
||
// 删除数据
|
||
rows := that.Db.Delete("user", Map{"id": 1})
|
||
```
|
||
|
||
### 链式查询
|
||
|
||
```go
|
||
users := that.Db.Table("user").
|
||
LeftJoin("order", "user.id=order.user_id").
|
||
And("status", 1).
|
||
Order("id DESC").
|
||
Page(1, 10).
|
||
Select("*")
|
||
```
|
||
|
||
### 条件语法
|
||
|
||
| 语法 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| key | 等于 | "id": 1 |
|
||
| key[>] | 大于 | "age[>]": 18 |
|
||
| key[<] | 小于 | "age[<]": 60 |
|
||
| key[!] | 不等于 | "status[!]": 0 |
|
||
| key[~] | LIKE | "name[~]": "test" |
|
||
| key[<>] | BETWEEN | "age[<>]": Slice{18, 60} |
|
||
|
||
## 缓存系统
|
||
|
||
三级缓存: **Memory > Redis > Database**
|
||
|
||
```go
|
||
// 通用缓存
|
||
that.Cache("key", value) // 设置
|
||
data := that.Cache("key") // 获取
|
||
that.Cache("key", nil) // 删除
|
||
|
||
// Session 缓存
|
||
that.Session("user_id", 123) // 设置
|
||
userId := that.Session("user_id") // 获取
|
||
```
|
||
|
||
## 中间件
|
||
|
||
```go
|
||
appIns.SetConnectListener(func(that *Context) bool {
|
||
if that.Session("user_id").Data == nil {
|
||
that.Display(2, "请先登录")
|
||
return true // 终止请求
|
||
}
|
||
return false // 继续处理
|
||
})
|
||
```
|
||
|
||
## 扩展功能
|
||
|
||
- **微信支付/公众号/小程序** - dri/wechat/
|
||
- **阿里云服务** - dri/aliyun/
|
||
- **腾讯云服务** - dri/tencent/
|
||
- **文件上传下载** - dri/upload/, dri/download/
|
||
- **MongoDB** - dri/mongodb/
|
||
- **RSA加解密** - dri/rsa/
|
||
|
||
## License
|
||
|
||
MIT License
|
||
|
||
---
|
||
|
||
**HoTime** - 让 Go Web 开发更简单、更高效
|