出站网关
出站网关类似于出站和入站适配器的组合:它的作用是处理消息并用它来执行 SQL 查询,然后通过将其发送到回复通道来响应结果。默认情况下,消息负载和消息头作为查询的输入参数可用,如下例所示:
<int-jdbc:outbound-gateway
update="insert into mythings (id, status, name) values (:headers[id], 0, :payload[thing])"
request-channel="input" reply-channel="output" data-source="dataSource" />
前述示例的结果是向 `mythings` 表插入一条记录,并返回一条消息,其中包含受影响的行数(负载是一个映射:`{UPDATED=1}`),发送到输出通道。
如果更新查询是带有自动生成键的插入,您可以通过在前面的示例中添加 `keys-generated="true"` 来用生成的键填充回复消息(这不是默认设置,因为某些数据库平台不支持)。以下示例显示了更改后的配置:
<int-jdbc:outbound-gateway
update="insert into mythings (status, name) values (0, :payload[thing])"
request-channel="input" reply-channel="output" data-source="dataSource"
keys-generated="true"/>
除了更新计数或生成的键之外,您还可以提供一个选择查询来执行并从结果生成回复消息(例如入站适配器),如下例所示:
<int-jdbc:outbound-gateway
update="insert into foos (id, status, name) values (:headers[id], 0, :payload[foo])"
query="select * from foos where id=:headers[$id]"
request-channel="input" reply-channel="output" data-source="dataSource"/>
自 Spring Integration 2.2 起,更新 SQL 查询不再是强制性的。您现在可以只提供一个选择查询,通过使用 `query` 属性或 `query` 元素。如果您需要主动检索数据,例如使用通用网关或负载增强器,这会非常有用。然后,回复消息将从结果生成(类似于入站适配器的工作方式)并传递到回复通道。以下示例展示了如何使用 `query` 属性:
<int-jdbc:outbound-gateway
query="select * from foos where id=:headers[id]"
request-channel="input"
reply-channel="output"
data-source="dataSource"/>
|
默认情况下,`SELECT` 查询组件只返回游标中的一行(第一行)。您可以使用 `max-rows` 选项调整此行为。如果您需要返回 SELECT 中的所有行,请考虑指定 `max-rows="0"`。 |
与通道适配器一样,您还可以为请求和回复提供 `SqlParameterSourceFactory` 实例。默认值与出站适配器相同,因此请求消息作为表达式的根可用。如果 `keys-generated="true"`,表达式的根是生成的键(如果只有一个,则为映射;如果多值,则为映射列表)。
出站网关需要引用 `DataSource` 或 `JdbcTemplate`。它还可以注入 `SqlParameterSourceFactory` 来控制传入消息与查询的绑定。
从版本 4.2 开始,`
从版本 6.0 开始,`JdbcOutboundGateway` 返回的空列表结果将按原样返回,而不是像以前那样将其转换为 `null`,这意味着“无回复”。这导致在处理空列表是下游逻辑一部分的应用程序中需要额外的配置。有关可能的空列表处理选项,请参阅拆分器丢弃通道。
有关 `MessagePreparedStatementSetter` 的更多信息,请参阅出站通道适配器。