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

В следующей таблице перечислены свойства, доступные на странице Протоколы Редактора файла persistence.xml.


Примечание:

Для проектов, использующих платформу Generic, эта страница недоступна.

Свойства на странице Протоколы

Свойство Описание По умолчанию

Уровень протокола

Уровень протокола, определяющий объем и степень подробности вывода (в порядке увеличения детализации информации):

Ниже перечислены допустимые значения для java.util.logging.Level:

  • OFF - выключает ведение протокола

  • SEVERE - в протокол заносятся исключительные ситуации, указывающие, что TopLink не может продолжать выполнение, а также любые исключительные ситуации, возникающие во время открытия сеанса. Включает трассировку стека.

  • WARNING - в протокол заносятся исключительные ситуации, не приводящие к остановке TopLink, в том числе исключительные ситуации, не регистрируемые на уровне severe. Трассировка стека не включается.

  • INFO - регистрирует вход в сеанс и выход из сеанса для прерванного сеанса, в том числе имя пользователя. После получения данных сеанса в протокол заносится подробная информация.

  • CONFIG - регистрирует только информацию о входе в сеанс, о соединении JDBC и о базе данных.

  • FINE - в протокол заносятся запросы SQL.

  • FINER - аналогичен уровню warning. Включает трассировку стека.

  • FINEST - включает дополнительную низкоуровневую информацию.

Пример: файл persistence.xml

<property name="eclipselink.logging.level" value="INFO"/>

Info

  Системное время

Указывает, следует ли в каждую запись протокола добавлять системное время.

Допустимы следующие значения:

  • true - указывать системное время.

  • false - не указывать системное время.

Пример: файл persistence.xml

<property name="eclipselink.logging.timestamp" value="false"/>

true

  Нить

Указывает, следует ли в каждую запись протокола добавлять идентификатор нити.

Допустимы следующие значения:

  • true - указывать идентификатор нити.

  • false - не указывать идентификатор нити.

true

  Сеанс

Указывает, следует ли в каждую запись протокола добавлять идентификатор сеанса EclipseLink.

Допустимы следующие значения:

  • true - указывать идентификатор сеанса EclipseLink.

  • false - не указывать идентификатор сеанса EclipseLink.

Пример: файл persistence.xml

<property name="eclipselink.logging.session" value="false"/>

true

  Исключительные ситуации

Указывает, должны ли исключительные ситуации, генерируемые кодом EclipseLink, заноситься в протокол перед их возвратом в вызывающее приложение. Обеспечивает регистрацию всех исключительных ситуаций в протоколе без маскирования кодом приложения.

Допустимы следующие значения:

  • true - заносить в протокол все исключительные ситуации.

  • false - не заносить исключительные ситуации в протокол.

Пример: файл persistence.xml

<property name="eclipselink.logging.exceptions" value="true"/>

false

Файл протокола

Укажите расположение файла протокола (вместо стандартного потока вывода).

Пример: файл persistence.xml

<property name="eclipselink.logging.file" value="C:\myout\" />

Регистратор

Выберите тип регистратора, который должен использоваться:

Допустимы следующие значения:

  • DefaultLogger - встроенный регистратор EclipseLink eclipselink.logging.DefaultSessionLog.

  • JavaLogger - регистратор java.util.logging eclipselink.logging.JavaLog.

  • ServerLogger - регистратор java.util.logging eclipselink.platform.server.ServerLog. Объединяется с протоколами сервера приложений, как определено в eclipselink.platform.server.ServerPlatform.

  • Полное имя класса пользовательского регистратора. Пользовательский регистратор должен реализовать интерфейс eclipselink.logging.SessionLog.

Пример: файл persistence.xml

<property name="eclipselink.logging.logger" value="acme.loggers.MyCustomLogger" />

DefaultLogger