server

package
v0.0.0-...-66f2c83 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 19, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AfterCommit

func AfterCommit(ctx context.Context, callback func(context.Context) error)

AfterCommit 在当前 RunInTx 事务内登记提交后回调;调用方必须处于 RunInTx 内。临时信号经它在提交后发布,进程在提交后、回调前退出时回调不执行。

func ClockNow

func ClockNow(ctx context.Context, db bun.IDB) (time.Time, error)

ClockNow 返回数据库此刻的时间(clock_timestamp()),用于长事务中或等待行锁之后需要最新时刻的判断。

func DiscardConn

func DiscardConn(conn bun.Conn)

DiscardConn 把连接标记为失效,连接关闭时从连接池丢弃,连接上的会话状态与会话级咨询锁随之释放。

func HoldSessionLock

func HoldSessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys []string, fn func() error) error

HoldSessionLock 在已有连接上取得命名空间下各键的会话级咨询锁后执行 fn,结束后释放。

func LockKey

func LockKey(parts ...string) string

LockKey 用冒号连接多个部分,组成一个业务锁键。

func Now

func Now(ctx context.Context, db bun.IDB) (time.Time, error)

Now 返回数据库的当前时刻;在事务中调用时等于该事务内 SQL 的 now()。

func PutOutbox

func PutOutbox(ctx context.Context, kind string, payload any) (string, error)

PutOutbox 在当前事务中持久登记一个有序消息批次。

func RunInTx

func RunInTx(ctx context.Context, db bun.IDB, fn func(context.Context, bun.Tx) error) error

RunInTx 执行写事务并在提交成功后按登记顺序执行事务内经 AfterCommit 登记的回调,回滚或提交失败时丢弃回调。 db 为 *bun.DB 或 bun.Conn 时开启独立的顶层事务并使用新的登记表,与上下文中外层事务的登记表互不影响; db 为 bun.Tx 时以保存点执行:外层事务由 RunInTx 开启时加入其登记表,回调在外层事务提交后执行,保存点回滚时丢弃保存点内登记的回调;外层事务未经 RunInTx 开启时保存点内不可登记回调。 回调执行时事务结果已确定,回调返回错误或 panic 时记录 Error 日志后继续执行其余回调,RunInTx 仍返回 nil。

func SessionLock

func SessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys ...string) error

SessionLock 在连接上按升序取得命名空间下各键的会话级咨询锁;中途失败时释放已取得的锁后返回错误。

func SessionUnlock

func SessionUnlock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys ...string) error

SessionUnlock 按降序释放连接上命名空间下各键的会话级咨询锁,释放失败时丢弃底层连接并返回错误,PostgreSQL 随连接断开释放其余锁。

func Transaction

func Transaction(ctx context.Context) bun.Tx

Transaction 返回当前 RunInTx 的数据库事务。

func TrySessionLock

func TrySessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, key string) (bool, error)

TrySessionLock 在连接上尝试取得命名空间下单个键的会话级咨询锁,空键取以命名空间命名的一把锁,锁被占用时立即返回 false。

func TryWithSessionLock

func TryWithSessionLock(ctx context.Context, db *bun.DB, namespace LockNamespace, key string, fn func(conn bun.Conn) error) (bool, error)

TryWithSessionLock 在新的专用连接上尝试取得单个会话级咨询锁,取得时执行 fn 后释放并返回 true,锁被占用时返回 false。

func WithSessionLock

func WithSessionLock(ctx context.Context, db *bun.DB, namespace LockNamespace, keys []string, fn func(conn bun.Conn) error) error

WithSessionLock 在新的专用连接上取得命名空间下各键的会话级咨询锁后执行 fn,结束后释放锁并归还连接。

func XactLock

func XactLock(ctx context.Context, tx bun.IDB, namespace LockNamespace, keys ...string) error

XactLock 在事务内按升序取得命名空间下各键的事务级咨询锁,未给出键时取得以命名空间命名的一把锁,锁随事务结束释放。

Types

type LockNamespace

type LockNamespace string

LockNamespace 是咨询锁的业务命名空间,锁键由命名空间与业务键拼接后经 hashtextextended 映射为 64 位编号;不同命名空间的锁键互不同名,哈希碰撞仍可能让两个锁键互相等待。

const (
	// LockMessagePartitions 串行创建消息分区。
	LockMessagePartitions LockNamespace = "message-partitions"
	// LockPlatformStats 串行执行运营数据汇总与重建。
	LockPlatformStats LockNamespace = "platform-stats"
	// LockVectorIndexes 串行执行知识库专属向量索引对账。
	LockVectorIndexes LockNamespace = "vector-indexes"
	// LockDeploymentAdmission 串行执行服务端进程加入部署。
	LockDeploymentAdmission LockNamespace = "deployment-admission"
	// LockDeploymentCertificate 串行签发部署地址证书。
	LockDeploymentCertificate LockNamespace = "deployment-certificate"
	// LockServerInstance 是服务端进程运行期间持有的实例锁,键为实例编号。
	LockServerInstance LockNamespace = "server-instance"
	// LockPushDevice 串行登记同一推送设备,键为应用、平台与设备编号。
	LockPushDevice LockNamespace = "push-device"
	// LockPlatformContact 串行处理同一平台账号下同一外部编号的首次入站,键为工作区、平台账号与外部编号。
	LockPlatformContact LockNamespace = "platform-contact"
	// LockWeComBot 串行连接同一企业微信机器人,键为机器人编号。
	LockWeComBot LockNamespace = "wecom-bot"
	// LockTelegramChannel 串行执行单个 Telegram 渠道的配置生命周期,键为渠道编号。
	LockTelegramChannel LockNamespace = "telegram-channel"
	// LockTelegramBot 串行执行工作区内同一 Telegram Bot 的 Webhook 生命周期,键为工作区与 Bot 编号。
	LockTelegramBot LockNamespace = "telegram-bot"
)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址