使用不同軟體組中的 JPA 來存取資料

關於這項作業

您需要先配置 JPA 軟體組,並新增資料來源至 WebSphere® Application Server,才能存取另一個軟體組中的 JPA 持續性單元。例如,會耗用 JPA 實體,並顯示和操作資料的 Web 應用程式軟體組。
提示:

請確定您的 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. 請確定已將實體和實體控制器套件新增到 manifest.mf 作為匯出套件:
    1. 按兩下資訊清單:<project_name>,其中 <project_name> 是 JPA 軟體組專案的名稱。軟體組資訊清單會在編輯器中開啟。
    2. 切換至「執行時期」標籤。請驗證已新增實體和實體控制器套件作為匯出套件。
  2. 新增非 JTA 資料來源至 persistence.xml:
    1. 在編輯器中開啟 persistence.xml。
    2. 在元件清單中,選取您的實體,以顯示該實體的詳細資料。
    3. 在「非 JTA 資料來源」欄位中,輸入非資料來源的廣域 JNDI 名稱。例如 osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/blogdbnojta)。
  3. 修改 getEntityManager() 方法。

    修改 getEntityManager() 方法時,您會配置 EntityManagerFactory 服務的 JNDI 查閱,這是因為 JPA 軟體組中持續性單元不在 Java EE 環境中。

    您也可以使實體管理程式 Bean 成為一個藍圖管理 Bean,來配置 JNDI 查閱。如需相關資訊,請參閱 JPA 和 OSGi 應用程式。

    1. 在編輯器中開啟實體管理程式 Bean。
    2. 找出 getEntityManager(),並依如下所示來修改它:
      private EntityManager getEntityManager() {
      		try {
      			emf = (EntityManagerFactory) new InitialContext().lookup("osgi:service/javax.persistence.EntityManagerFactory/(osgi.unit.name=jpaBundle)");
      		} catch (NamingException e) {
      			// TODO Auto-generated catch block
      			e.printStackTrace();
      		}
      		
      		return emf.createEntityManager();
      	}
      重要: 在下列程式碼行中,確定持續性單元符合 persistence.xml 中的持續性單元:
      emf = (EntityManagerFactory) new InitialContext().lookup("osgi:service/javax.persistence.EntityManagerFactory/(osgi.unit.name=jpaBundle)");
  4. 修正 InitialContext 和 NamingException 中產生的錯誤:
    1. 切換至「標記」視圖。
    2. 針對每一個錯誤,用滑鼠右鍵按一下該錯誤,並選取快速修正程式。遵循精靈中的指示,來匯入必要的套件。
  5. 新增 JDBC 提供者至 WebSphere Application Server 管理主控台:
    1. 切換至「伺服器」視圖。
    2. 用滑鼠右鍵按一下您的伺服器實例,並選取啟動。
    3. 用滑鼠右鍵按一下您的伺服器實例,並選取管理 > 執行管理主控台,以開啟管理主控台。
    4. 按一下資源 > JDBC > JDBC 提供者。
    5. 按一下 JDBC 提供者頁面中的新建。即會開啟「建立資料來源」精靈。
    6. 遵循精靈中的指示,來建立 JDBC 提供者。
    7. 儲存您的變更。
  6. 新增資料來源定義至 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。

結果

現在您可以耗用 JPA 實體、顯示和操作 JPA 資料,其中,JPA 軟體組是存取自 Web 應用程式軟體組。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: taccessjpaoutbundle.html