77 lines
2.3 KiB
Markdown
77 lines
2.3 KiB
Markdown
# 事件总线
|
||
统一的事件总线，低层使用RocketMQ，进一步封装：约束命名规范、权限验证、链路追踪等
|
||
|
||
## 发送
|
||
[参考：](/event/producer_test.go)
|
||
1. 生成发送实例
|
||
```go
|
||
producer, err := event.NewProducer("192.168.6.107:9876")
|
||
|
||
// 带有验证凭证的示例
|
||
producer, err := NewProducer("192.168.6.107:9876", producer.WithProducerCredentials("accessKey", "secretKey", "securityToken"))
|
||
```
|
||
生成时可选的配置项有：
|
||
* event.WithProducerCredentials 设置生产者的凭证
|
||
2. 在Data层中注入生成的实例
|
||
|
||
3. 在biz中声明event的interface
|
||
|
||
4. 在data层中实现biz声明的interface，同repository类似
|
||
|
||
5. 使用的方法：
|
||
* SendSync 同步发送
|
||
* SendAsync 异步发送
|
||
* BatchSendSync 批量同步发送
|
||
* BatchSendAsync 批量异步发送
|
||
|
||
6. 默认支持链路追踪，如要关闭，请调用DisableTraceTelemetry方法
|
||
|
||
## 消费
|
||
[参考：](/event/producer_test.go)
|
||
### 一、随着Kratos服务一起启动
|
||
1. 在server中新增consumer.go
|
||
```go
|
||
// ConsumerServer 消费者Server
|
||
type ConsumerServer struct {
|
||
manager *event.ConsumerManager
|
||
}
|
||
|
||
// NewConsumerServer 工厂方法
|
||
func NewConsumerServer(
|
||
//注入一些依赖的对象（包括biz，同http、grpc的Sever类似）
|
||
) *ConsumerServer {
|
||
manager := event.NewConsumerManager()
|
||
|
||
// 添加一些订阅方法，示例：
|
||
_ = manager.Subscribe(ctx, connConf, consumerConf, func(message *ConsumerMessage) error {
|
||
// mock 业务耗时
|
||
time.Sleep(10 * time.Second)
|
||
// 返回nil才会commit，否则会重试
|
||
return nil
|
||
})
|
||
|
||
return &ConsumerServer{manager:manager}
|
||
}
|
||
|
||
func (c *ConsumerServer) Start(ctx context.Context) error {
|
||
return c.manager.Start()
|
||
}
|
||
|
||
func (c *ConsumerServer) Stop(ctx context.Context) error {
|
||
return c.manager.Stop()
|
||
}
|
||
|
||
```
|
||
|
||
2. 添加进provider_set.go
|
||
3. 打开main.go
|
||
```go
|
||
// 在newApp方法中注入ConsumerServer,并添加到
|
||
serverOption := kratos.Server(
|
||
//在这里面添加ConsumerServer的实例
|
||
)
|
||
```
|
||
### 二、使用cli模式启动
|
||
参考上面的启动方式，顺序为：subscribe -> start -> stop
|
||
|