@@ -6,25 +6,25 @@
[RocketMQ ](https://rocketmq.apache.org/ ) 是一款开源的分布式消息系统，基于高可用分布式集群技术，提供低延时的、高可靠的消息发布与订阅服务。
在说明RocketMQ的示例之前，
在说明 RocketMQ 的示例之前，我们先了解一下 Spring Cloud Stream。
这是官方对Spring Cloud Stream的一段介绍：
这是官方对 Spring Cloud Stream 的一段介绍：
Spring Cloud Stream是一个用于构建基于消息的微服务应用框架。它基于SpringBoot来创建具有生产级别的单机Spring应用， `Spring Integration` 与Broker进行连接。
Spring Cloud Stream 是一个用于构建基于消息的微服务应用框架。它基于 SpringBoot 来创建具有生产级别的单机 Spring 应用，并且使用 `Spring Integration` 与 Broker 进行连接。
Spring Cloud Stream提供了消息中间件配置的统一抽象，
Spring Cloud Stream 提供了消息中间件配置的统一抽象，推出了 publish-subscribe、consumer groups、partition 这些统一的概念。
Spring Cloud Stream 内部有2 个概念：
Spring Cloud Stream 内部有两 个概念：
* Binder: 跟外部消息中间件集成的组件， ，
* Binder: 跟外部消息中间件集成的组件，用来创建 Binding， Binder 实现。
比如 `Kafka` 的实现 `KafkaMessageChannelBinder` ， `RabbitMQ` 的实现 `RabbitMessageChannelBinder` 以及 `RocketMQ` 的实现 `RocketMQMessageChannelBinder` 。
比如 `Kafka` 的实现 `KafkaMessageChannelBinder` ， `RabbitMQ` 的实现 `RabbitMessageChannelBinder` 以及 `RocketMQ` 的实现 `RocketMQMessageChannelBinder` 。
* Binding: 包括Input Binding和 Output Binding。
* Binding: 包括 Input Binding 和 Output Binding。
Binding在消息中间件与应用程序提供的Provider和 Consumer之间提供了一个桥梁， 或 Consumer生产或消费数据即可，
Binding 在消息中间件与应用程序提供的 Provider 和 Consumer 之间提供了一个桥梁，实现了开发者只需使用应用程序的 Provider 或 Consumer 生产或消费数据即可，屏蔽了开发者与底层消息中间件的接触。
下图是Spring Cloud Stream的架构设计。
下图是 Spring Cloud Stream 的架构设计。
@@ -40,12 +40,12 @@ Binding在消息中间件与应用程序提供的Provider和Consumer之间提供
```xml
<dependency>
<groupId> org.springframework .cloud</groupId>
<groupId> com.alibaba .cloud</groupId>
<artifactId> spring-cloud-starter-stream-rocketmq</artifactId>
</dependency>
```
2. 配置Input和 Output的 Binding信息并配合`@EnableBinding` 注解使其生效
2. 配置 Input 和 Output 的 Binding 信息并配合 `@EnableBinding` 注解使其生效
```java
@SpringBootApplication
@@ -57,10 +57,10 @@ public class RocketMQApplication {
}
```
配置Binding信息：
配置 Binding 信息：
```properties
# 配置rocketmq的nameserver地址
spring.cloud.stream.rocketmq.binder.namesrv-add r = 127.0.0.1:9876
spring.cloud.stream.rocketmq.binder.name-serve r = 127.0.0.1:9876
# 定义name为output的binding
spring.cloud.stream.bindings.output.destination = test-topic
spring.cloud.stream.bindings.output.content-type = application/json
@@ -75,7 +75,7 @@ spring.cloud.stream.bindings.input.group=test-group
### 下载并启动 RocketMQ
在接入RocketMQ Binder之前， 的 Name Server和 Broker。
** 在接入 RocketMQ Binder 之前，首先需要启动 RocketMQ 的 Name Server 和 Broker。**
1. 下载[RocketMQ最新的二进制文件 ](https://www.apache.org/dyn/closer.cgi?path=rocketmq/4.3.2/rocketmq-all-4.3.2-bin-release.zip )，并解压
@@ -85,13 +85,13 @@ spring.cloud.stream.bindings.input.group=test-group
```
3. 启动Broker
3. 启动 Broker
```bash
```
4. 创建Topic: test-topic
4. 创建 Topic: test-topic
```bash
@@ -108,24 +108,24 @@ server.port=28081
2. 启动应用，支持 IDE 直接启动和编译打包后启动。
1. IDE直接启动： `RocketMQApplication` ，执行 main 方法启动应用。
2. 打包编译后启动：首先执行 `mvn clean package` 将工程编译打包，然后执行 `java -jar rocketmq-example.jar` 启动应用。
1. IDE 直接启动：找到主类 `RocketMQApplication` ，执行 main 方法启动应用。
2. 打包编译后启动：首先执行 `mvn clean package` 将工程编译打包，然后执行 `java -jar rocketmq-example.jar` 启动应用。
### 消息处理
使用name为 output对应的binding发送消息到test-topic这个topic。
使用 name 为 output 对应的 binding 发送消息到 test-topic 这个 topic。
使用2个input binding订阅数据。
使用2个 input binding 订阅数据。
* input1： 为 test-topic的消息，
* input1: 订阅 topic 为 test-topic 的消息，顺序消费所有消息(顺序消费的前提是所有消息都在一个 MessageQueue 中)
* input2： 为 test-topic的消息， 为 tagStr的消息，
* input2: 订阅 topic 为 test-topic 的消息，异步消费 tags 为 tagStr 的消息， 端线程池个数为20
配置信息如下：
```properties
spring.cloud.stream.rocketmq.binder.namesrv-add r = 127.0.0.1:9876
spring.cloud.stream.rocketmq.binder.name-serve r = 127.0.0.1:9876
spring.cloud.stream.bindings.output.destination = test-topic
spring.cloud.stream.bindings.output.content-type = application/json
@@ -146,7 +146,7 @@ spring.cloud.stream.bindings.input2.consumer.concurrency=20
#### 消息发送
使用MessageChannel进行消息发送：
使用 MessageChannel 进行消息发送：
```java
public class ProducerRunner implements CommandLineRunner {
@@ -162,7 +162,7 @@ public class ProducerRunner implements CommandLineRunner {
}
```
或者使用RocketMQ原生的API进行消息发送:
或者使用 RocketMQ 原生的 API 进行消息发送:
```java
public class RocketMQProducer {
@@ -177,7 +177,7 @@ public class RocketMQProducer {
#### 消息接收
使用`@StreamListener` 注解接收消息：
使用 `@StreamListener` 注解接收消息：
```java
@Service
@@ -204,7 +204,7 @@ Spring Boot 应用支持通过 Endpoint 来暴露相关信息，
* Spring Boot 1.x 中添加配置 `management.security.enabled=false`
* Spring Boot 2.x 中添加配置 `management.endpoints.web.exposure.include=*`
Spring Boot 1.x 可以通过访问 http://127.0.0.1:2 8081 /rocketmq_binder 来查看 RocketMQ Binder Endpoint 的信息。Spring Boot 2.x 可以通过访问 http://127.0.0.1:28081/actuator/rocketmq-binder 来访问。
Spring Boot 1.x 可以通过访问 http://127.0.0.1:1 8083 /rocketmq_binder 来查看 RocketMQ Binder Endpoint 的信息。Spring Boot 2.x 可以通过访问 http://127.0.0.1:28081/actuator/rocketmq-binder 来访问。
这里会统计消息最后一次发送的数据，消息发送成功或失败的次数，消息消费成功或失败的次数等数据。
@@ -258,7 +258,7 @@ Spring Boot 1.x 可以通过访问 http://127.0.0.1:28081/rocketmq_binder 来查
}
```
注意： metrics-core依赖 ](https://mvnrepository.com/artifact/io.dropwizard.metrics/metrics-core ) 。如若不加， ：
注意： metrics-core依赖 ](https://mvnrepository.com/artifact/io.dropwizard.metrics/metrics-core )。如若不加， 将会显示 warning 信息而不会显示统计信息：
```json
{
fangjian0423