配置消息通道

要创建消息通道实例,你可以使用 XML 的 <channel/> 元素或 Java 配置的 DirectChannel 实例,如下所示

  • Java

  • XML

@Bean
public MessageChannel exampleChannel() {
    return new DirectChannel();
}
<int:channel id="exampleChannel"/>

当你使用 <channel/> 元素而没有任何子元素时,它会创建一个 DirectChannel 实例(一个 SubscribableChannel)。

要创建一个发布-订阅通道,请使用 <publish-subscribe-channel/> 元素(Java 中的 PublishSubscribeChannel),如下所示

  • Java

  • XML

@Bean
public MessageChannel exampleChannel() {
    return new PublishSubscribeChannel();
}
<int:publish-subscribe-channel id="exampleChannel"/>

你还可以提供各种 <queue/> 子元素来创建任何可轮询的通道类型(如 消息通道实现 中所述)。以下各节展示了每种通道类型的示例。

DirectChannel 配置

如前所述,DirectChannel 是默认类型。以下列表展示了如何定义一个

  • Java

  • XML

@Bean
public MessageChannel directChannel() {
    return new DirectChannel();
}
<int:channel id="directChannel"/>

默认通道具有循环负载均衡器,并且启用了故障转移(有关详细信息,请参见 DirectChannel)。要禁用其中一个或两个功能,请添加一个 <dispatcher/> 子元素(DirectChannelLoadBalancingStrategy 构造函数),并按如下方式配置属性

  • Java

  • XML

@Bean
public MessageChannel failFastChannel() {
    DirectChannel channel = new DirectChannel();
    channel.setFailover(false);
    return channel;
}

@Bean
public MessageChannel failFastChannel() {
    return new DirectChannel(null);
}
<int:channel id="failFastChannel">
    <int:dispatcher failover="false"/>
</channel>

<int:channel id="channelWithFixedOrderSequenceFailover">
    <int:dispatcher load-balancer="none"/>
</int:channel>

从 6.3 版本开始,所有基于 UnicastingDispatcherMessageChannel 实现都可以配置 Predicate<Exception> failoverStrategy,而不是简单的 failover 选项。此谓词根据当前 MessageHandler 抛出的异常来决定是否故障转移到下一个 MessageHandler。更复杂的错误分析应使用 ErrorMessageExceptionTypeRouter 完成。

数据类型通道配置

有时,消费者只能处理特定类型的有效负载,这会强制你确保输入消息的有效负载类型。首先想到的是使用消息过滤器。但是,消息过滤器所能做的只是过滤掉不符合消费者要求的消息。另一种方法是使用基于内容的路由器,并将具有不兼容数据类型的消息路由到特定的转换器,以强制转换为所需的数据类型。这会奏效,但实现相同目的的一种更简单的方法是应用 数据类型通道 模式。你可以为每种特定的有效负载数据类型使用单独的数据类型通道。

要创建一个仅接受包含特定有效负载类型的消息的数据类型通道,请在通道元素的 datatype 属性中提供该数据类型的完全限定类名,如以下示例所示

  • Java

  • XML

@Bean
public MessageChannel numberChannel() {
    DirectChannel channel = new DirectChannel();
    channel.setDatatypes(Number.class);
    return channel;
}
<int:channel id="numberChannel" datatype="java.lang.Number"/>

请注意,类型检查会通过任何可分配给通道数据类型的类型。换句话说,前面示例中的 numberChannel 将接受其有效负载为 java.lang.Integerjava.lang.Double 的消息。可以提供多个类型作为逗号分隔列表,如以下示例所示

  • Java

  • XML

@Bean
public MessageChannel numberChannel() {
    DirectChannel channel = new DirectChannel();
    channel.setDatatypes(String.class, Number.class);
    return channel;
}
<int:channel id="stringOrNumberChannel" datatype="java.lang.String,java.lang.Number"/>

因此,前面示例中的 'numberChannel' 仅接受数据类型为 java.lang.Number 的消息。但是,如果消息的有效负载不是所需类型,会发生什么?这取决于你是否定义了一个名为 integrationConversionService 的 bean,它是 Spring 的 Conversion Service 的实例。如果没有,则会立即抛出 Exception。但是,如果你定义了 integrationConversionService bean,它将尝试将消息的有效负载转换为可接受的类型。

你甚至可以注册自定义转换器。例如,假设你向我们上面配置的 'numberChannel' 发送一个带有 String 有效负载的消息。你可以按如下方式处理消息

