流支持 (Stream Support) _ Spring Integration6.4.0-SNAPSHOT中文文档(官方文档中文翻译)|Spring 教程 —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Integration 6.3.4！spring-doc.cn

在许多情况下，应用程序数据是从流中获取的。建议不要将对流的引用作为消息负载发送给使用者。相反，消息是从输入流中读取的数据创建的，并且消息负载将逐个写入输出流。spring-doc.cn

您需要将此依赖项包含在您的项目中：spring-doc.cn

Mavenspring-doc.cn
Gradlespring-doc.cn

<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-stream</artifactId>
    <version>6.4.0-SNAPSHOT</version>
</dependency>

compile "org.springframework.integration:spring-integration-stream:6.4.0-SNAPSHOT"

从 Streams 中读取

Spring 集成为流提供了两个适配器。两者和实现 . 通过在 channel-adapter 元素中配置其中一个，可以配置轮询周期，并且消息总线可以自动检测和调度它们。字节流版本需要，而字符流版本需要 a 作为单个构造函数参数。它还接受 'bytesPerMessage' 属性，以确定它尝试读取到每个 . 默认值为 . 以下示例创建一个输入流，该流创建每个消息包含 2048 字节的消息：ByteStreamReadingMessageSourceCharacterStreamReadingMessageSourceMessageSourceInputStreamReaderByteStreamReadingMessageSourceMessage1024spring-doc.cn

<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 时，将发布（应用程序事件）。您可以将此事件与实现 .CharacterStreamReadingMessageSourceBufferedReaderblockToDetectEOFCharacterStreamReadingMessageSourcefalsereceive()ready()truereceive()StreamClosedEventApplicationListener<StreamClosedEvent>spring-doc.cn

为了便于 EOF 检测，poller 线程在方法中阻塞，直到数据到达或检测到 EOF。receive()

检测到 EOF 后，轮询程序将继续在每个轮询上发布事件。应用程序侦听器可以停止适配器以防止这种情况。该事件在 poller 线程上发布。停止适配器会导致线程中断。如果您打算在停止适配器后执行某些可中断的任务，则必须在不同的线程上执行或对这些下游活动使用不同的线程。请注意，发送到 a 是可中断的，因此，如果您希望从侦听器发送消息，请在停止适配器之前执行此操作。stop()QueueChannel

这有助于将数据“管道化”或重定向到，如以下两个示例所示：stdinspring-doc.cn

cat myfile.txt | java -jar my.jar

java -jar my.jar < foo.txt

此方法允许应用程序在管道关闭时停止。spring-doc.cn

有四种方便的工厂方法可用：spring-doc.cn

public static final CharacterStreamReadingMessageSource stdin() { ... }

public static final CharacterStreamReadingMessageSource stdin(String charsetName) { ... }

public static final CharacterStreamReadingMessageSource stdinPipe() { ... }

public static final CharacterStreamReadingMessageSource stdinPipe(String charsetName) { ... }

为了便于 EOF 检测，poller 线程在方法中阻塞，直到数据到达或检测到 EOF。receive()

写入流

对于目标流，您可以使用以下两种实现之一：或 . 每个都需要一个构造函数参数（用于字节流或字符流），并且每个都提供第二个构造函数，该构造函数添加了可选的 'bufferSize'。由于这两个最终都实现了接口，因此您可以从配置中引用它们，如 Channel Adapter 中所述。ByteStreamWritingMessageHandlerCharacterStreamWritingMessageHandlerOutputStreamWriterMessageHandlerchannel-adapterspring-doc.cn

<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 Namespace 支持

Spring 集成定义了一个名称空间，以减少与流相关的通道适配器所需的配置。要使用它，需要以下架构位置：spring-doc.cn

<?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">

以下代码片段显示了配置入站通道适配器时支持的不同配置选项：spring-doc.cn

<int-stream:stdin-channel-adapter id="adapterWithDefaultCharset"/>

<int-stream:stdin-channel-adapter id="adapterWithProvidedCharset" charset="UTF-8"/>

从版本 5.0 开始，您可以设置属性，从而设置 property。有关更多信息，请参阅从 Streams 中读取。detect-eofblockToDetectEOFspring-doc.cn

要配置出站通道适配器，您也可以使用名称空间支持。以下示例显示了出站通道适配器的不同配置：spring-doc.cn

<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"/>