com.alibaba.rocketmq.client.consumer
接口 MQPushConsumer

所有超级接口：

MQAdmin, MQConsumer

所有已知实现类：

DefaultMQPushConsumer

public interface MQPushConsumer
extends MQConsumer

消费者，被动方式消费

从以下版本开始：

2013-7-24

作者：

shijia.wxr

方法摘要

void	registerMessageListener(MessageListener messageListener) 注册消息监听器，一个Consumer只能有一个监听器
void	resume() 消费线程恢复，继续消费
void	shutdown() 关闭服务，一旦关闭，此对象将不可用
void	start() 启动服务，调用之前确保registerMessageListener与subscribe都已经调用 或者已经通过Spring注入了相关配置
void	subscribe(String topic, String subExpression) 订阅消息，方法可以调用多次来订阅不同的Topic，也可覆盖之前Topic的订阅过滤表达式
void	suspend() 消费线程挂起，暂停消费
void	unsubscribe(String topic) 取消订阅，从当前订阅组内注销，消息会被订阅组内其他订阅者订阅
void	updateCorePoolSize(int corePoolSize) 动态调整消费线程池线程数量

从接口 com.alibaba.rocketmq.client.consumer.MQConsumer 继承的方法

fetchSubscribeMessageQueues, sendMessageBack

从接口 com.alibaba.rocketmq.client.MQAdmin 继承的方法

createTopic, earliestMsgStoreTime, maxOffset, minOffset, queryMessage, searchOffset, viewMessage

方法详细信息

start

void start()
           throws MQClientException

启动服务，调用之前确保registerMessageListener与subscribe都已经调用
或者已经通过Spring注入了相关配置

抛出：

MQClientException

shutdown

void shutdown()

关闭服务，一旦关闭，此对象将不可用

registerMessageListener

void registerMessageListener(MessageListener messageListener)

注册消息监听器，一个Consumer只能有一个监听器

参数：

messageListener -

subscribe

void subscribe(String topic,
               String subExpression)
               throws MQClientException

订阅消息，方法可以调用多次来订阅不同的Topic，也可覆盖之前Topic的订阅过滤表达式

参数：

topic - 消息主题

subExpression - 订阅过滤表达式字符串，broker依据此表达式进行过滤。目前只支持或运算
eg: "tag1 || tag2 || tag3"
如果subExpression等于null或者*，则表示全部订阅

listener - 消息回调监听器

抛出：

MQClientException

unsubscribe

void unsubscribe(String topic)

取消订阅，从当前订阅组内注销，消息会被订阅组内其他订阅者订阅

参数：

topic - 消息主题

updateCorePoolSize

void updateCorePoolSize(int corePoolSize)

动态调整消费线程池线程数量

参数：

corePoolSize -

suspend

void suspend()

消费线程挂起，暂停消费

resume

void resume()

消费线程恢复，继续消费