MessageChannel inChannel = context.getBean("numberChannel", MessageChannel.class);
inChannel.send(new GenericMessage<String>("5"));

通常,这将是一个完全合法的操作。但是,由于我们使用数据类型通道,此类操作的结果将生成类似于以下的异常

Exception in thread "main" org.springframework.integration.MessageDeliveryException:
Channel 'numberChannel'
expected one of the following datataypes [class java.lang.Number],
but received [class java.lang.String]
…

发生异常是因为我们要求有效负载类型为 Number,但我们发送了 String。所以我们需要一些东西将 String 转换为 Number。为此,我们可以实现一个类似于以下示例的转换器

public static class StringToIntegerConverter implements Converter<String, Integer> {
    public Integer convert(String source) {
        return Integer.parseInt(source);
    }
}

然后我们可以将其注册为集成转换服务的转换器,如以下示例所示

  • Java

  • XML

@Bean
@IntegrationConverter
public StringToIntegerConverter strToInt() {
    return new StringToIntegerConverter();
}
<int:converter ref="strToInt"/>

<bean id="strToInt" class="org.springframework.integration.util.Demo.StringToIntegerConverter"/>

或者在 StringToIntegerConverter 类上,当它被 @Component 注解标记用于自动扫描时。

解析 'converter' 元素时,如果尚未定义 integrationConversionService bean,则会创建它。有了该转换器,send 操作现在将成功,因为数据类型通道使用该转换器将 String 有效负载转换为 Integer

有关有效负载类型转换的更多信息,请参见 有效负载类型转换

从 4.0 版本开始,integrationConversionServiceDefaultDatatypeChannelMessageConverter 调用,它会在应用程序上下文中查找转换服务。要使用不同的转换技术,你可以在通道上指定 message-converter 属性。这必须是对 MessageConverter 实现的引用。仅使用 fromMessage 方法。它为转换器提供了访问消息头的权限(以防转换可能需要来自头的信息,例如 content-type)。该方法只能返回转换后的有效负载或完整的 Message 对象。如果是后者,转换器必须小心地从入站消息中复制所有头。

或者,你可以声明一个 ID 为 datatypeChannelMessageConverterMessageConverter 类型的 <bean/>,并且该转换器将由所有具有 datatype 的通道使用。

QueueChannel 配置

要创建 QueueChannel,请使用 <queue/> 子元素。你可以按如下方式指定通道的容量

  • Java

  • XML

@Bean
public PollableChannel queueChannel() {
    return new QueueChannel(25);
}
<int:channel id="queueChannel">
    <queue capacity="25"/>
</int:channel>
如果你未在此 <queue/> 子元素上为 'capacity' 属性提供值,则生成的队列是无界的。为避免内存不足等问题,我们强烈建议你为有界队列设置一个明确的值。

持久化 QueueChannel 配置

由于 QueueChannel 提供了缓冲消息的能力,但默认情况下仅在内存中执行此操作,因此它也带来了在系统故障时消息可能丢失的可能性。为了降低此风险,QueueChannel 可以由 MessageGroupStore 策略接口的持久化实现支持。有关 MessageGroupStoreMessageStore 的更多详细信息,请参见 消息存储

当使用 message-store 属性时,不允许使用 capacity 属性。

QueueChannel 接收到 Message 时,它会将消息添加到消息存储中。当 MessageQueueChannel 中轮询时,它会从消息存储中移除。

默认情况下,QueueChannel 将其消息存储在内存队列中,这可能导致前面提到的消息丢失场景。但是,Spring Integration 提供了持久化存储,例如 JdbcChannelMessageStore

你可以通过添加 message-store 属性来为任何 QueueChannel 配置消息存储,如以下示例所示

<int:channel id="dbBackedChannel">
    <int:queue message-store="channelStore"/>
</int:channel>

<bean id="channelStore" class="o.s.i.jdbc.store.JdbcChannelMessageStore">
    <property name="dataSource" ref="dataSource"/>
    <property name="channelMessageStoreQueryProvider" ref="queryProvider"/>
</bean>

(有关 Java/Kotlin 配置选项,请参见下面的示例。)

Spring Integration JDBC 模块还为许多流行的数据库提供了模式数据定义语言 (DDL)。这些模式位于该模块 (spring-integration-jdbc) 的 org.springframework.integration.jdbc.store.channel 包中。

