Consignation

La table suivante répertorie les propriétés disponibles dans la page Consignation de l'éditeur persistence.xml.


Remarque :

Cette page n'est pas disponible pour les projets utilisant la plateforme générique.

Propriétés de la page Consignation

Propriété Description Par défaut

Niveau de consignation

Spécifiez la quantité et le niveau de détail de la sortie de journal en sélectionnant le niveau de consignation (par ordre croissant des informations) :

Les valeurs admises pour java.util.logging.Level sont les suivantes :

  • HORS FONCTION – Désactive la consignation.

  • GRAVE – Consigne les exceptions indiquant que TopLink ne peut pas poursuivre, ainsi que toutes les exceptions générées au cours de la connexion. Ces exceptions comprennent une trace de pile.

  • AVERTISSEMENT – Consigne les exceptions qui ne forcent pas TopLink à s'arrêter, incluant toutes celles qui ne sont pas associées au niveau Grave. Ces exceptions ne comprennent aucune trace de pile.

  • INFO – Consigne les informations de connexion/déconnexion par session serveur, notamment le nom de l'utilisateur. Une fois la session acquise, les informations détaillées sont consignées.

  • CONFIG – Consigne uniquement les informations relatives à la connexion, à la connexion JDBC et à la base de données.

  • PRECIS – Consigne SQL.

  • PLUS PRECIS – Similaire à l'avertissement. Comprend une trace de pile.

  • LE PLUS PRECIS – Inclut des informations supplémentaires de niveau inférieur.

Exemple : fichier persistence.xml

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

Infos

  Horodatage

Indiquez si les données d'horodatage doivent être consignées dans chaque entrée de journal.

Les valeurs admises sont les suivantes :

  • true – L'horodatage est consigné.

  • false – L'horodatage n'est pas consigné.

Exemple : fichier persistence.xml

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

vrai

  Unité d'exécution

Indiquez si un identificateur d'unité d'exécution doit être consigné dans chaque entrée de journal.

Les valeurs admises sont les suivantes :

  • true – Un identificateur d'unité d'exécution est consigné.

  • false – Aucun identificateur d'unité d'exécution n'est consigné.

vrai

  Session

Indiquez si un identificateur de session EclipseLink doit être consigné dans chaque entrée de journal.

Les valeurs admises sont les suivantes :

  • true – Un identificateur de session EclipseLink est consigné.

  • false – Aucun identificateur de session n'est consigné.

Exemple : fichier persistence.xml

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

vrai

  Exceptions

Indiquez si les exceptions émises à partir du code EclipseLink sont consignées avant leur renvoi à l'application appelante. Cette option garantit que toutes les exceptions sont consignées et ne sont pas masquées par le code d'application.

Les valeurs admises sont les suivantes :

  • true – Toutes les exceptions sont consignées.

  • false – Aucune exception n'est consignée.

Exemple : fichier persistence.xml

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

false

Fichier de consignation

Indiquez un emplacement de fichier pour la sortie de journal (au lieu de la sortie standard).

Exemple : fichier persistence.xml

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

Consignateur

Sélectionnez le type de consignateur à utiliser.

Les valeurs admises sont les suivantes :

  • Consignateur par défaut – Consignateur natif d'EclipseLink eclipselink.logging.DefaultSessionLog.

  • Consignateur Java – Consignateur java.util.logging eclipselink.logging.JavaLog.

  • Consignateur de serveur – Consignateur java.util.logging eclipselink.platform.server.ServerLog. Il s'intègre à la consignation du serveur d'applications, comme défini dans eclipselink.platform.server.ServerPlatform.

  • Nom de classe qualifié complet d'un consignateur personnalisé. Ce dernier doit implémenter l'interface eclipselink.logging.SessionLog.

Exemple : fichier persistence.xml

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

Consignateur par défaut