d8a173d9f0
feat(instance): migrate instance containers to type-safe generics ( #4617 )
...
### 变更说明
本次重构将项目中用于**实例管理的容器**从 `StrAnyMap`/`IntAnyMap` 迁移到类型安全的泛型实现
`KVMapWithChecker`，同时将相关的 `glist.List` 和 `gqueue.Queue`
替换为对应的泛型版本，以提高实例管理的类型安全性。并且减少原先代码中的大量类型断言，提高性能。
### 前因
目前`goframe`中大量使用了包含`any`的容器，然后通过断言去转换类型，麻烦且影响性能，尤其是对`gdb/gredis/glog`等需要高频获取`instance`实例的组件影响较大。最近几个版本中gf完成了数据结构容器的泛型化改造，以及我最近解决了其中几个泛型容器对于`typed
nil`过滤的问题，所以可以逐步迁移这些实例容器到泛型容器，减少断言优化性能
### 主要改进
#### 1. 实例容器泛型化
以下模块的实例管理容器已迁移到泛型实现：
**核心实例管理**:
- `database/gdb`: 数据库实例容器 → `KVMap[string, DB]`
- `database/gredis`: Redis 实例容器 → `KVMap[string, *Redis]`
- `database/gredis`: Redis 配置容器 → `KVMap[string, *Config]`
- `os/gcfg`: 配置实例容器 → `KVMap[string, *Config]`
- `os/glog`: 日志实例容器 → `KVMap[string, *Logger]`
- `os/gview`: 视图实例容器 → `KVMap[string, *View]`
- `i18n/gi18n`: 国际化实例容器 → `KVMap[string, *Manager]`
**网络服务实例**:
- `net/ghttp`: HTTP 服务器容器 → `KVMap[string, *Server]`
- `net/gtcp`: TCP 服务器容器 → `KVMap[any, *Server]`
- `net/gudp`: UDP 服务器容器 → `KVMap[string, *Server]`
**其他实例容器**:
- `os/gres`: 资源实例容器 → `KVMap[string, *Resource]`
- `os/gfpool`: 文件池容器 → `KVMap[string, *Pool]`
- `os/gspath`: 路径搜索容器 → `KVMap[string, *SPath]`
- `net/gtcp`: 连接池容器 → `KVMap[string, *gpool.Pool]`
#### 2. 相关数据结构泛型化
- `os/gfsnotify`: 回调列表 → `TList[*Callback]`，事件队列 → `TQueue[*Event]`
- `os/grpool`: 任务队列 → `TList[*localPoolItem]`
- `os/gcache`: 事件队列 → `TList[*adapterMemoryEvent]`
- `net/ghttp`: 解析项列表 → `TList[*HandlerItemParsed]`
- `os/gproc`: 消息队列 → `TQueue[*MsgRequest]`
- `os/gmlock`: 锁映射 → `KVMap[string, *sync.RWMutex]`
### 技术实现
1. **引入检查器函数**: 为每个实例容器添加 `checker` 函数用于空值检测
2. **消除类型断言**: 实例获取时无需 `v.(*Type)` 转换
3. **明确函数签名**: `GetOrSetFuncLock` 的回调从 `func() any` 改为 `func() T`
### 使用示例
#### 实例容器的变更
**变更前**:
```go
// 旧的实例管理方式
var instances = gmap.NewStrAnyMap(true)
func Instance(name string) *Logger {
v := instances.GetOrSetFuncLock(name, func() any {
return New()
})
return v.(*Logger) // 需要类型断言
}
```
**变更后**:
```go
// 新的泛型实例容器
var (
checker = func(v *Logger) bool { return v == nil }
instances = gmap.NewKVMapWithChecker[string, *Logger](checker, true)
)
func Instance(name string) *Logger {
return instances.GetOrSetFuncLock(name, New) // 直接返回，无需断言
}
```
#### 队列容器的变更
**变更前**:
```go
// 旧的队列方式
events := gqueue.New()
events.Push(&Event{Path: "/tmp/file"})
if v := events.Pop(); v != nil {
event := v.(*Event) // 需要类型断言
handleEvent(event)
}
```
**变更后**:
```go
// 新的泛型队列
events := gqueue.NewTQueue[*Event]()
events.Push(&Event{Path: "/tmp/file"})
if event := events.Pop(); event != nil {
handleEvent(event) // event 已是 *Event 类型
}
```
### 收益
- ✅ **编译时类型安全**: 实例容器的类型错误在编译期捕获
- ✅ **消除运行时断言**: 避免类型断言带来的 panic 风险
- ✅ **提升代码可读性**: 实例管理逻辑更清晰
- ✅ **改善开发体验**: IDE 类型提示和代码补全更准确
### 性能权衡
**编译时**:
- 泛型实例化会增加编译时间和二进制体积
- 预估编译时间增加 5-15%，二进制体积增加约 1-2MB
**运行时**:
- 减少类型断言的反射开销
- 提升实例获取等热点路径的性能
2026-01-16 15:23:13 +08:00
1e3aa5f080
fix: v2.9.5 ( #4503 )
2025-11-10 21:40:35 +08:00
94cc233325
fix: disable specific staticcheck rules and update lint config ( #4396 )
...
fix: disable specific staticcheck rules and update lint config
- Disabled staticcheck rules SA1029, SA1019, S1000, and related checks
in `.golangci.yml` to filter out unwanted linter errors.
- Updated staticcheck checks list for more precise linting control.
- Clarified configuration for easier maintenance and future updates.
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: hailaz <739476267@qq.com >
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com >
2025-08-29 10:32:30 +08:00
fc9093a1aa
feat(cmd/gf): add ShardingPattern option for command gf gen dao to support generating dao files sharding tables ( #4081 )
2024-12-26 23:21:03 +08:00
233295be07
fix(os/gview): search file faild from resource manager of package gres ( #4024 )
2024-12-18 10:39:01 +08:00
00e2f6b5dc
chore: improve golangci-lint.yml, upgrade dependencies, and optimize code and comments ( #4025 )
2024-12-11 10:14:12 +08:00
eca3583845
fix issue #1416 ; add ParseOption for package gview
2022-03-10 11:35:23 +08:00
f5693c4393
improve package gview
2022-03-10 09:48:19 +08:00
22941276a5
fix issue #1611
2022-02-22 21:59:18 +08:00
23c00eb83f
fix issue #1394
2022-02-14 16:08:26 +08:00
04eb654133
add error stack for internal error printing
2022-01-28 14:51:49 +08:00
6468d55a81
add absolute file path support for package gcfg/gview
2022-01-14 17:16:38 +08:00
fe93d7b332
add GetRegisteredRuleMap function, add internal logging for rule overwrite situation of package gvalid
2022-01-14 16:46:25 +08:00
48c5c1e5a8
change errors wrapped by gerror.Wrap with error stack info for all packages
2021-12-23 00:09:00 +08:00
ce93b625d4
change errors wrapped by gerror.Wrap with error stack info for all packages
2021-12-21 22:59:14 +08:00
b9907ae3ba
improve package gview for default folder searching
2021-12-17 21:38:10 +08:00
4fa2a879d7
[feature] improve code gview
2021-11-15 20:49:02 +08:00
1bc0635f8b
version 2
2021-10-11 21:41:56 +08:00
df09d8c604
refract package ghttp/gredis/glog
2021-09-27 21:27:24 +08:00
727f58a24b
remove usage of gconv.Unsafe* functions internally to avoid unexpected errors
2021-09-14 19:30:20 +08:00
59397fd8a5
add buildin function add/minus/times/divide for package gview
2021-08-25 20:00:53 +08:00
abc8e62d58
add package gcode and improve error implements for package gerror
2021-08-24 21:18:59 +08:00
0ddacdd7e2
add error code for components
2021-07-20 23:02:02 +08:00
d109706ad3
unify error package to gerror
2021-06-26 18:34:26 +08:00
50ffaef33f
add context for intlog/gsession;improve struct/structs converting for package gconv
2021-06-26 16:23:54 +08:00
a326f4a989
improve package gi18n/gview/gvalid for more flexable i18n feature controll,add custom error configuration and i18n translation for custom error message
2021-05-13 00:16:45 +08:00
093034acd1
copyright comment update
2021-01-17 21:46:25 +08:00
0d5b93bd07
fix issue in incorrect parsing error message for gview
2020-12-29 19:43:25 +08:00
63bc06d0fe
improve package gview
2020-12-15 00:09:55 +08:00
ca72d3b23a
remove gfcache usage from repo
2020-07-18 08:32:35 +08:00
4dd12434b7
add file cache feature for package gfile and remove package gfcache
2020-07-16 12:31:13 +08:00
0515fc94cb
add MapMerge/MapMargeCopy functions for package gutil; improve template view feature for indefinite parameters
2020-04-14 21:11:12 +08:00
a6a01fd7f2
improve template cache for ParseContent function of package gview
2020-03-21 23:42:34 +08:00
16958413bb
improve autoencode feature for package gview
2020-03-21 19:31:58 +08:00
