req/options.go

package req

import "git.fsdpf.net/go/db"

type ResOptions struct {
	Tx     *db.TxDatabase
	Alias  string
	Silent bool
	// RolesScope 默认零值 ResScopeOff：不传 WithRolesScope，或显式传 ResScopeOff，都表示跳过
	// 权限过滤；只有显式传 ResScopeOn/ResScopeAll 才会按角色过滤。
	RolesScope ResScope
}

type ResOption func(p *ResOptions)

func WithTx(tx *db.TxDatabase) ResOption {
	return func(p *ResOptions) {
		p.Tx = tx
	}
}

func WithAlias(as string) ResOption {
	return func(p *ResOptions) {
		p.Alias = as
	}
}

// WithSilent 让这次写操作跳过变更通知（ResChangeEventFunc/ResWatcher），权限过滤、字段脱敏、
// 字段规范化、类型转换、默认值填充等都不受影响。用于类似"记录登录 IP"这种高频写、但不需要广播
// "资源变了"的场景，避免不必要的缓存刷新/watcher 触发。
func WithSilent() ResOption {
	return func(p *ResOptions) {
		p.Silent = true
	}
}

// WithRolesScope 显式指定这次写/查操作的权限过滤范围。ResScopeOn/ResScopeAll 按角色过滤
// （行级 WHERE 注入、字段级读脱敏、字段级写权限）；ResScopeOff（或不调用这个 option）跳过
// 权限过滤，变更通知、字段规范化、类型转换、默认值填充等不受影响。
func WithRolesScope(s ResScope) ResOption {
	return func(p *ResOptions) {
		p.RolesScope = s
	}
}

type gParamsOpt func(g *gparams)

func Session(session string) gParamsOpt {
	return func(g *gparams) {
		g.session = session
	}
}