入站通道适配器 (Inbound Channel Adapter) _ Spring Integration6.2.9中文文档(官方文档中文翻译)|Spring 教程 —

对于最新的稳定版本，请使用 Spring Integration 6.3.4！spring-doc.cn

入站通道适配器的主要功能是执行 SQL 查询并将结果集转换为消息。消息有效负载是整个结果集（表示为 a ），列表中项目的类型取决于行映射策略。默认策略是一个通用映射器，它在查询结果中的每一行都返回一个。或者，你可以通过添加对实例的引用来更改此设置（有关行映射的更多详细信息，请参阅 Spring JDBC 文档）。SELECTListMapRowMapperspring-doc.cn

如果要将查询结果中的行转换为单个消息，可以使用下游拆分器。SELECT

入站适配器还需要对 instance 或 .JdbcTemplateDataSourcespring-doc.cn

除了用于生成消息的语句外，适配器还具有一个语句，该语句将记录标记为已处理，以便它们不会显示在下一次轮询中。更新可以通过原始 select 中的 ID 列表进行参数化。默认情况下，这是通过命名约定完成的（输入结果集中的列 called 被转换为名为的更新的参数映射中的列表）。以下示例定义具有更新查询和引用的入站通道适配器。SELECTUPDATEididDataSourcespring-doc.cn

<int-jdbc:inbound-channel-adapter query="select * from item where status=2"
    channel="target" data-source="dataSource"
    update="update item set status=10 where id in (:id)" />

更新查询中的参数在参数名称后加上冒号（）前缀（在前面的示例中，该参数是要应用于轮询结果集中每一行的表达式）。这是 Spring JDBC 中命名参数 JDBC 支持的标准功能，与 Spring 集成中采用的约定（投影到轮询结果列表）相结合。 Spring 的基础 JDBC 功能限制了可用的表达式（例如，除句点以外的大多数特殊字符都是不允许的），但是由于目标通常是可通过 bean 路径寻址的对象列表（可能是一的列表），因此并没有过度限制。:

要更改参数生成策略，可以将 a 注入到适配器中以覆盖默认行为（适配器具有属性）。 Spring Integration 提供了，它创建了一个基于 SPEL 的参数源，并将查询结果作为对象。（如果为 true，则根对象为行）。如果相同的参数名称在 update 查询中多次出现，则仅计算一次，并缓存其结果。SqlParameterSourceFactorysql-parameter-source-factoryExpressionEvaluatingSqlParameterSourceFactory#rootupdate-per-rowspring-doc.cn

您还可以将参数源用于 select 查询。在这种情况下，由于没有要评估的 “result” 对象，因此每次都使用单个参数源（而不是使用参数源工厂）。从版本 4.0 开始，你可以使用 Spring 创建基于 SPEL 的参数源，如下例所示：spring-doc.cn

<int-jdbc:inbound-channel-adapter query="select * from item where status=:status"
	channel="target" data-source="dataSource"
	select-sql-parameter-source="parameterSource" />

<bean id="parameterSource" factory-bean="parameterSourceFactory"
			factory-method="createParameterSourceNoCache">
	<constructor-arg value="" />
</bean>

<bean id="parameterSourceFactory"
		class="o.s.integration.jdbc.ExpressionEvaluatingSqlParameterSourceFactory">
	<property name="parameterExpressions">
		<map>
			<entry key="status" value="@statusBean.which()" />
		</map>
	</property>
</bean>

<bean id="statusBean" class="foo.StatusDetermination" />

in each 参数表达式可以是任何有效的 SPEL 表达式。表达式求值的对象是在 Bean 上定义的 constructor 参数。它对于所有评估都是静态的（在前面的示例中，为空）。value#rootparameterSourceStringspring-doc.cn

从版本 5.0 开始，您可以提供来指定特定参数的目标 SQL 类型。ExpressionEvaluatingSqlParameterSourceFactorysqlParameterTypesspring-doc.cn

以下示例为查询中使用的参数提供了 SQL 类型：spring-doc.cn

<int-jdbc:inbound-channel-adapter query="select * from item where status=:status"
    channel="target" data-source="dataSource"
    select-sql-parameter-source="parameterSource" />

<bean id="parameterSource" factory-bean="parameterSourceFactory"
            factory-method="createParameterSourceNoCache">
    <constructor-arg value="" />
</bean>

<bean id="parameterSourceFactory"
        class="o.s.integration.jdbc.ExpressionEvaluatingSqlParameterSourceFactory">
    <property name="sqlParameterTypes">
        <map>
            <entry key="status" value="#{ T(java.sql.Types).BINARY}" />
        </map>
    </property>
</bean>

使用工厂方法。否则，参数源将缓存计算结果。另请注意，由于禁用了缓存，因此如果相同的参数名称多次出现在 select 查询中，则会针对每次出现的情况重新评估该名称。createParameterSourceNoCache

如果要将查询结果中的行转换为单个消息，可以使用下游拆分器。SELECT

轮询和事务

入站适配器接受常规的 Spring 集成 Poller 作为子元素。因此，可以控制轮询的频率（以及其他用途）。用于 JDBC 的 Poller 的一个重要功能是可以选择将 poll 操作包装在事务中，如下例所示：spring-doc.cn

<int-jdbc:inbound-channel-adapter query="..."
        channel="target" data-source="dataSource" update="...">
    <int:poller fixed-rate="1000">
        <int:transactional/>
    </int:poller>
</int-jdbc:inbound-channel-adapter>

如果未显式指定 Poller，则使用默认值。与 Spring Integration 一样，它可以被定义为顶级 bean）。

在前面的示例中，数据库每 1000 毫秒轮询一次（或每秒轮询一次），并且 update 和 select 查询都在同一事务中执行。未显示事务管理器配置。但是，只要它知道数据源，轮询就是事务性的。一个常见的用例是将 downstream channels 作为 direct channels（默认），以便在同一个线程中调用端点，从而在同一个 transaction 中调用。这样，如果其中任何一个失败，事务将回滚，并且 Importing 数据将恢复到其原始状态。spring-doc.cn

如果未显式指定 Poller，则使用默认值。与 Spring Integration 一样，它可以被定义为顶级 bean）。

`max-rows`对`max-messages-per-poll`

JDBC 入站通道适配器定义了一个名为的属性。指定适配器的 Poller 时，还可以定义一个名为 . 虽然这两个属性看起来相似，但它们的含义却大不相同。max-rowsmax-messages-per-pollspring-doc.cn

max-messages-per-poll指定每个轮询间隔执行查询的次数，而指定每次执行返回的行数。max-rowsspring-doc.cn

在正常情况下，当你使用 JDBC 入站通道适配器时，你可能不想设置 poller 的属性。它的默认值是，这意味着 JDBC 入站通道适配器的 receive（） 方法在每个轮询间隔中只执行一次。max-messages-per-poll1spring-doc.cn

将属性设置为更大的值意味着查询将连续执行多次。有关该属性的更多信息，请参见配置入站通道适配器。max-messages-per-pollmax-messages-per-pollspring-doc.cn

相反， property 如果大于，则指定要从方法创建的查询结果集中使用的最大行数。如果属性设置为，则所有行都包含在结果消息中。该属性默认为 .max-rows0receive()00spring-doc.cn

建议通过特定于供应商的查询选项（例如 MySQL 或 SQL Server 或 Oracle 的）使用结果集限制。有关更多信息，请参阅特定供应商文档。LIMITTOPROWNUM

轮询和事务

max-rows对max-messages-per-poll

`max-rows`对`max-messages-per-poll`