使用軟體組內的 JPA 來存取資料

關於這項作業

當使用軟體組內的 JPA 來存取資料時,會假設您使用的是被視為伺服器中之 Java™ EE 模組的軟體組。例如,OSGi Web 應用程式軟體組,它啟用了 JPA 資料類型,並且含有實體,以及使用 JPA 時如何存取、耗用和顯示資料等邏輯。另一個範例是 Web 專案,它含有 JPA 實體,以及當使用發佈在 OSGi 應用程式中的 JPA(而不是 EAR 部署的一部分)時如何耗用資料的邏輯。

您需要先配置 OSGi 軟體組,並新增資料來源至 WebSphere® Application Server,才能存取 JPA 持續性單元。

提示:

請確定您的 JPA 持續性檔案含有 Java 交易 API (JTA) 和非 JTA 資料來源的參照。

JPA 有兩個存取資料來源的交易式型樣:
jta-data-source
「Java 交易 API (JTA)」資源型樣會隨著廣域交易而不同。 JTA 資源型樣通常是在 Enterprise JavaBeans (EJB) Session Facade 範圍內使用。 這項配置容許 Session Bean 來控制交易和安全環境定義,而 JPA 則處理持續性對映。在這個情況下,應用程式並不使用 EntityTransaction 介面,而是在受到存取之時,依賴列入廣域交易的 EntityManager。
non-jta-data-source
當缺乏廣域交易時,會使用非 JTA 資源型樣來處理單一資源。非 JTA 資源型樣通常是在 Web 應用程式或應用程式用戶端的範圍內使用。 應用程式以 EntityTransaction 介面來控制與資料來源的交易。

在 OSGi 應用程式的 persistence.xml 檔中,jta-data-source 和 non-jta-data-source 元素會透過「Java 命名和目錄介面 (JNDI)」查閱、對服務登錄的 JNDI 查閱,或透過藍圖,來存取資料來源。

如果 persistence.xml 檔中沒有配置 JTA 和非 JTA 資料來源,會使用配置給伺服器的預設 JTA 和非 JTA 資料來源。依預設,值是空值。有些 JPA 實體特性會要求指定非 JTA 資料來源。例如,自動產生實體身分。

程序

  1. 新增非 JTA 資料來源至 persistence.xml:
    1. 在編輯器中開啟 persistence.xml。
    2. 在「概觀」區段中查看元件清單,並選取實體,以顯示該實體的詳細資料。
    3. 在非 JTA 資料來源欄位中,輸入非 JTA 資料來源的廣域 JNDI 名稱。 例如 osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/blogdbnojta)。
  2. 新增 JTA 資料來源至 persistence.xml:
    1. 在編輯器中開啟 persistence.xml。
    2. 在「概觀」區段中查看元件清單,並選取實體,以顯示該實體的詳細資料。
    3. 在 JTA 資料來源欄位中,輸入資料來源的廣域 JNDI 名稱。 例如,osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/blogdb)。
  3. 新增 JDBC 提供者至 WebSphere Application Server 管理主控台:
    1. 切換至「伺服器」視圖。
    2. 用滑鼠右鍵按一下您的伺服器實例,並選取啟動。
    3. 用滑鼠右鍵按一下您的伺服器實例,並選取管理 > 執行管理主控台,以開啟管理主控台。
    4. 按一下資源 > JDBC > JDBC 提供者。
    5. 按一下 JDBC 提供者頁面中的新建。即會開啟「建立資料來源」精靈。
    6. 遵循精靈中的指示,來建立 JDBC 提供者。
    7. 儲存您的變更。
  4. 新增資料來源定義至 WebSphere Application Server 管理主控台:
    1. 在管理主控台中,按一下資源 > JDBC > 資料來源,以便在主控台中開啟「資料來源」頁面。
    2. 在「資料來源」頁面中,按一下新建,建立資料來源定義,並將 JNDI 名稱設為 persistence.xml 中指定的 JTA 連線定義。 例如,jdbc/blogdb。
    3. 在「資料來源」頁面中,按一下新建,建立另一項資料來源定義,並將 JNDI 名稱設為 persistence.xml 中指定的非 JTA 連線定義。 例如,jdbc/blogdbnojta。
    4. 建立非 JTA 連線的資料來源時,請在管理主控台的「資料來源」頁面中,按一下非 JTA 連線的定義。即會開啟「配置」頁面。
    5. 在「其他內容」區段中,按一下 WebSphere Application Server 資料來源內容。
    6. 選取非交易式資料來源。 在應用程式伺服器內,使用 <non-jta-data-source> 元素需要非交易式資料來源的特殊配置。 配置給應用程式伺服器的「資料來源」無法以 <non-jta-data-source> 形式運作,因為應用程式伺服器所配置的所有資料來源,都會自動列入現行交易式環境定義中。如果要防止這種自動列入,請新增資料來源自訂內容 nonTransactionalDataSource=true。

結果

persistence.xml 和 WebSphere Application Server 會配置成存取 OSGi 軟體組中的 JPA。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: taccessjpainbundle.html