1.SimpleConsumer消费者
SimpleConsumer 是一种接口原子型的消费者类型,消息的获取、消费状态提交以及消费重试都是通过消费者业务逻辑主动发起调用完成。SimpleConsumer 的使用涉及多个接口调用,由业务逻辑按需调用接口获取消息,然后分发给业务线程处理消息,最后按照处理的结果调用提交接口,返回服务端当前消息的处理结果
2.SimpleConsumer主要的接口
接口 | 描述 | 参数说明 |
---|---|---|
List<MessageView> receive(int var1, Duration var2) | 消费者主动调用该接口从服务端获取消息 | var1: 每个长轮询获取的最大消息数量;var2:消息的最长处理耗时,用于控制消费失败时的消息重试间隔 |
void ack(MessageView var1) | 消费者成功消费消息后,主动调用该接口向服务端返回消费成功响应 | var1:消息视图 |
void changeInvisibleDuration(MessageView var1, Duration var2) | 消费重试场景下,消费者可通过该接口修改消息处理时长,但是要满足消息处理未超时和消息处理未提交消费状态 | var1:消息视图;var2:消息的最长处理耗时 |
注:由于Apache RocketMQ服务端存储为分布式,可能会出现服务端实际有消息,但是返回为空的现象。 一般可通过重新发起ReceiveMessage调用或提高ReceiveMessage的并发度解决
3.SimpleConsumer消费者可靠性
(1)SimpleConsumer消费消息流程
SimpleConsumer消费者类型中,客户端SDK如果处理消息成功则调用AckMessage接口;如果处理失败只需要不回复ACK响应,即可在定义的消费不可见时间到达后触发消费重试流程
(2)SimpleConsumer消费重试策略
默认最大重试次数:16
消息重试间隔=不可见时间-消息实际处理时长
ready:已就绪状态。消息在Apache RocketMQ服务端已就绪,可以被消费者消费
inflight:处理中状态。消息被消费者客户端获取,处于消费中还未返回消费结果的状态
acked:提交状态。消费成功的状态,消费者返回成功响应即可结束消息的状态机
DLQ:死信状态。消费逻辑的最终兜底机制,若消息一直处理失败并不断进行重试,直到超过最大重试次数还未成功,此时消息不会再重试,会被投递至死信队列。可以通过消费死信队列的消息进行业务恢复
4.SimpleConsumer适用场景
(1)消息处理时长不可控
如果消息处理时长无法预估,经常有长时间耗时的消息处理情况。建议使用SimpleConsumer消费类型,可以在消费时自定义消息的预估处理时长,若实际业务中预估的消息处理时长不符合预期,也可以通过接口提前修改
(2)需要异步化、批量消费等高级定制场景
SimpleConsumer在SDK内部没有复杂的线程封装,完全由业务逻辑自由定制,可以实现异步分发、批量消费等高级定制场景
(3)需要自定义消费速率
SimpleConsumer是由业务逻辑主动调用接口获取消息,因此可以自由调整获取消息的频率,自定义控制消费速率
5.SimpleConsumer的顺序保障性
基于 Apache RocketMQ 顺序消息的定义,SimpleConsumer在处理顺序消息时,会按照消息存储的先后顺序获取消息。即需要保持顺序的一组消息中,如果前面的消息未处理完成,则无法获取到后面的消息
6.SimpleConsumer同步订阅代码示例
ClientServiceProvider provider = ClientServiceProvider.loadService();
StaticSessionCredentialsProvider staticSessionCredentialsProvider = new StaticSessionCredentialsProvider("accessKey", "secretKey");
ClientConfiguration configuration = ClientConfiguration.newBuilder()
.setEndpoints("endpoint")// 设置接入点
.setCredentialProvider(staticSessionCredentialsProvider)// 设置权限信息
.build();
// 主题名称
String topic = "topicName";
// 订阅消息的过滤规则,“*”表示订阅多有tag消息
FilterExpression filterExpression = new FilterExpression("*", FilterExpressionType.TAG);
SimpleConsumer simpleConsumer = provider.newSimpleConsumerBuilder()
.setConsumerGroup("consumerGroupName")// 设置消费者分组
.setClientConfiguration(configuration)
.setSubscriptionExpressions(Collections.singletonMap(topic, filterExpression))// 设置预绑定的订阅关系
.setAwaitDuration(Duration.ofSeconds(30))// 设置从服务端接收消息的最大等待时间
.build();
try {
int maxMessageNum = 10;// 每个长轮询获取的最大消息数量
Duration invisibleDuration = Duration.ofSeconds(10);// 消息不可见时间
do{
// SimpleConsumer 需要主动获取消息视图,并处理
List<MessageView> messageViewList = simpleConsumer.receive(maxMessageNum, invisibleDuration);
messageViewList.forEach(messageView -> {
try {
// 业务代码
... ...
// 消费处理完成后,需要主动调用 ACK 提交消费结果
simpleConsumer.ack(messageView);
} catch (ClientException e) {
logger.error("Failed to ack message, messageId={}", messageView.getMessageId(), e);
}
});
}while(true);
} catch (ClientException e) {
// 如果遇到系统流控等原因造成拉取失败,需要重新发起获取消息请求。
logger.error("Failed to receive message", e);
}