Spring Bean 配置相关的注意事项

数据访问注意事项

本部分介绍与访问事务中的数据的 Spring Bean 配置相关的注意事项。

Spring Framework 实际上使用一个容器管理层(在 J2EE 环境中委托给基础 J2EE 运行时)包装 Spring Bean。下面将介绍应如何配置 Spring Bean,以便 Spring Framework 可以正确地向 WebSphere Application Server 运行时做出委托并与之集成。

  • 访问 WebSphere Application Server 中配置的数据源

    WebSphere Application Server 管理在应用程序服务器执行环境中使用的资源。需要访问诸如 JDBC 数据源等资源的 Spring 应用程序应该利用 WebSphere 管理的资源。为此,请执行以下步骤:

    1. 在开发过程中,应该使用资源引用配置 WAR 模块。例如:

      <resource-ref>
      	<res-ref-name>jdbc/springdb</res-ref-name>
      	<res-type>javax.sql.DataSource</res-type>
      	<res-auth>Container</res-auth>
      	<res-sharing-scope>Shareable</res-sharing-scope>
      </resource-ref>
      

    2. 对于 EJB JAR 文件,应该在需要访问数据源的每个 EJB 中声明同一资源引用。

    3. 然后在 Spring 应用程序配置中声明数据源代理 Bean,代理 Bean 引用 WebSphere 管理的资源提供者:

      <bean id="wasDataSource" 
          class="org.springframework.jndi.JndiObjectFactoryBean">
      	<property name="jndiName" 
      		value="java:comp/env/jdbc/springdb"/>
      	<property name="lookupOnStartup" 
      		value="false"/>
      	<property name="cache" 
      		value="true"/>
      	<property name="proxyInterface" 
      		value="javax.sql.DataSource"/>
      </bean>

      通过此代理 Bean 访问数据源将会导致使用模块配置的引用查找数据源,从而能够由 WebSphere Application Server 正确管理。请注意,jndiName 属性值与使用资源引用中声明的资源引用名称连接的模式 java:comp/env/ 匹配。

      或者,在 Spring 2.5 以后的版本中,可以使用 <j2ee:jndi-lookup/> 方法完成此匹配。请注意 jndiName 属性如何匹配资源引用中声明的资源引用名称与 resource-ref="true" 属性相结合的实际值:

      <jee:jndi-lookup id=" wasDataSource "
      	jndi-name="jdbc/springdb"
      	cache="true"
      	resource-ref="true"
      	lookup-on-startup="false"
      	proxy-interface="javax.sql.DataSource"/>

    4. 然后,Spring 应用程序可以在适当情况下使用数据源代理 Bean。

    5. 将应用程序部署到 WebSphere Application Server 时,必须以常规方式配置资源提供者和资源数据源,以便由 Spring 应用程序资源引用使用。在部署过程中,在模块的部署描述符中声明的资源引用将绑定到应用程序服务器配置的数据源。

  • 使用 JDBC 本机连接

    当各种 JDBC 操作需要与本机 JDBC 资源交互时,Spring 可提供访问本机连接的机制。当在 JdbcTemplate 类上设置了 NativeJdbcExtractor 类时,Spring JdbcTemplate 类才可以利用此功能。设置 NativeJdbcExtractor 类后,当与 WebSphere Application Server 一起使用时,Spring 总是向下找到本机 JDBC 连接。这将忽略以下 WebSphere 服务质量功能和优点:

    • 连接处理跟踪和再关联
    • 连接共享
    • 参与事务
    • 连接池管理

    这带来的另一个问题是 WebSphereNativeJdbcExtractor 类将依赖于内部 WebSphere 适配器类。这些内部类可能因 WebSphere Application Server 的版本而异,并且以后可能更改,从而破坏依赖于此功能的应用程序。

    在 WebSphere Application Server 上不支持使用 NativeJdbcExtractor 类实现(例如 WebSphereNativeJdbcExtractor),您应避免需要使用该类的场景。替代方案是使用 WebSphere Application Server WSCallHelper 类来访问非标准供应商的数据源扩展。

  • 使用 Spring 处理事务

    WebSphere Application Server 为事务处理和管理与资源提供者的连接提供了一个稳健和可伸缩的环境。无论是否在使用全局事务,与 JDBC、JMS 和 Java Connector 资源适配器的连接均由 WebSphere Application Server 管理;甚至在缺少全局事务时,始终存在一个运行时上下文,在该上下文中可以访问所有资源提供者连接。WebSphere Application Server 将此运行时上下文称为本地事务容器 (LTC) 作用域;在缺少全局事务时始终存在一个 LTC,并且无论是存在全局事务还是 LTC,资源访问始终由运行时管理。为确保事务上下文管理的完整性,以便可以正确管理事务资源,WebSphere Application Server 不向 WebSphere Application Server 中部署的应用程序或应用程序框架公开 javax.transaction.TransactionManager 接口。

    在 Spring 中,有许多方法可以驱动事务控制下的资源更新,这包括编程形式和声明形式。声明形式包括 Java Annotation 和 XML 描述符形式。如果将 Spring 2.5 与 WebSphere Application Server V6.0.2.19 或 V6.1.0.9 或者更高版本一起使用,则可以利用对 Spring 的声明式事务模型的完全支持。Spring 2.5 有一个新的用于 WebSphere Application Server 的 PlatformTransactionManager 类,名为 WebSphereUowTransactionManager。该类利用 WebSphere Application Server 的受支持 UOWManager 接口进行事务上下文管理。通过 WebSphere Application Server 的 UOWManager 类管理事务划分可以确保在访问资源提供者时始终可以使用适当的全局事务或 LTC 上下文。不过,早期版本的 Spring 使用了内部 WebSphere 接口,以牺牲 Web 和 EJB 容器功能为代价来管理资源,并且不支持由应用程序使用。这会使容器处于未知状态,从而有可能导致数据损坏。

    Spring 2.5 或更高版本中的声明式事务划分在 WebSphere Application Server 中受支持,它使用下面的声明提供对 WebSphere 事务的支持:

    <bean id="transactionManager"
    	class="org.springframework.transaction.jta.WebSphereUowTransactionManager"/>

    引用此声明的 Spring Bean 然后将使用标准 Spring 依赖项注入来使用事务支持,例如:

    <bean id="someBean" class="some.class">
    	<property name="transactionManager" >
    		<ref bean="transactionManager"/>
    	</property>
    ...
    </bean>
    <property name="transactionAttributes">
    	<props>
    		<prop key="*">PROPAGATION_REQUIRED</prop>
    	</props>
    	</property>

    或者,在 Spring 2.5 以后的版本中,可以利用 Spring 的 AspectJ 支持。在下面的示例中,可以将 <tx:advice/> 应用于应用程序的各个部分。这指示所有以“get”开头的方法都是 PROPAGATION_REQUIRED,并且所有以“set”开头的方法都是 PROPAGATION_REQUIRES_NEW。所有其他方法使用缺省事务设置。

    <tx:advice id="txAdvice" transaction-manager="transactionManager">
       <tx:attributes>
          <tx:method name="get*" propagation="REQUIRED" read-only="true" />
          <tx:method name="set*" propagation="REQUIRES_NEW" />
          <tx:method name="*" />
       </tx:attributes>
    </tx:advice>

    <aop:config/> 标记将那些设置应用于类 MyService 中定义的任何已执行操作。

    <aop:config>
       <aop:pointcut id="myServiceOperation" 
          expression="execution(* sample.service.MyService.*(..))"/>
       <aop:advisor advice-ref="txAdvice" 
          pointcut-ref="myServiceOperation"/>
    </aop:config>

    用于声明事务设置的另一种替代机制是使用基于 Spring 注释的事务支持。这要求使用 Java 5+,因此无法与 WebSphere Application Server V6.0.2.x 一起使用。

    将以下内容添加到 Spring.xml 配置:

    <tx:annotation-driven/>

    然后应该使用 @Transactional 注释对需要事务属性的任何方法进行标记:

    @Transactional(readOnly = true)
    public String getUserName()
    { ...

    请注意,只能将 @Transactional 注释用于注释公共方法。

    WebSphereUowTransactionManager 支持每个 Spring 事务属性:

    • PROPAGATION_REQUIRED
    • PROPAGATION_SUPPORTS
    • PROPAGATION_MANDATORY
    • PROPAGATION_REQUIRES_NEW
    • PROPAGATION_NOT_SUPPORTED
    • PROPAGATION_NEVER

    对于没有提供 org.springframework.transaction.jta.WebSphereUowTransactionManager 的早期 Spring 版本以及没有提供 com.ibm.wsspi.uow.UOWManager 的 WebSphere Application Server V6.0.2.19 或 V6.1.0.9 之前的版本,WebSphere Application Server 中的事务支持通过以下 Spring 配置实现:

    <bean id="transactionManager" 
    	class="org.springframework.transaction.jta.JtaTransactionManager">
    		<property name="autodetectTransactionManager"value="false" />
    </bean>

    此配置支持一组受限制的事务属性,其中不包括 PROPAGATION_NOT_SUPPORTED 和 PROPAGATION_REQUIRES_NEW。Spring 类 org.springframework.transaction.jta.WebSphereTransactionManagerFactoryBean 也宣称提供 PROPAGATION_NOT_SUPPORTED 和 PROPAGATION_REQUIRES_NEW 功能,它使用不受支持的内部 WebSphere Application Server 接口,不应将其与 WebSphere Application Server 一起使用。

  • 使用 Spring JMS

    与访问 JDBC 数据源类似,打算访问 JMS 目的地的 Spring 应用程序必须确保它们使用了 WebSphere 管理的 JMS 资源提供者。使用 Spring JndiObjectFactoryBean 作为 ConnectionFactory 代理的相同模式将确保可以正确地管理 JMS 资源。

    对于 JMS 消息发送或同步 JMS 消息接收,可以使用 JMSTemplates。这包括通过 JNDI 和真正的动态解析使用 Spring 的动态目的地解析功能。

    下面的示例演示了 ConnectionFactory 的资源引用配置。此引用在应用程序部署过程中映射为指向应用程序服务器的 JNDI 命名空间中存储的已配置托管 ConnectionFactory。ConnectionFactory 是执行消息处理所必需的,并且应该将其注入 Spring JMSTemplate。

    <resource-ref>
          <res-ref-name>jms/myCF</res-ref-name>
          <res-type>javax.jms.ConnectionFactory</res-type>
          <res-auth>Container</res-auth>
          <res-sharing-scope>Shareable</res-sharing-scope>
    </resource-ref>

    现在应用程序中的 ConnectionFactory 有了已定义的 JNDI 名称,可以对其进行查找并将其注入 JMSTemplate:

    <jee:jndi-lookup id="jmsConnectionFactory" jndi-name=" jms/myCF "/>
    
    <bean id="jmsQueueTemplate" 
             class="org.springframework.jms.core.JmsTemplate">
      <property name="connectionFactory">
          <ref bean="jmsConnectionFactory"/>
       </property>
       <property name="destinationResolver">
          <ref bean="jmsDestResolver"/>
       </property>
        ...
    </bean>
    
    <!-- A dynamic resolver -->
    <bean id="jmsDestResolver" class=" 
          org.springframework.jms.support.destination.DynamicDestinationResolver"/>
    
    <!-- A JNDI resolver -->
    <bean id="jmsDestResolver" 
    	class=" org.springframework.jms.support.destination.JndiDestinationResolver"/>

    在运行时,JMSTemplate 可以基于目的地的 JNDI 名称(在应用程序资源引用中配置)或通过“动态解析”来基于 WebSphere Application Server 中配置的目的地的管理名称定位目的地;例如,对于绑定到 jms/myQueue 的 JNDI 引用的 JMS myQueue 队列:

    JNDI 解析:
    jmsTemplate.send("java:comp/env/jms/myQueue", messageCreator);

    动态解析:
    jmsTemplate.send("myQueue", messageCreator);

    作为对 J2EE 消息驱动 Bean (MDB) 的替代,Spring 提供了用于异步地处理入站 JMS 消息的消息驱动 POJO 模型。仅有一个 DefaultMessageListenerContainer 类将管理从 JMS 队列到已配置的 POJO 的消息,该 POJO 必须是 javax.jms.MessageListener 实现。

    在 WebSphere Application Server 环境中,您还必须指定一个 WorkManagerTaskExecutor 类,这意味着 DefaultMessageListenerContainer 类将向服务器管理的线程池作出委托。正如上面描述过的,还应该通过 WebSphereUowTransactionManager 使用服务器的事务管理来配置 DefaultMessageListenerContainer。

    <bean id="messageListener" class="sample.ExampleMessageListener" />
    
       <bean id="msgListenerContainer"
          class="org.springframework.jms.listener.DefaultMessageListenerContainer">
          <property name="connectionFactory" ref="jmsConnectionFactory" />
          <property name="destination" ref="jmsQueue" />
          <property name="messageListener" ref="messageListener" />
          <property name="transactionManager" ref="transactionManager" />
          <property name="taskExecutor" ref="myTaskExecutor" />
       </bean>
    
       <bean id="myTaskExecutor"
          class="org.springframework.scheduling.commonj.WorkManagerTaskExecutor">
          <property name="workManagerName" value="wm/default" />
       </bean>
    
       <bean id="transactionManager"
          class="org.springframework.transaction.jta.WebSphereUowTransactionManager" />
    
       <jee:jndi-lookup id="jmsConnectionFactory" jndi-name="jms/CF1" />
    
       <jee:jndi-lookup id="jmsQueue" jndi-name="jms/jmsQueue" />

    虽然可以使用此消息驱动 POJO 模型,但是在需要工作负载管理和/或高可用性的 WebSphere Application Server 配置中,建议直接使用 J2EE 消息驱动 Bean (MDB)。请注意,不支持任何其他 Spring JMS MessageListenerContainer 类型,因为它们可以启动非托管线程,而且还可能使用不应由 Java EE 环境中的应用程序调用的 JMS API。

  • 将 JPA 与 Spring 一起使用

    EJB 3.0 规范将 Java Persistence API (JPA) 定义为提供可移植持久 Java 实体的方法。WebSphere Application Server V7 和 WebSphere Application Server V6.1 EJB 3 功能包都提供了 EJB 3 和 JPA 的实现;还可以将 JPA 的 Apache OpenJPA 实现与 WebSphere Application Server V6.1 一起使用(请参见参考资料)。将 Spring 与 JPA 实现结合使用时,您应该直接使用 JPA,而不是使用 Spring 的 JPA Helper 类(在 org.springframework.orm.jpa 包中)。

    WebSphere Application Server V6.1 及更高版本支持 JPA 应用程序托管的实体管理器,该管理器可能是 JTA 或本地资源事务类型。JTA 实体管理器使用应用程序服务器的基础 JTA 事务支持,其事务划分可以使用上面描述的标准 J2EE 技术或 Spring 的声明式事务模型进行定义。

    使用 JPA 的数据访问对象 (DAO) 与 persistence.xml 打包在一起,后者为应用程序使用的 JPA EntityManager 定义持久性上下文。例如,可以按下面的方式设置用于 JTA 实体管理器(使用的数据源的 JNDI 名称为“java:comp/env/jdbc/springdb”)的 persistence.xml:

    <persistence 
       xmlns="http://java.sun.com/xml/ns/persistence"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
       http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd" version="1.0">
    	<persistence-unit name="default" transaction-type="JTA">
    	<provider> org.apache.openjpa.persistence.PersistenceProviderImpl </provider>
    	<jta-data-source> java:comp/env/jdbc/springdb </jta-data-source>
    	<properties>
    		<property name="openjpa.TransactionMode" value="managed" />
    		<property name="openjpa.ConnectionFactoryMode"value="managed" />
    		<property name="openjpa.jdbc.DBDictionary" value="db2" />
    	</properties>
    	</persistence-unit>
    </persistence>

    通过将 openjpa.TransactionMode 和 openjpa.ConnectionFactoryMode 属性设置为“managed”,JPA 实体管理器将事务和连接管理委托给 WebSphere Application Server。DAO 可以使用上面描述的 Spring 声明式事务划分。

    还可以使用注释风格的 JPA EntityManager 注入。这与标准 JPA 完全相同:

    @PersistenceContext
    private EntityManager em;

    您需要以下 XML 代码将在 Spring XML 配置中启用 EntityManager 注入:

    <!-- bean post-processor for JPA annotations --> 
    <bean class=
    "org.springframework.orm.jpa.support.PersistenceAnnotationBeanPostProcessor"/>

    Spring 将在此 XML 文件中定义的 EntityManagerFactory 的基础上创建 EntityManager 。如果存在多个 EntityManagerFactory,则 Spring 将失败。使用以下方法中的一种(且仅一种)方法创建 EntityManagerFactory:

    • 使用 Spring 的基本配置
      <bean id="entityManagerFactory"
          class="org.springframework.orm.jpa.LocalEntityManagerFactoryBean">
         <property name="persistenceUnitName" value="default"/>
      </bean>

    • 使用 Spring 的高级配置
      <bean id="myEmf" class=
      "org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
        <property name="dataSource" ref="ds"/>
      </bean>
      
      <jee:jndi-lookup 
          id="ds" 
          jndi-name="jdbc/ds" 
          cache="true" 
          expected-type="javax.sql.DataSource"
      />

    当然,通过使用 WebSphere Application Server V7 和 WebSphere Application Server V6.1 EJB 3 Feature Pack 中的纯粹 EJB 3 支持也可以获得注释和 JPA 的优点。在任一种情况下,您都可以使用 JPA API 创建 EntityManagerFactory,如下所示。建议不要将此方法用于非 EJB 3 环境,因为可能无法正确管理所创建的任何 EntityManager。但是,当您拥有 EJB 3 环境时,可以使用此方法分离 Spring 和 JPA 配置。

    <bean id="myEmf" 
       class="javax.persistence.Persistence" 
       factory-method="createEntityManagerFactory" >
      <constructor-arg type="java.lang.String" value="default"/>  
    </bean>
  • 0
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值