Alex Guo
文章36
标签33
分类10
Spring Cloud Stream入门

Spring Cloud Stream入门

  • 引入依赖

          <dependency>
              <groupId>org.springframework.cloud</groupId>
              <artifactId>spring-cloud-starter-stream-rabbit</artifactId>
          </dependency>
    
  • 消息接收者

    @EnableBinding(Sink.class)
    public class SinkReceiver {
      private static Logger logger = LoggerFactory.getLogger(SinkReceiver.class);
    
      @StreamListener(Sink.INPUT)
      public void receive(Object payload) {
          logger.info("Received: " + payload);
      }
    }
    

@EnableBinding

该注解用来指定一个或多个定义了@Input或@Output注解的接口,
以此实现对消息通道(Channel)的绑定。
在上面的例子中,我们通过@EnableBinding(Sink.class)绑定了Sink接口,
该接口是Spring Cloud Stream中默认实现的对输入消息通道绑定的定义,

它的源码如下:

public interface Sink {

    String INPUT = "input";

    @Input(Sink.INPUT)
    SubscribableChannel input();
}

它通过@Input注解绑定了一个名为input的通道。

除了Sink之外,Spring Cloud Stream还默认实现了绑定output通道的Source接口,
还有结合了Sink和Source的Processor接口,

实际使用时我们也可以自己通过@Input和@Output注解来定义绑定消息通道的接口。

当我们需要为@EnableBinding指定多个接口来绑定消息通道的时候,
可以这样定义:@EnableBinding(value = {Sink.class, Source.class})。

@StreamListener

该注解主要定义在方法上,
作用是将被修饰的方法注册为消息中间件上数据流的事件监听器,
注解中的属性值对应了监听的消息通道名。

在上面的例子中,我们通过@StreamListener(Sink.INPUT)注解将receive方法注册为对input消息通道的监听处理器,
所以当我们在RabbitMQ的控制页面中发布消息的时候,receive方法会做出对应的响应动作。

消息生产者

@Test
public void sinkSenderTester() {
    sinkSender.output().send(MessageBuilder.withPayload("produce a message :http://blog.didispace.com").build());
}

public interface SinkSender {

    String OUTPUT = "input";

    @Output(SinkSender.OUTPUT)
    MessageChannel output();

}

@Output(SinkSender.OUTPUT)定义了一个输出通过,
而该输出通道的名称为input,与前文中的Sink中定义的消费通道同名,
所以这里的单元测试与前文的消费者程序组成了一对生产者与消费者。

本文作者:Alex Guo
本文链接:https://alexguo.net/2018/12/05/Spring-Cloud-Stream%E5%85%A5%E9%97%A8/
版权声明:本文采用 CC BY-NC-SA 3.0 CN 协议进行许可