概述
stream屏蔽底层消息中间件的差异,降低切换成本,统一消息的编程模型。
官方定义spring cloud stream是一个构建消息驱动微服务的框架。应用程序通过inputs或者outputs来与spring cloud stream中binder对象交互。通过配置来binding,而spring cloud stream的binder对象负责与消息中间件交互。
通过使用spring integration来连接消息代理中间件以实现消息事件驱动。spring cloud stream为一些供应商的消息中间件产品提供了个性化的自动化配置实现,引用了发布-订阅、消费组、分区的三个核心概念。
标准MQ:
- 生产者/消费者之间靠消息媒介传递信息内容。
- 消息必须走特定的通道。
不同消息中间件的架构不同,例如RabbitMQ有exchange,Kafka有topic和partition分区。这些中间件的差异性给实际项目开发造成一定困扰。如果用了两个消息中间件中的一种,后面业务需求需要往另外一种迁移,那将会导致很多东西推到重做,因为系统耦合,spring cloud stream提供了一种解耦合的方式。
spring cloud stream通过定义binder作为中间层,实现了应用程序与消息中间件之间的隔离,使得应用程序不需要考虑各种不同消息中间件实现。
在没有绑定器这个概念的情况下,我们的spring boot应用要直接与消息中间件进行信息交互的时候,由于消息中间件架构不同,它们在实现细节上有较大差异,通过定义绑定器作为中间层,完美实现了应用程序与消息中间件之间的隔离。stream对消息中间件的进一步封装,可以做到代码层面对中间件的无感知,甚至于动态的切换中间件(rabbitmq切换kafka),使得微服务开发的高度解耦,服务可以关注更多自己的业务流程。
Binder中input对应消费者、output对应生产者。
stream中的消息通信方式遵循了发布-订阅模式。
stream标准流程:
其中:
- Binder:连接中间件,屏蔽差异。
- Channel:通道,是队列Queue的一种抽象,在消息通讯系统中实现存储和转发的媒介,通过Channel对队列进行配置。
- Source/Sink:从stream发布消息就是输出,接收消息就是输入。
stream编码API和常用注解:
案例
配置rabbitmq。
创建cloud-stream-rabbitmq-provider8801,作为生产者进行发消息模块。
创建cloud-stream-rabbitmq-consumer8802,作为消费接收模块。
创建cloud-stream-rabbitmq-consumer8803,作为消费接收模块。
消息驱动之生产者
pom.xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-stream-rabbit</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
application.yml
server:
port: 8801
spring:
application:
name: cloud-stream-provider
cloud:
stream:
binders: # 在此处配置要绑定的rabbitmq的服务信息
defaultRabbit: # 表示定义的名称,用于binding整合
type: rabbit # 消息组件类型
environment: # 设置rabbitmq的相关环境配置
spring:
rabbitmq:
host: localhost
port: 5672
username: guest
password: guest
bindings: # 服务的整合处理
output: # 通道名称
destination: studyExchange # 表示要使用的exchange名称定义
content-type: application/json # 消息类型为json,文本为text/plain
binder: defaultRabbit # 设置要绑定的消息服务的具体设置
eureka:
client:
service-url:
defaultZone: http://localhost:7001/eureka
instance:
lease-renewal-interval-in-seconds: 2 # 设置心跳的时间间隔(默认30s)
lease-exiration-duration-in-seconds: 5 #
instance-id: send-8801.com # 在信息列表中显式主机名称
prefer-ip-address: true # 访问路径变为ip地址
StreamMQMain8801
@SpringBootApplication
public class StreamMQMain8801 {
public static void main(String[] args) {
SpringApplication.run(StreamMQMain8801.class,args);
}
}
IMessageProvider
public interface IMessageProvider{
public String send();
}
IMessageProviderImpl
@EnableBinding(Source.class) //定义消息推送管道
public class IMessageProviderImpl implements IMessageProvider{
@Resource
private MessageChannel output; //消息发送管道
@Overrride
public String send() {
String serial = UUID.randomUUID().toString();
output.send(MessageBuilder.withPayload(serial).build());
return null;
}
}
@RestController
public class SendMessageController{
@Resource
private IMessageProvider messageProvider;
@GetMapping(value = "/sendMessage")
public String sendMessage() {
return messageProvider.send();
}
}
消息驱动之消费者
pom.xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-stream-rabbit</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
application.yml
server:
port: 8802
spring:
application:
name: cloud-stream-consumer
cloud:
stream:
binders: # 在此处配置要绑定的rabbitmq的服务信息
defaultRabbit: # 表示定义的名称,用于binding整合
type: rabbit # 消息组件类型
environment: # 设置rabbitmq的相关环境配置
spring:
rabbitmq:
host: localhost
port: 5672
username: guest
password: guest
bindings: # 服务的整合处理
input: # 通道名称
destination: studyExchange # 表示要使用的exchange名称定义
content-type: application/json # 消息类型为json,文本为text/plain
binder: defaultRabbit # 设置要绑定的消息服务的具体设置
eureka:
client:
service-url:
defaultZone: http://localhost:7001/eureka
instance:
lease-renewal-interval-in-seconds: 2 # 设置心跳的时间间隔(默认30s)
lease-exiration-duration-in-seconds: 5 #
instance-id: receive-8802.com # 在信息列表中显式主机名称
prefer-ip-address: true # 访问路径变为ip地址
StreamMQMain8802
@SpringBootApplication
public class StreamMQMain8802 {
public static void main(String[] args) {
SpringApplication.run(StreamMQMain8802.class,args);
}
}
ReceiveMessageListenerController
@Component
@EnableBinding(Sink.class)
public class ReceiveMessageListenerController{
@Resource
private IMessageProvider messageProvider;
@StreamListener(Sink.INPUT)
public void input(Message<String> message) {
sout(message.getPayload());
}
}
分组消费与持久化
启动rabbitmq以及微服务:7001服务注册、8801消息生产、8802消息消费、8803消息消费。
运行后有两个问题:
- 重复消费
- 消息持久化
分组消费
8802和8803都收到了消息,存在重复消费问题。
在stream中处于同一分组中的多个消费者是竞争关系,就能够保证消息只会被其中一个应用消费一次,不同组是可以重复消费的。
微服务应用放置于同一个group中,就能够保证消息只会被其中一个应用消费一次。不同的组是可以消费的,同一个组内会发生竞争关系,只有其中一个可以消费。
修改8802、8803的yml文件,增加配置group: qrxA
,即可完成分组。
server:
port: 8802
spring:
application:
name: cloud-stream-consumer
cloud:
stream:
binders: # 在此处配置要绑定的rabbitmq的服务信息
defaultRabbit: # 表示定义的名称,用于binding整合
type: rabbit # 消息组件类型
environment: # 设置rabbitmq的相关环境配置
spring:
rabbitmq:
host: localhost
port: 5672
username: guest
password: guest
bindings: # 服务的整合处理
input: # 通道名称
destination: studyExchange # 表示要使用的exchange名称定义
content-type: application/json # 消息类型为json,文本为text/plain
binder: defaultRabbit # 设置要绑定的消息服务的具体设置
group: qrxA
eureka:
client:
service-url:
defaultZone: http://localhost:7001/eureka
instance:
lease-renewal-interval-in-seconds: 2 # 设置心跳的时间间隔(默认30s)
lease-exiration-duration-in-seconds: 5 #
instance-id: receive-8802.com # 在信息列表中显式主机名称
prefer-ip-address: true # 访问路径变为ip地址
持久化
在分组中的消费者重启后,接收未曾消费过的消息。
不在分组中的消费者重启后,无法接收未曾消费过的消息。