一个重要的特性是,对于任何事务性持久化存储(例如 JdbcChannelMessageStore),只要轮询器配置了事务,从存储中删除的消息只有在事务成功完成时才能永久删除。否则,事务将回滚,并且 Message 不会丢失。

随着越来越多的与“NoSQL”数据存储相关的 Spring 项目为这些存储提供底层支持,消息存储的许多其他实现也可用。如果你找不到满足你特定需求的实现,你还可以提供自己的 MessageGroupStore 接口实现。

从 4.0 版本开始,建议 QueueChannel 实例尽可能配置为使用 ChannelMessageStore。与通用消息存储相比,这些通常针对此用途进行了优化。如果 ChannelMessageStoreChannelPriorityMessageStore,则消息将按优先级顺序以 FIFO 方式接收。优先级的概念由消息存储实现确定。例如,以下示例显示了 MongoDB 通道消息存储 的 Java 配置

  • Java

  • Java DSL

  • Kotlin DSL

@Bean
public BasicMessageGroupStore mongoDbChannelMessageStore(MongoDbFactory mongoDbFactory) {
    MongoDbChannelMessageStore store = new MongoDbChannelMessageStore(mongoDbFactory);
    store.setPriorityEnabled(true);
    return store;
}

@Bean
public PollableChannel priorityQueue(BasicMessageGroupStore mongoDbChannelMessageStore) {
    return new PriorityChannel(new MessageGroupQueue(mongoDbChannelMessageStore, "priorityQueue"));
}
@Bean
public IntegrationFlow priorityFlow(PriorityCapableChannelMessageStore mongoDbChannelMessageStore) {
    return IntegrationFlow.from((Channels c) ->
            c.priority("priorityChannel", mongoDbChannelMessageStore, "priorityGroup"))
            ....
            .get();
}
@Bean
fun priorityFlow(mongoDbChannelMessageStore: PriorityCapableChannelMessageStore) =
    integrationFlow {
        channel { priority("priorityChannel", mongoDbChannelMessageStore, "priorityGroup") }
    }
注意 MessageGroupQueue 类。这是一个用于使用 MessageGroupStore 操作的 BlockingQueue 实现。

自定义 QueueChannel 环境的另一个选项由 <int:queue> 子元素或其特定构造函数的 ref 属性提供。此属性提供对任何 java.util.Queue 实现的引用。例如,Hazelcast 分布式 IQueue 可以按如下方式配置

@Bean
public HazelcastInstance hazelcastInstance() {
    return Hazelcast.newHazelcastInstance(new Config()
                                           .setProperty("hazelcast.logging.type", "log4j"));
}

@Bean
public PollableChannel distributedQueue() {
    return new QueueChannel(hazelcastInstance()
                              .getQueue("springIntegrationQueue"));
}

PublishSubscribeChannel 配置

要创建 PublishSubscribeChannel,请使用 <publish-subscribe-channel/> 元素。使用此元素时,你还可以指定用于发布消息的 task-executor(如果未指定,则在发送者的线程中发布),如下所示

  • Java

  • XML

@Bean
public MessageChannel pubsubChannel() {
    return new PublishSubscribeChannel(someExecutor());
}
<int:publish-subscribe-channel id="pubsubChannel" task-executor="someExecutor"/>

如果你在 PublishSubscribeChannel 下游提供重新排序器或聚合器,则可以将通道上的 'apply-sequence' 属性设置为 true。这样做表示通道应在传递消息之前设置 sequence-sizesequence-number 消息头以及关联 ID。例如,如果有五个订阅者,则 sequence-size 将设置为 5,并且消息将具有从 15sequence-number 头值。

除了 Executor,你还可以配置 ErrorHandler。默认情况下,PublishSubscribeChannel 使用 MessagePublishingErrorHandler 实现将错误发送到来自 errorChannel 头或全局 errorChannel 实例的 MessageChannel。如果未配置 Executor,则 ErrorHandler 将被忽略,并且异常将直接抛给调用者的线程。

如果你在 PublishSubscribeChannel 下游提供 ResequencerAggregator,则可以将通道上的 'apply-sequence' 属性设置为 true。这样做表示通道应在传递消息之前设置 sequence-size 和 sequence-number 消息头以及关联 ID。例如,如果有五个订阅者,则 sequence-size 将设置为 5,并且消息将具有从 15 的 sequence-number 头值。

以下示例显示了如何将 apply-sequence 头设置为 true

  • Java

  • XML

