Работа с файлом persistence.xml

Когда вы создаете проект, Eclipse создает в каталоге проекта файл META-INF\persistence.xml.

При создании проекта JPA можно создать заготовку файла persistence.xmlв каталоге META-INF (см. раздел "Создание нового проекта JPA"). Для работы с этим файлом можно использовать редактор XML (см. ) или редактор persistence.xml.


Примечание:

В зависимости от реализации JPA (например, EclipseLink) в редакторе persistence.xml могут быть доступны следующие дополнительные страницы:
  • Настройка

    Эта страница позволяет определить свойства отслеживания изменений и свойства класса настройки сеанса.

  • Кэширование

    Эта страница позволяет определить свойства кэширования.

  • Ведение протоколов

    Эта страница позволяет определить свойства протоколов.

  • Опции

    Эта страница позволяет определить свойства сеансов и целевой базы данных.

  • Создание схемы

    Эта страница позволяет определить свойства, связанные с DDL.

Для проектов, использующих реализацию JPA EclipseLink, страница Соединения также содержит свойства пула соединений JDBC.

Если проект использует платформу Generic, то для него доступны только страницы Общие, Соединение, Свойства и Исходный код.


Для работы с Редактором файла 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 Transaction API), используемого поставщиком хранилища:

    1. Выберите JTA в списке Тип транзакции.

    2. Введите глобальное имя JNDI источника данных.

    Для настройки источника данных, отличного от JTA:

    1. Выберите Ресурс - Локальный в списке Тип транзакции.

    2. Введите глобальное имя JNDI источника данных.


      Примечание:

      Выберите Default() для использования источника данных, предоставляемого контейнером.

    Для проектов, использующих базовую платформу, можно указать драйвер пула соединений, URL, имя пользователя и пароль.

  4. В таблице на странице Свойства задается элемент <properties> для вендора.

    Для добавления элементов <property>:

    1. Нажмите Добавить.

    2. Введите атрибуты <name> и <value> для элемента <property> в полях таблицы Имя и Значение.

    Для удаления элемента <property> выберите свойство в таблице и нажмите Удалить.


    Примечание:

    Если проект использует платформу EclipseLink, то на странице Соединение также показаны параметры пула соединений JDBC.

Связанные справочники

Редактор persistence.xml

 

Связанные задачи

Синхронизация классов

 

Связанные концепции

Файл persistence.xml