IBM Websphere JPA 配置 - 如何更新 persistence.xml

Question

我是 EJB 3 和 JPA 的新手。

我在 appserver 中创建了一个数据源 jdbc/AppDataSource。默认持久性提供程序保留为com.ibm.websphere.persistence.PersistenceProviderImpl。 我将默认的 jta 数据源 JNDI 名称保留为 AppDataSource 本身。 我实际上对 JTA 和非 JTA 感到困惑。它们有什么区别？

我生成了实体并在 bean 中创建了一个 EntityTransaction 对象。 在调用persist() 和commit() 方法时，我得到一个错误：

javax.ejb.EJBException: See nested exception; nested exception is: <openjpa-1.2.1-SNAPSHOT-r422266:686069 fatal user error> org.apache.openjpa.persistence.ArgumentException: A JDBC Driver or DataSource class name must be specified in the ConnectionDriverName property.
Caused by: <openjpa-1.2.1-SNAPSHOT-r422266:686069 fatal user error> org.apache.openjpa.persistence.ArgumentException: A JDBC Driver or DataSource class name must be specified in the ConnectionDriverName property.

openjpa 是如何出现在这里的？

到目前为止，我的persistence.xml 仅包含实体类名称。

如何使它使用默认的应用服务器值作为数据源。否则我如何在persistence.xml 中提供 jpa 提供程序和数据源的详细信息？

请提供您的意见。

Answer 1

这个问题其实涉及很多概念，我就不一一详述了。有关更详尽的详细信息，我建议阅读 JPA 1.0 规范的整个 Chapter 5 - Entity Managers and Persistence Contexts（以及本答案末尾提到的其他相关部分）。我宁愿尝试描述 Java EE 环境中最常见的场景。

在 EJB 环境中，通常会使用：

• 容器管理的实体管理器（必须是 JTA 实体管理器）
  • 无状态会话 Bean (SLSB) 中的事务范围
  • 在有状态会话 Bean (SFSB) 中扩展
• JTA 事务管理（而不是资源本地事务，除非这是真的您想要的）

下面是如何为 JTA 实体管理器设置 persistence.xml，该管理器使用具有 JNDI 名称 java:comp/env/jdbc/AppDataSource 的数据源，OpenJPA 是 WebSphere 使用的持久性提供程序：

<?xml version="1.0" encoding="UTF-8"?>
<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="MyPu" transaction-type="JTA">
    <provider>org.apache.openjpa.persistence.PersistenceProviderImpl</provider>
    <jta-data-source>java:comp/env/jdbc/AppDataSource</jta-data-source>
    <class>com.acme.domain.Foo</class>
    <class>com.acme.domain.Bar</class>
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
    <properties>
      <!-- OpenJPA specific 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 属性，请参阅 OpenJPA documentation。

以下是 SLSB（使用容器管理事务）如何注入容器管理的实体管理器：

@Stateless
public class EmployeeServiceBean implements EmployeeService {
    @PersistenceContext(unitName="MyPu")
    private EntityManager em;

    public Employee createEmployee(int id, String name, long salary) {
        Employee emp = new Employee(id);
        emp.setName(name);
        emp.setSalary(salary);
        em.persist(emp);
        return emp;
    }
    ...    
}

仅此而已。实体管理器的生命周期由容器透明地为应用程序管理（无 createEM/close），并且实体管理器参与由容器管理的 JTA 事务（无显式开始/提交）。

如前所述，我只是触及表面，我的目标是以某种方式让您走上正确的道路。更进一步，我建议拿一本书（例如 EJB3 in Action）。同时，下面的参考资料将是一个很好的阅读。

参考文献

• JPA 1.0 规范
  • 第 5.2.1 节“在 Java EE 环境中获取实体管理器”
  • 第 5.5 节“控制交易”
  • 第 5.6 节“容器管理的持久性上下文”
  • 第 6.2.1.2 节“事务类型”
  • 第 6.2.1.4 节“提供者”
  • 第 6.2.1.5 节“jta 数据源，非 jta 数据源”

资源

• Leveraging OpenJPA with WebSphere Application Server V6.1