Zarządzanie plikiem persistence.xml

Podczas tworzenia projektu środowisko Eclipse tworzy plik META-INF\persistence.xml w katalogu projektu.

W przypadku tworzenia projektu JPA w katalogu META-INF można utworzyć plik szkieletu persistence.xml (patrz sekcja Tworzenie nowego projektu JPA). Plikiem można zarządzać albo za pomocą edytora XML, albo za pomocą edytora pliku persistence.xml.


Uwaga:

W zależności od używanej implementacji JPA (np. EclipseLink) w edytorze pliku persistence.xml dostępne mogą być następujące dodatkowe strony.
  • Dostosowanie

    Ta strona służy do definiowania właściwości dotyczących śledzenia zmian i elementu dostosowującego sesji.

  • Buforowanie

    Ta strona służy do definiowania właściwości buforowania.

  • Rejestrowanie

    Ta strona służy do definiowania właściwości rejestrowania.

  • Opcje

    Ta strona służy do definiowania właściwości sesji i docelowej bazy danych.

  • Generowanie schematu

    Ta strona służy do definiowania właściwości dotyczących języka DDL.

W przypadku projektów używających implementacji JPA EclipseLink na stronie Połączenia znajdują się także właściwości puli połączeń JDBC.

Jeśli projekt używa platformy ogólnej, dostępne są tylko strony Ogólne, Połączenie, Właściwości i Źródło .


Aby użyć edytora pliku persistence.xml:

  1. Otwórz plik peristence.xml. Zostanie wyświetlona strona Ogólne edytora.

  2. Na stronie Ogólne można zdefiniować atrybuty pliku persistence.xml dotyczące jednostek <persistent-unit>, a także elementy <provider> i <class> (opisane w poniższej tabeli).


    Wskazówka:

    Na stronie Źródło w edytorze pliku persistence.xml można wyświetlać i edytować surowy plik XML.

    Właściwość Opis Definiowany element
    Nazwa Umożliwia wprowadzenie nazwy jednostki trwałości. <persistence-unit name = "<Nazwa>">
    Dostawca trwałości Umożliwia wprowadzenie nazwy dostawcy trwałości. <provider>
    Opis Umożliwia wprowadzenie opisu jednostki trwałości. Jest to właściwość opcjonalna. <description>
    Zarządzane klasy Dodawanie lub usuwanie klas zarządzanych za pomocą jednostki trwałości <class>
      Wyklucz klasy spoza listy Zaznaczenie tej opcji powoduje uwzględnienie wszystkich klas encji z adnotacjami w elemencie głównym jednostki trwałości. <exclude-unlisted-classes>
    Pliki odwzorowania XML Dodawanie lub usuwanie plików obiektowo-relacyjnych odwzorowań XML definiuje klasy zarządzane za pomocą jednostki trwałości. <mapping-file>
    Pliki JAR Dodawanie lub usuwanie dodatkowych bibliotek i plików JAR.

  3. Na stronie Połączenie można definiować elementy <jta-data-source> i <non-jta-data-source> w następujący sposób:

    Aby skonfigurować źródło JTA (Java Transaction API) używane przez dostawcę trwałości:

    1. Wybierz pozycję JTA z listy Typ transakcji.

    2. Wprowadź globalną nazwę JNDI źródła danych.

    Aby skonfigurować źródło danych inne niż JTA:

    1. Wybierz pozycję Zasób lokalny z listy Typ transakcji.

    2. Wprowadź globalną nazwę JNDI źródła danych.


      Uwaga:

      Aby użyć źródła danych udostępnionego przez kontener, należy wybrać pozycję Default().

    W przypadku projektów z platformą Ogólne można też zdefiniować sterownik puli połączeń EclipseLink, sterownik puli połączeń, adres URL, nazwę użytkownika i hasło.

  4. Przy użyciu tabeli na stronie Właściwości można ustawić element <properties> specyficzny dla dostawcy.

    Aby dodać elementy <property>:

    1. Kliknij przycisk Dodaj.

    2. Wprowadź atrybuty <name> i <value> dla elementu <property>, używając pól Nazwa i Wartość tabeli.

    Aby usunąć element <property>, należy wybrać zdefiniowaną właściwość, a następnie kliknąć opcję Usuń.


    Uwaga:

    Jeśli projekt używa platformy EclipseLink, na stronie Połączenie znajdują się także parametry zestawiania połączeń JDBC.

Informacje pokrewne

Edytor pliku persistence.xml

 

Czynność pokrewna

Synchronizowanie klas

 

Pojęcie pokrewne

Plik persistence.xml