|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Integration 6.3.1！ |
|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Integration 6.3.1！ |
使用 XML 命名空间支持时，基础解析器类会为您实例化相关的 Java 类。 因此，您通常不需要处理 JPA 适配器的内部工作。 本节记录了 Spring Integration 提供的 XML 命名空间支持，并展示了如何使用 XML 命名空间支持来配置 JPA 组件。
通用 XML 命名空间配置属性
某些配置参数由所有 JPA 组件共享：
auto-startup-
生命周期属性，指示是否应在应用程序上下文启动期间启动此组件。 默认值为 。 自选。
true id-
标识基础 Spring Bean 定义，该定义是 或 的实例。 自选。
EventDrivenConsumerPollingConsumer entity-manager-factory-
对适配器用于创建 . 您必须提供此属性、属性或属性。
EntityManagerentity-managerjpa-operations entity-manager-
对组件使用的 JPA Entity Manager 的引用。 您必须提供此属性、属性或属性。
entity-manager-factoryjpa-operations通常，您的 Spring 应用程序上下文只定义一个 JPA 实体管理器工厂，并且使用注解注入。 此方法不适用于 Spring Integration JPA 组件。 通常，最好注入 JPA 实体管理器工厂，但是，当您要显式注入 时，必须定义一个 . 有关更多信息，请参阅相关的 Javadoc。 EntityManager@PersistenceContextEntityManagerSharedEntityManagerBean下面的示例演示如何显式包含实体管理器工厂：
<bean id="entityManager" class="org.springframework.orm.jpa.support.SharedEntityManagerBean"> <property name="entityManagerFactory" ref="entityManagerFactoryBean" /> </bean> jpa-operations-
对实现接口的 Bean 的引用。 在极少数情况下，建议提供自己的接口实现，而不是依赖默认实现 （）。 如果使用该属性，则不得提供 JPA 实体管理器或 JPA 实体管理器工厂，因为会包装必要的数据源。
JpaOperationsJpaOperationsorg.springframework.integration.jpa.core.DefaultJpaOperationsjpa-operationsJpaOperations entity-class-
实体类的完全限定名称。 此属性的确切语义各不相同，具体取决于我们是在执行 or 操作还是从数据库中检索对象。
persistupdate检索数据时，可以指定属性以指示要从数据库中检索此类型的对象。 在这种情况下，不得定义任何查询属性（、 或 ）。
entity-classjpa-querynative-querynamed-query保存数据时，该属性指示要保存的对象类型。 如果未指定（对于持久化操作），则会自动从消息的有效负载中检索实体类。
entity-class jpa-query-
定义要使用的 JPA 查询（Java 持久性查询语言）。
native-query-
定义要使用的本机 SQL 查询。
named-query-
引用命名查询。 命名查询可以在 Native SQL 或 JPAQL 中定义，但底层 JPA 持久性提供程序在内部处理这种区别。
通常，您的 Spring 应用程序上下文只定义一个 JPA 实体管理器工厂，并且使用注解注入。
此方法不适用于 Spring Integration JPA 组件。
通常，最好注入 JPA 实体管理器工厂，但是，当您要显式注入 时，必须定义一个 .
有关更多信息，请参阅相关的 Javadoc。EntityManager@PersistenceContextEntityManagerSharedEntityManagerBean |
提供 JPA 查询参数
若要提供参数，可以使用 XML 元素。
它具有一种机制，允许您为基于 Java 持久性查询语言 （JPQL） 或本机 SQL 查询的查询提供参数。
您还可以为命名查询提供参数。parameter
- 基于表达式的参数
-
下面的示例演示如何设置基于表达式的参数：
<int-jpa:parameter expression="payload.name" name="firstName"/> - 基于值的参数
-
以下示例演示如何设置基于值的参数：
<int-jpa:parameter name="name" type="java.lang.String" value="myName"/> - 位置参数
-
下面的示例演示如何设置基于表达式的参数：
<int-jpa:parameter expression="payload.name"/> <int-jpa:parameter type="java.lang.Integer" value="21"/>
事务处理
所有 JPA 操作（如 、 和 ）都要求事务在执行时处于活动状态。
对于入站通道适配器，无需执行任何特殊操作。
它的工作方式类似于我们使用与其他入站通道适配器一起使用的轮询器来配置事务管理器的方式。
下面的 XML 示例配置一个事务管理器，该管理器使用带有入站通道适配器的轮询器：INSERTUPDATEDELETE
<int-jpa:inbound-channel-adapter
channel="inboundChannelAdapterOne"
entity-manager="em"
auto-startup="true"
jpa-query="select s from Student s"
expect-single-result="true"
delete-after-poll="true">
<int:poller fixed-rate="2000" >
<int:transactional propagation="REQUIRED"
transaction-manager="transactionManager"/>
</int:poller>
</int-jpa:inbound-channel-adapter>但是，在使用出站通道适配器或网关时，可能需要专门启动事务。
如果 a 是出站适配器或网关的输入通道，并且事务在当前执行线程中处于活动状态，则 JPA 操作将在同一事务上下文中执行。
您还可以将此 JPA 操作配置为作为新事务运行，如以下示例所示：DirectChannel
<int-jpa:outbound-gateway
request-channel="namedQueryRequestChannel"
reply-channel="namedQueryResponseChannel"
named-query="updateStudentByRollNumber"
entity-manager="em"
gateway-type="UPDATING">
<int-jpa:parameter name="lastName" expression="payload"/>
<int-jpa:parameter name="rollNumber" expression="headers['rollNumber']"/>
<int-jpa:transactional propagation="REQUIRES_NEW"
transaction-manager="transactionManager"/>
</int-jpa:outbound-gateway>在前面的示例中，出站网关或适配器的事务元素指定事务属性。
如果将此子元素定义为适配器的输入通道，并且希望适配器在与调用方相同的事务上下文中执行操作，则可以选择定义此子元素。
但是，如果使用 ，则必须具有该元素，因为调用客户端的事务上下文不会传播。DirectChannelExecutorChanneltransactional
与在 Spring Integration 的命名空间中定义的轮询器元素不同，出站网关或适配器的元素是在 JPA 命名空间中定义的。transactionaltransactional |
与在 Spring Integration 的命名空间中定义的轮询器元素不同，出站网关或适配器的元素是在 JPA 命名空间中定义的。transactionaltransactional |