@Bean
public MessageChannel pubsubChannel() {
    PublishSubscribeChannel channel = new PublishSubscribeChannel();
    channel.setApplySequence(true);
    return channel;
}
<int:publish-subscribe-channel id="pubsubChannel" apply-sequence="true"/>
apply-sequence 的值默认为 false,以便发布-订阅通道可以将完全相同的消息实例发送到多个出站通道。由于 Spring Integration 强制有效负载和头引用的不变性,当该标志设置为 true 时,通道会创建具有相同有效负载引用但不同头值的新 Message 实例。

从 5.4.3 版本开始,PublishSubscribeChannel 还可以配置其 BroadcastingDispatcherrequireSubscribers 选项,以指示当没有订阅者时,此通道不会默默地忽略消息。当没有订阅者并且此选项设置为 true 时,将抛出带有 Dispatcher has no subscribers 消息的 MessageDispatchingException

ExecutorChannel

要创建 ExecutorChannel,请添加带有 task-executor 属性的 <dispatcher> 子元素。该属性的值可以引用上下文中的任何 TaskExecutor。例如,这样做可以配置一个线程池,用于将消息分派给订阅的处理程序。如前所述,这样做会中断发送方和接收方之间的单线程执行上下文,以便任何活动事务上下文都不会被处理程序的调用共享(即,处理程序可能会抛出 Exception,但 send 调用已成功返回)。以下示例演示了如何使用 dispatcher 元素并在 task-executor 属性中指定执行器

  • Java

  • XML

@Bean
public MessageChannel executorChannel() {
    return new ExecutorChannel(someExecutor());
}
<int:channel id="executorChannel">
    <int:dispatcher task-executor="someExecutor"/>
</int:channel>

load-balancerfailover 选项也都在 <dispatcher/> 子元素上可用,如前面 DirectChannel 配置 中所述。适用相同的默认值。因此,除非为其中一个或两个属性提供了显式配置,否则通道具有启用故障转移的循环负载均衡策略,如以下示例所示

<int:channel id="executorChannelWithoutFailover">
    <int:dispatcher task-executor="someExecutor" failover="false"/>
</int:channel>

PriorityChannel 配置

要创建 PriorityChannel,请使用 <priority-queue/> 子元素,如以下示例所示

  • Java

  • XML

@Bean
public PollableChannel priorityChannel() {
    return new PriorityChannel(20);
}
<int:channel id="priorityChannel">
    <int:priority-queue capacity="20"/>
</int:channel>

默认情况下,通道会查看消息的 priority 头。但是,你也可以提供自定义的 Comparator 引用。此外,请注意 PriorityChannel(与其他类型一样)确实支持 datatype 属性。与 QueueChannel 一样,它也支持 capacity 属性。以下示例演示了所有这些

  • Java

  • XML

@Bean
public PollableChannel priorityChannel() {
    PriorityChannel channel = new PriorityChannel(20, widgetComparator());
    channel.setDatatypes(example.Widget.class);
    return channel;
}
<int:channel id="priorityChannel" datatype="example.Widget">
    <int:priority-queue comparator="widgetComparator"
                    capacity="10"/>
</int:channel>

从 4.0 版本开始,priority-channel 子元素支持 message-store 选项(在这种情况下不允许使用 comparatorcapacity)。消息存储必须是 PriorityCapableChannelMessageStore。目前为 RedisJDBCMongoDB 提供了 PriorityCapableChannelMessageStore 的实现。有关详细信息,请参见 QueueChannel 配置消息存储。你可以在 支持消息通道 中找到示例配置。

RendezvousChannel 配置

当队列子元素为 <rendezvous-queue> 时,将创建 RendezvousChannel。它不提供任何前面描述的额外配置选项,并且其队列不接受任何容量值,因为它是一个零容量的直接传递队列。以下示例显示了如何声明 RendezvousChannel

  • Java

  • XML

@Bean
public PollableChannel rendezvousChannel() {
    return new RendezvousChannel();
}
<int:channel id="rendezvousChannel"/>
    <int:rendezvous-queue/>
</int:channel>

作用域通道配置

任何通道都可以配置 scope 属性,如以下示例所示

<int:channel id="threadLocalChannel" scope="thread"/>

通道拦截器配置

消息通道也可以有拦截器,如 通道拦截器 中所述。<interceptors/> 子元素可以添加到 <channel/>(或更具体的元素类型)中。你可以提供 ref 属性来引用实现 ChannelInterceptor 接口的任何 Spring 管理对象,如以下示例所示

