此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Integration 6.4.0! |
流支持
在许多情况下,应用程序数据是从流中获取的。 建议不要将对流的引用作为消息负载发送给使用者。 相反,消息是从输入流中读取的数据创建的,并且消息负载将逐个写入输出流。
您需要将此依赖项包含在您的项目中:
-
Maven
-
Gradle
<dependency>
<groupId>org.springframework.integration</groupId>
<artifactId>spring-integration-stream</artifactId>
<version>6.4.1-SNAPSHOT</version>
</dependency>
compile "org.springframework.integration:spring-integration-stream:6.4.1-SNAPSHOT"
从 Streams 中读取
Spring 集成为流提供了两个适配器。
两者 和 实现 .
通过在 channel-adapter 元素中配置其中一个,可以配置轮询周期,并且消息总线可以自动检测和调度它们。
字节流版本需要 ,而字符流版本需要 a 作为单个构造函数参数。
它还接受 'bytesPerMessage' 属性,以确定它尝试读取到每个 .
默认值为 .
以下示例创建一个输入流,该流创建每个消息包含 2048 字节的消息:ByteStreamReadingMessageSource
CharacterStreamReadingMessageSource
MessageSource
InputStream
Reader
ByteStreamReadingMessageSource
Message
1024
<bean class="org.springframework.integration.stream.ByteStreamReadingMessageSource">
<constructor-arg ref="someInputStream"/>
<property name="bytesPerMessage" value="2048"/>
</bean>
<bean class="org.springframework.integration.stream.CharacterStreamReadingMessageSource">
<constructor-arg ref="someReader"/>
</bean>
将读取器包装在 a 中(如果它还不是读取器)。
您可以在第二个 constructor 参数中设置缓冲读取器使用的缓冲区大小。
从版本 5.0 开始,第三个构造函数参数 () 控制 .
When (默认值),该方法检查读取器是否为,如果不是,则返回 null。
在这种情况下,不会检测到 EOF(文件结束)。
当 时,该方法将阻塞,直到数据可用或在底层流上检测到 EOF。
检测到 EOF 时,将发布 (应用程序事件)。
您可以将此事件与实现 .CharacterStreamReadingMessageSource
BufferedReader
blockToDetectEOF
CharacterStreamReadingMessageSource
false
receive()
ready()
true
receive()
StreamClosedEvent
ApplicationListener<StreamClosedEvent>
为了便于 EOF 检测,poller 线程在方法中阻塞,直到数据到达或检测到 EOF。receive() |
检测到 EOF 后,轮询程序将继续在每个轮询上发布事件。
应用程序侦听器可以停止适配器以防止这种情况。
该事件在 poller 线程上发布。
停止适配器会导致线程中断。
如果您打算在停止适配器后执行某些可中断的任务,则必须在不同的线程上执行 或对这些下游活动使用不同的线程。
请注意,发送到 a 是可中断的,因此,如果您希望从侦听器发送消息,请在停止适配器之前执行此操作。stop() QueueChannel |
这有助于将数据“管道化”或重定向到 ,如以下两个示例所示:stdin
cat myfile.txt | java -jar my.jar
java -jar my.jar < foo.txt
此方法允许应用程序在管道关闭时停止。
有四种方便的工厂方法可用:
public static final CharacterStreamReadingMessageSource stdin() { ... }
public static final CharacterStreamReadingMessageSource stdin(String charsetName) { ... }
public static final CharacterStreamReadingMessageSource stdinPipe() { ... }
public static final CharacterStreamReadingMessageSource stdinPipe(String charsetName) { ... }
写入流
对于目标流,您可以使用以下两种实现之一:或 .
每个都需要一个构造函数参数(用于字节流或字符流),并且每个都提供第二个构造函数,该构造函数添加了可选的 'bufferSize'。
由于这两个最终都实现了接口,因此您可以从配置中引用它们,如 Channel Adapter 中所述。ByteStreamWritingMessageHandler
CharacterStreamWritingMessageHandler
OutputStream
Writer
MessageHandler
channel-adapter
<bean class="org.springframework.integration.stream.ByteStreamWritingMessageHandler">
<constructor-arg ref="someOutputStream"/>
<constructor-arg value="1024"/>
</bean>
<bean class="org.springframework.integration.stream.CharacterStreamWritingMessageHandler">
<constructor-arg ref="someWriter"/>
</bean>
Stream 命名空间支持
Spring 集成定义了一个名称空间,以减少与流相关的通道适配器所需的配置。 要使用它,需要以下架构位置:
<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns:int-stream="http://www.springframework.org/schema/integration/stream"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:beans="http://www.springframework.org/schema/beans"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/integration/stream
https://www.springframework.org/schema/integration/stream/spring-integration-stream.xsd">
以下代码片段显示了配置入站通道适配器时支持的不同配置选项:
<int-stream:stdin-channel-adapter id="adapterWithDefaultCharset"/>
<int-stream:stdin-channel-adapter id="adapterWithProvidedCharset" charset="UTF-8"/>
从版本 5.0 开始,您可以设置 属性,从而设置 property。
有关更多信息,请参阅从 Streams 中读取。detect-eof
blockToDetectEOF
要配置出站通道适配器,您也可以使用名称空间支持。 以下示例显示了出站通道适配器的不同配置:
<int-stream:stdout-channel-adapter id="stdoutAdapterWithDefaultCharset"
channel="testChannel"/>
<int-stream:stdout-channel-adapter id="stdoutAdapterWithProvidedCharset" charset="UTF-8"
channel="testChannel"/>
<int-stream:stderr-channel-adapter id="stderrAdapter" channel="testChannel"/>
<int-stream:stdout-channel-adapter id="newlineAdapter" append-newline="true"
channel="testChannel"/>