69 lines
1.5 KiB
Markdown
69 lines
1.5 KiB
Markdown
|
# apigo.cc/go/tableDB
|
|||
|
|
|
|||
|
|
`tableDB` 是建立在 `apigo.cc/go/db` 基础上的更高层抽象工具库。提供对于动态表、数据权限隔离和 Hook 的生命周期追踪管理。
|
|||
|
|
|
|||
|
|
## 使用指南
|
|||
|
|
|
|||
|
|
### 1. 初始化与 Auth
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
package main
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"apigo.cc/go/tableDB"
|
|||
|
|
"apigo.cc/go/log"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
func main() {
|
|||
|
|
app := tableDB.GetDB("sqlite://local.db", log.DefaultLogger)
|
|||
|
|
|
|||
|
|
// 在需要忽略权限的系统级后台执行时：
|
|||
|
|
systemApp := app.Auth(tableDB.SystemUserID)
|
|||
|
|
|
|||
|
|
// 在特定的业务上下文执行时，将强制携带 creator 约束
|
|||
|
|
userApp := app.Auth("user_12345")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. DSL 动态表声明与同步
|
|||
|
|
|
|||
|
|
`TableDB` 提供底层隐藏表机制自动补全如 `id` 和 `autoIndex`，可用于初始化表结构。
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
schema := `
|
|||
|
|
== UserGroup ==
|
|||
|
|
users SD
|
|||
|
|
name v50 U
|
|||
|
|
age i
|
|||
|
|
`
|
|||
|
|
_ = app.SyncSchema(schema)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 生命周期 Hooks 订阅
|
|||
|
|
|
|||
|
|
通过注册 Hooks，我们可以在发生元数据变更或行更新时进行回调拦截：
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
app.Hooks.OnUpdatingRow = func(tableName string, row map[string]any) error {
|
|||
|
|
if tableName == "users" {
|
|||
|
|
row["modifiedAt"] = time.Now().Unix()
|
|||
|
|
}
|
|||
|
|
return nil
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 动态表增删改查
|
|||
|
|
|
|||
|
|
底层调用与 `go/db` 使用习惯对齐，不同点是操作会被权限或 Hook 钩子影响：
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
// 设定数据，如 ID 缺省会自动生成 c10 ID
|
|||
|
|
_ = userApp.Table("users").Set(map[string]any{"name": "Alice"})
|
|||
|
|
|
|||
|
|
// 读取
|
|||
|
|
record, _ := userApp.Table("users").Get("u1xxxx")
|
|||
|
|
|
|||
|
|
// 统计
|
|||
|
|
count, _ := userApp.Table("users").Count(map[string]any{"age >": 20})
|
|||
|
|
```
|