<int:channel id="exampleChannel">
    <int:interceptors>
        <ref bean="trafficMonitoringInterceptor"/>
    </int:interceptors>
</int:channel>

通常,我们建议在单独的位置定义拦截器实现,因为它们通常提供可以在多个通道之间重用的通用行为。

全局通道拦截器配置

通道拦截器提供了一种干净简洁的方式,可以为每个单独的通道应用横切行为。如果相同的行为应该应用于多个通道,那么为每个通道配置相同的拦截器集将不是最有效的方式。为了避免重复配置,同时还使拦截器能够应用于多个通道,Spring Integration 提供了全局拦截器。考虑以下两组示例

<int:channel-interceptor pattern="input*, thing2*, thing1, !cat*" order="3">
    <bean class="thing1.thing2SampleInterceptor"/>
</int:channel-interceptor>
<int:channel-interceptor ref="myInterceptor" pattern="input*, thing2*, thing1, !cat*" order="3"/>

<bean id="myInterceptor" class="thing1.thing2SampleInterceptor"/>

每个 <channel-interceptor/> 元素都允许你定义一个全局拦截器,该拦截器应用于所有与 pattern 属性定义的任何模式匹配的通道。在前面的例子中,全局拦截器应用于 'thing1' 通道以及所有以 'thing2' 或 'input' 开头的其他通道,但不应用于以 'thing3' 开头的通道(从 5.0 版本开始)。

在模式中添加此语法会导致一个可能的问题(尽管可能不太可能)。如果你有一个名为 !thing1 的 bean,并且你的通道拦截器的 pattern 模式中包含了 !thing1 的模式,它将不再匹配。该模式现在匹配所有不名为 thing1 的 bean。在这种情况下,你可以在模式中用 \ 转义 !。模式 \!thing1 将匹配名为 !thing1 的 bean。

order 属性允许你在给定通道上存在多个拦截器时管理此拦截器的注入位置。例如,通道 'inputChannel' 可以本地配置单独的拦截器,如以下示例所示

<int:channel id="inputChannel">
  <int:interceptors>
    <int:wire-tap channel="logger"/>
  </int:interceptors>
</int:channel>

一个合理的问题是“全局拦截器是如何相对于本地配置的其他拦截器或通过其他全局拦截器定义注入的?”当前实现提供了一个简单的机制来定义拦截器执行的顺序。order 属性中的正数确保拦截器在任何现有拦截器之后注入,而负数确保拦截器在现有拦截器之前注入。这意味着,在前面的示例中,全局拦截器在本地配置的 'wire-tap' 拦截器之后注入(因为它的 order 大于 0)。如果存在另一个具有匹配 pattern 的全局拦截器,其顺序将通过比较两个拦截器的 order 属性值来确定。要在现有拦截器之前注入全局拦截器,请对 order 属性使用负值。

请注意,orderpattern 属性都是可选的。order 的默认值为 0,pattern 的默认值为 '*'(匹配所有通道)。

消息窃听器

如前所述,Spring Integration 提供了一个简单的消息窃听器拦截器。你可以在 <interceptors/> 元素内的任何通道上配置消息窃听器。这样做对于调试特别有用,并且可以与 Spring Integration 的日志通道适配器结合使用,如下所示

<int:channel id="in">
    <int:interceptors>
        <int:wire-tap channel="logger"/>
    </int:interceptors>
</int:channel>

<int:logging-channel-adapter id="logger" level="DEBUG"/>
'logging-channel-adapter' 也接受一个 'expression' 属性,这样你就可以针对 'payload' 和 'headers' 变量评估 SpEL 表达式。或者,要记录完整的消息 toString() 结果,请为 'log-full-message' 属性提供 true 值。默认情况下,它为 false,因此只记录有效负载。将其设置为 true 可以记录所有头以及有效负载。'expression' 选项提供了最大的灵活性(例如,expression="payload.user.name")。

