Spring Cloud Stream總結(jié)

概念

1、group：

組內(nèi)只有1個(gè)實(shí)例消費(fèi)。如果不設(shè)置group，則stream會自動(dòng)為每個(gè)實(shí)例創(chuàng)建匿名且獨(dú)立的group——于是每個(gè)實(shí)例都會消費(fèi)

組內(nèi)單次只有1個(gè)實(shí)例消費(fèi)，并且會輪詢負(fù)載均衡。通常，在將應(yīng)用程序綁定到給定目標(biāo)時(shí)，最好始終指定consumer group

2、destination binder：

與外部消息系統(tǒng)通信的組件，為構(gòu)造 Binding提供了 2 個(gè)方法，分別是 bindConsumer 和 bindProducer ，它們分別用于構(gòu)造生產(chǎn)者和消費(fèi)者。Binder使Spring Cloud Stream應(yīng)用程序可以靈活地連接到中間件，目前spring為kafka、rabbitmq提供binder

3、destination binding：

Binding 是連接應(yīng)用程序跟消息中間件的橋梁，用于消息的消費(fèi)和生產(chǎn)，由binder創(chuàng)建

4、partition

一個(gè)或多個(gè)生產(chǎn)者將數(shù)據(jù)發(fā)送到多個(gè)消費(fèi)者，并確保有共同特征標(biāo)識的數(shù)據(jù)由同一個(gè)消費(fèi)者處理。默認(rèn)是對消息進(jìn)行hashCode，然后根據(jù)分區(qū)個(gè)數(shù)取余，所以對于相同的消息，總會落到同一個(gè)消費(fèi)者上

注：嚴(yán)格來說partition不屬于概念，而是一種Stream提高伸縮性、吞吐量的一種方式

注解

1、@Input，使用示例：

public interface MySink {
    @Input("my-input")
    SubscribableChannel input();
}

作用：

• 用于接收消息
• 為每個(gè)binding生成channel實(shí)例
• 指定input channel的名稱
• 在spring容器中生成一個(gè)名為my-input，類型為SubscribableChannel的bean
• 在spring容器中生成一個(gè)類，實(shí)現(xiàn)MySink接口。

2、@Output，使用示例：

public interface MySource {
    @Output("my-output")
    MessageChannel output();
}

作用：

• 與@Input類似，只不過是用來生產(chǎn)消息

3、@StreamListener，使用示例：

@StreamListener(value = Sink.INPUT, condition = "headers['type']=='dog'")
public void receive(String messageBody) {
    log.info("Received: {}", messageBody);
}

作用：

• 用于消費(fèi)消息
• condition的作用：用于過濾消息，只有符合條件表達(dá)式的消息才會被處理
• condition起作用的兩個(gè)條件：
  • 注解的方法沒有返回值
  • 方法是一個(gè)獨(dú)立方法，不支持Reactive API

4、@SendTo，使用示例：

// 接收INPUT這個(gè)channel的消息，并將返回值發(fā)送到OUTPUT這個(gè)channel
@StreamListener(Sink.INPUT)
@SendTo(Source.OUTPUT)
public String receive(String receiveMsg) {
   return "handle...";
}

作用：

• 用于發(fā)送消息

4、@InboundChannelAdapter，使用示例：

@Bean
@InboundChannelAdapter(value = Source.OUTPUT,
        poller = @Poller(fixedDelay = "10", maxMessagesPerPoll = "1"))
public MessageSource<String> producer() {
    return () -> new GenericMessage<>("Hello Spring Cloud Stream");
}

作用：

• 讓添加該注解的方法生產(chǎn)消息
• fixedDelay：多少毫秒發(fā)送1次
• maxMessagesPerPoll：每次發(fā)送多少條消息

5、@ServiceActivator，使用示例：

@ServiceActivator(inputChannel = Sink.INPUT, outputChannel = Source.OUTPUT)
public String transform(String payload) {
    return payload.toUpperCase();
}

作用：

• 標(biāo)注該注解的方法能夠處理消息或消息的有效內(nèi)容，通過監(jiān)聽input消息，用方法體的代碼處理后，輸出到output中

6、@Transformer，使用示例：

@Transformer(inputChannel = Processor.INPUT, outputChannel = Processor.OUTPUT)
public Object transform(String message) {
  return message.toUpperCase();
}

作用：

• 與@ServiceActivator類似，標(biāo)注該注解的方法能夠轉(zhuǎn)換消息，消息頭，或消息有效內(nèi)容

PollableMessageSource

PollableMessageSource允許消費(fèi)者可以控制消費(fèi)速率。舉個(gè)例子簡單演示一下，首先定義一個(gè)接口：

public interface PolledProcessor {
    @Input("pollable-input")
    PollableMessageSource input();
}

使用示例：

@Autowired
private PolledProcessor polledProcessor;

@Scheduled(fixedDelay = 5_000)
public void poll() {
    polledProcessor.input().poll(message -> {
        byte[] bytes = (byte[]) message.getPayload();
        String payload = new String(bytes);
        System.out.println(payload);
    });
}

參考：

https://spring.io/blog/2018/02/27/spring-cloud-stream-2-0-polled-consumers