管理 persistence.xml 檔

在您建立專案時,Eclipse 會在專案的目錄中建立 META-INF\persistence.xml 檔。

當您建立 JPA 專案時(請參閱建立新的 JPA 專案),您可以在 META-INF 目錄中建立一個 Stub persistence.xml 檔。您可以透過 XML 編輯器(請參閱)或 persistence.xml 編輯器,來管理這個檔案。


附註:

根據您的 JPA 實作(例如,EclipseLink),persistence.xml 編輯器中可能提供下列其他頁面:
  • 自訂

    請利用這個頁面來定義變更追蹤與階段作業自訂程式的相關內容。

  • 快取

    請利用這個頁面來定義快取內容。

  • 記載

    請利用這個頁面來定義記載內容。

  • 選項

    請利用這個頁面來定義階段作業與目標資料庫內容。

  • 產生綱目

    請利用這個頁面來定義 DDL 的相關內容。

如果專案使用 EclipseLink JPA 實作,「連線」頁面還包含 JDBC 連線儲存區內容。

如果專案使用「通用」平台,則只能使用一般連線內容原始檔等頁面。


如果要使用「persistence.xml 編輯器」,請執行下列動作:

  1. 開啟 peristence.xml 檔。這時會出現編輯器的一般頁面。

  2. 使用一般頁面可定義 persistence.xml 檔的 <persistent-unit> 相關屬性,以及 <provider><class> 元素(請見下表說明)。


    提示:

    「persistence.xml 編輯器」的「原始檔」頁面可讓您檢視與編輯原始 XML 檔。

    內容 說明 定義的元素
    名稱 輸入持續性單元的名稱。 <persistence-unit name = "<Name>">
    持續性提供者 輸入持續性提供者的名稱。 <provider>
    說明 輸入這個持續性單元的說明。這是選用內容。 <description>
    受管理類別 新增或移除透過持續性單元來管理的類別。 <class>
    排除未列出的類別 選取此項時,會將所有註解的實體類別併入至持續性單元的根位置中。 <exclude-unlisted-classes>
    XML 對映檔 新增或移除定義了要透過持續性單元來管理之類別的物件/關聯式對映 XML 檔。 <mapping-file>
    JAR 檔 新增或移除其他 JAR 檔和程式庫

  3. 按如下所示,使用連線頁面來定義 <jta-data-source><non-jta-data-source> 元素:

    如果要配置持續性提供者所用的 JTA(Java 交易 API)原始檔,請執行下列動作:

    1. 從「交易類型」清單中選取 JTA

    2. 輸入資料來源的廣域 JNDI 名稱。

    如果要配置非 JTA 資料來源,請執行下列動作:

    1. 從「交易類型」清單中,選取資源本端

    2. 輸入資料來源的廣域 JNDI 名稱。


      附註:

      選取 Default(),以使用儲存器所提供的資料來源。

    如果專案使用「通用」平台,您也可以定義 EclipseLink 連線儲存區驅動程式、連線儲存區驅動程式、URL、使用者名稱和密碼。

  4. 使用「內容」頁中的表格,來設定供應商專用的 <properties> 元素。

    如果要新增 <property> 元素,請執行下列動作:

    1. 請按一下新增

    2. 在表格的「名稱」與「值」欄位中,輸入 <property> 元素的 <name><value> 屬性。

    如果要移除 <property> 元素,請在表格中選取一個已定義的內容,然後按一下移除


    附註:

    如果專案使用 EclipseLink 平台,「連線」頁面還包含 JDBC 連線儲存區參數。

相關參照

persistence.xml 編輯器

 

相關作業

同步化類別

 

相關概念

persistence.xml 檔