配置消息通道

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

  • 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,该 bean 是 Spring 的转换服务的实例。如果没有,则会立即抛出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对象。如果是后者,转换器必须注意从入站消息复制所有头。

或者,您可以声明一个类型为MessageConverter且 ID 为datatypeChannelMessageConverter<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 时,它会将消息添加到消息存储中。当从 QueueChannel 中轮询 Message 时,它将从消息存储中删除。

默认情况下,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 类。这是一个 BlockingQueue 实现,用于使用 MessageGroupStore 操作。

自定义 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 头部的 MessageChannel 或发送到全局 errorChannel 实例。如果未配置 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 属性中的正数确保拦截器在任何现有拦截器之后注入,而负数确保拦截器在现有拦截器之前注入。这意味着,在前面的示例中,全局拦截器是在(因为它的 order 大于 0)在本地配置的 'wire-tap' 拦截器之后注入的。如果还有另一个具有匹配 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"/>
“日志记录通道适配器”还接受一个“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,该 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 属性设置为目标通道名称。例如,您可以使用此技术来配置测试用例以验证通道上的消息。