体验链接:https://developer.aliyun.com/adc/scenario/fb1b72ee956a4068a95228066c3a40d6
实验简介
本教程将Demo演示使用java客户端发送消息和消费的应用场景
实验实操
第1节 如何发送和消费并发消息
并发消息,也叫普通消息,是相对顺序消息而言的,普通消息的效率最高。本教程将简单演示如何使用纯java client发送和消费消息。
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
再执行命令, 可以看到正常生产和消费输出
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.ConcurrentMessageDemo" -Dexec.classpathScope=runtime
3. Demo代码说明
Demo代码可以查看github。并发消息,意思是生产者可以并发的向topic中发送消息, 消费端不区分顺序的消息,这种模式效率最好。生产者demo代码如下:
最后留一个思考题给大家: 生产者实例和消费者实例, 都是线程安全的吗?
第2节 如何发送和消费顺序消息
顺序消息分为分区有序和全局有序。生产消费代码都是一样的, 区别在于分区有序的topic中queue个数可以是任意有效值,全局有序的topic要求queue的个数为1。顺序消息的实现非常简单易懂,但牺牲了可用性,单节点故障会直接影响顺序消息。
什么是分区有序消息,什么场景应该使用呢,又该如何发送分区有序消息?分区有序表示在一个queue中的消息是有序的,发送消息时设置设置了相同key的消息会被发送到同一个queue中。
本教程将简单演示如何使用纯java client发送和消费顺序消息。
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
再执行命令, 可以看到正常生产和消费输出。 消费输出注意看相同queue id的消息输出内容中的数字,按照从小到大就是正确的。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.OrderMessageDemo1" -Dexec.classpathScope=runtime
3. Demo代码说明
Demo代码可以查看github。
- 生产者说明
生产者会根据设置的keys做hash,相同hash值的消息会发送到相同的queue中。所以相同hash值的消息需要保证在同一个线程中顺序的发送。
- 消费者说明
消费者使用相对比较简单, 消息监听类实现org.apache.rocketmq.client.consumer.listener.MessageListenerOrderly接口即可。相同queue的消息需要串行处理,这样救保证消费的顺序性
第3节 如何发送和消费延迟消息
延迟消息,对于一些特殊场景比如订票后30分钟不支付自动取消等类似场景比较有用。本教程将简单演示如何使用纯java client发送和消费延迟消息。
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
执行命令, 可以看到正常生产和消费输出。 目前RocketMQ支持多种延迟级别, 不过每种延迟级别都是基于RocketMQ自身,实际延迟时间会加上Broker-Client端的网络情况不同而略有差异。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.DelayMessageDemo" -Dexec.classpathScope=runtime
3. Demo代码说明
Demo代码可以查看github。
- 生产者说明
生产者在发送消息的时候需要设置延迟级别,RocketMQ支持多种延迟级别。如果把延迟时间算作一个以空格分割的数组,延迟级别就是延迟时间数组的下标index+1。RocketMQ如何解析延迟级别和延迟时间映射关系。
- 消费者说明: 消费者按照并发消息消费即可
第4节 如何发送和消费事务消息
事务消息,是RocketMQ解决分布式事务的一种实现,极其简单好用。一个事物消息大致的生命周期如下图
概括为如下几个重要点:
- 生产者发送half消息(事物消息)
- Broker存储half消息
- 生产者处理本地事物,处理成功后commit事物
- 消费者消费到事物消息
本教程将简单演示如何使用纯java client发送和消费事物消息。
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
执行命令, 可以看到事物消息的全部过程。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.TransactionMessageDemo" -Dexec.classpathScope=runtime
3. Demo代码说明
Demo代码可以查看github。在事物消息中,消费代码和普通消息的消费一样,主要代码在生产者端。
生产者端的主要代码包含3个步骤:
- 初始化生产者,设置回调线程池、设置本地事物处理监听类。
这里注意事物消息的生产者类是: org.apache.rocketmq.client.producer.TransactionMQProducer, 而不是普通生产者类。
事物监听类需要实现2个方法,这里的逻辑都是mock的,实际使用的时候需要根据实际修改。
- 发送事物消息。调用sendMessageInTransaction()方法发送事物消息, 而不是以前的send()方法。
第5节 生产者消费者如何同步发送、消费消息(Request-Reply)
request-reply模式,可以满足目前类似RPC同步调用的场景,本教程将简单演示如何使用该模式。
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
执行命令, 可以看到正常生产和消费输出。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.RequestReplyMessageDemo" -Dexec.classpathScope=runtime
通过代码结果和代码比较, 我们得知request-reply类似RPC同步调用的效果。
个人觉得:需要同步调用就用RPC, 不要走MQ,毕竟两者是完全不同的目标的产品,专业的事情交给专业的产品。
3. Demo代码说明
Demo代码可以查看github。
request-reply模式,在生产者和消费者两端都和一般的生产消费有区别,下面分别介绍下demo代码。
生产者demo主要代码, 主要区别在于调用request(),而不是send()方法。
消费者demo主要代码: 消费代码主要增加了“回复”逻辑。回复是利用消息发送直接向生产者发送一条消息。 有点类似事物消息中broker回查生产者。
一个小问题:事物消息和request-reply消息时,生产者的生产者组名有什么要求嘛?
第6节 如何有选择性的消费消息
有时候我们只想消费部分消息, 当然全部消费,在代码中过滤。 假如消息海量时, 会有很多资源浪费,比如浪费不必要的带宽。我们可以通过tag,sql92表达式来选择性的消费。
- 进入broker目录
cd /usr/local/services/5-rocketmq/broker-01
- 编辑配置文件,修改broker配置项2个
vim conf/broker.conf
配置项值:
// 是否支持重试消息也过滤
filterSupportRetry=true
// 支持属性过滤
enablePropertyFilter=true
修改后:
- 重启broker
./restart.sh
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行tag过滤代码demo
执行命令, 可以看到正常生产和消费输出。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876 tag" -Dexec.mainClass="org.apache.rocketmqdemos.FliterMessageDemo" -Dexec.classpathScope=runtime
3. 执行sql过滤代码demo
执行命令, 可以看到正常生产和消费输出。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876 sql" -Dexec.mainClass="org.apache.rocketmqdemos.FliterMessageDemo" -Dexec.classpathScope=runtime
4. Demo代码说明
Demo代码可以查看github。以下分别介绍生产者和消费者主要demo代码。
- 生产者
在生产tag消息的时候, 消息中需要加上发送tag;sql92过滤的时候,加上自定义k-v。
- 消费者
tag过滤消费时,在订阅topic时, 也添加上tag订阅
SQL92过滤时,添加上SQL过滤订阅。至于SQL92除了等号,还是支持什么,大家可以自行自行查看或者到群里问。
第7节 如何使用ACL客户端生产消费消息
ACL,全称是Access Control List,是RocketMQ设计来做访问和权限控制的。更多文档参见github wiki:https://github.com/apache/rocketmq/wiki/RIP-5-RocketMQ-ACL
0. 启动一个集群
- 进入broker目录
cd /usr/local/services/5-rocketmq/broker-01
- 编辑配置文件,修改broker配置项1个
vim conf/broker.conf
配置项值:
aclEnable=true
修改后:
- 重启broker
./restart.sh
1. 下载java代码demo(已下载则忽略操作)
cd /data/demos
git clone https://github.com/ApacheRocketMQ/06-all-java-demos.git
2. 打包,执行代码demo
执行命令, 可以看到正常生产和消费输出。 demo代码使用的admin权限发送和消费,实际使用需要对于每个topic,消费者组授权,才能正常生产消费。
// 进入demo代码目录
cd /data/demos/06-all-java-demos/
// 打包
mvn clean package
// 运行代码
mvn exec:java -Dexec.args="127.0.0.1:39876" -Dexec.mainClass="org.apache.rocketmqdemos.ACLDemo" -Dexec.classpathScope=runtime
3. Demo代码说明
Demo代码可以查看github。带ACL的生产者和消费者在初始化的时候,都必须给一个hook实例,构建方法如下:
static RPCHook getAclRPCHook(String accessKey, String secretKey) {
return new AclClientRPCHook(new SessionCredentials(accessKey, secretKey));
}
在broker端secret key用来校验信息的完整性, access key用来校验用户权限。二者缺一不可。