关于消息窃听器和其他类似组件(消息发布配置)的一个常见误解是它们本质上是自动异步的。默认情况下,消息窃听器作为组件不会异步调用。相反,Spring Integration 专注于一种统一的异步行为配置方法:消息通道。消息流的某些部分是同步还是异步取决于在该流中配置的消息通道的类型。这是消息通道抽象的主要优点之一。从框架诞生之初,我们就一直强调消息通道作为框架的一等公民的必要性和价值。它不仅仅是 EIP 模式的内部隐式实现。它完全作为可配置组件暴露给最终用户。因此,消息窃听器组件只负责执行以下任务

  • 通过窃听通道(例如 channelA)拦截消息流

  • 抓取每条消息

  • 将消息发送到另一个通道(例如 channelB

它本质上是桥接模式的一种变体,但它封装在通道定义中(因此更容易启用和禁用而不会中断流程)。此外,与桥接不同,它基本上分叉了另一个消息流。该流是同步的还是异步的?答案取决于 'channelB' 是哪种类型的消息通道。我们有以下选项:直接通道、可轮询通道和执行器通道。后两者打破了线程边界,使得通过此类通道的通信是异步的,因为消息从该通道分派到其订阅的处理程序发生在与用于将消息发送到该通道的线程不同的线程上。这就是使你的消息窃听流程同步或异步的原因。它与框架中的其他组件(例如消息发布者)保持一致,并通过让你无需提前担心(除了编写线程安全代码)特定代码片段是应该实现为同步还是异步,从而增加了一致性和简单性。两个代码片段(例如组件 A 和组件 B)通过消息通道的实际连接是使它们的协作同步或异步的原因。你甚至可能希望将来从同步更改为异步,而消息通道允许你快速完成,而无需触及代码。

关于消息窃听器的最后一点是,尽管上面提供了默认情况下不异步的理由,但你应该记住,通常希望尽快交出消息。因此,将异步通道选项用作消息窃听器的出站通道将是相当常见的。但是,异步行为并非默认强制执行。如果我们这样做,许多用例将会中断,包括你可能不想打破事务边界。也许你将消息窃听模式用于审计目的,并且你确实希望审计消息在原始事务中发送。例如,你可能将消息窃听器连接到 JMS 出站通道适配器。这样,你就可以两全其美:1)JMS 消息的发送可以在事务中发生,而 2)它仍然是“即发即弃”操作,从而防止主消息流中出现任何明显的延迟。

从 4.0 版本开始,当拦截器(例如 WireTap)引用通道时,避免循环引用非常重要。你需要将此类通道从被当前拦截器拦截的通道中排除。这可以通过适当的模式或编程方式完成。如果你有一个引用 channel 的自定义 ChannelInterceptor,请考虑实现 VetoCapableInterceptor。这样,框架会根据提供的模式询问拦截器是否可以拦截每个候选通道。你还可以在拦截器方法中添加运行时保护,以确保通道不是拦截器引用的通道。WireTap 使用了这两种技术。

从 4.3 版本开始,WireTap 具有额外的构造函数,它们接受 channelName 而不是 MessageChannel 实例。这对于 Java 配置和使用通道自动创建逻辑时非常方便。目标 MessageChannel bean 会在稍后,在与拦截器的第一次交互时,从提供的 channelName 中解析。

通道解析需要 BeanFactory,因此消息窃听器实例必须是一个 Spring 管理的 bean。

这种后期绑定方法还允许简化 Java DSL 配置的典型消息窃听模式,如以下示例所示

@Bean
public PollableChannel myChannel() {
    return MessageChannels.queue()
            .wireTap("loggingFlow.input")
            .get();
}

@Bean
public IntegrationFlow loggingFlow() {
    return f -> f.log();
}

条件消息窃听器

消息窃听器可以通过使用 selectorselector-expression 属性实现条件化。selector 引用一个 MessageSelector bean,它可以在运行时确定消息是否应该进入窃听通道。类似地,selector-expression 是一个布尔 SpEL 表达式,它执行相同的目的:如果表达式评估为 true,则消息发送到窃听通道。

全局消息窃听器配置

可以配置全局消息窃听器作为 全局通道拦截器配置 的特例。为此,请配置一个顶级 wire-tap 元素。现在,除了正常的 wire-tap 命名空间支持外,还支持 patternorder 属性,并且它们的工作方式与 channel-interceptor 完全相同。以下示例演示了如何配置全局消息窃听器

  • Java

  • XML

@Bean
@GlobalChannelInterceptor(patterns = "input*,thing2*,thing1", order = 3)
public WireTap wireTap(MessageChannel wiretapChannel) {
    return new WireTap(wiretapChannel);
}
<int:wire-tap pattern="input*, thing2*, thing1" order="3" channel="wiretapChannel"/>
全局消息窃听器提供了一种方便的方式,可以在不修改现有通道配置的情况下外部配置单通道消息窃听器。为此,请将 pattern 属性设置为目标通道名称。例如,你可以使用此技术来配置测试用例,以验证通道上的消息。
© . This site is unofficial and not affiliated with VMware.