53 lines
1.6 KiB
Go
53 lines
1.6 KiB
Go
package contract
|
|
|
|
import "context"
|
|
|
|
const QueueKey = "hade:queue"
|
|
|
|
type QueueService interface {
|
|
// PublishEvent 发布事件到队列，并持久化
|
|
PublishEvent(ctx context.Context, event Event) error
|
|
|
|
// SubscribeEvent 订阅事件
|
|
SubscribeEvent(ctx context.Context, topic string, handler func(event Event) error) error
|
|
|
|
// ProcessSubscribe 执行订阅
|
|
ProcessSubscribe()
|
|
|
|
// RegisterSubscribe 注册订阅 订阅事件
|
|
RegisterSubscribe(topic string, handler func(event Event) error) error
|
|
|
|
// ReplayEvents 从指定的时间点或事件ID开始重放事件
|
|
ReplayEvents(ctx context.Context, topic string, fromID string, fromTimestamp int64, handler func(event Event) error) error
|
|
|
|
// GetRegisterSubscribe 根据主题获取已经注册的订阅
|
|
GetRegisterSubscribe(topic string) []EventHandler
|
|
|
|
// GetEventById 根据事件ID获取事件
|
|
GetEventById(ctx context.Context, topic string, eventID string) (Event, error)
|
|
|
|
// GetEventByTime 根据事件ID获取事件
|
|
GetEventByTime(ctx context.Context, topic string, fromTimestamp int64) (Event, error)
|
|
|
|
// Close 关闭队列连接
|
|
Close() error
|
|
|
|
// NewEventAndPublish 创建并推送事件方法
|
|
NewEventAndPublish(ctx context.Context, topic string, payload interface{}) error
|
|
|
|
// SetContext 为订阅设置上下文
|
|
SetContext(ctx context.Context)
|
|
|
|
// GetContext 为订阅设置上下文
|
|
GetContext() context.Context
|
|
}
|
|
|
|
type EventHandler func(event Event) error
|
|
|
|
type Event interface {
|
|
GetEventKey() string // 事件唯一标识
|
|
EventTopic() string // 事件类型
|
|
EventTimestamp() int64 // 事件发生时间
|
|
Payload() interface{} // 事件负载
|
|
}
|