java.util.logging -- Interface de programmation de la consignation Java

La classe java.util.logging.Logger fournit un grand nombre de méthodes permettant de journaliser les données.

Dans WebSphere Application Server, lors de l'utilisation du mode de trace et de consignation de base, l'API de consignation Java™ (java.util.logging) crée automatiquement des événements de base communs pour les événements enregistrés au niveau WsLevel.DETAIL ou à un niveau supérieur (tel que WsLevel.DETAIL, Level.CONFIG, Level.INFO, WsLevel.AUDIT, Level.WARNING, Level.SEVERE et WsLevel.FATAL). Ces événements de base communs sont créés à l'aide de la fabrique d'événements associée au journal d'événements dans lequel le message est consigné. Si aucune fabrique d'événements n'est spécifiée, WebSphere Application Server utilise une fabrique par défaut qui fournit automatiquement les informations spécifiques de WebSphere Application Server.

WebSphere utilise une implémentation spéciale de la classe java.util.logging.Logger qui crée automatiquement des événements de base communs pour les méthodes suivantes :
  • config
  • info
  • warning
  • severe
  • log : toutes les variantes à l'exception du fichier journal(LogRecord) en cas d'utilisation de WsLevel.DETAIL ou d'autres niveaux plus graves
  • logp : en cas d'utilisation de WsLevel.DETAIL ou de niveaux plus graves
  • logrb : en cas d'utilisation de WsLevel.DETAIL ou de niveaux plus graves
L'implémentation du programme de consignation WebSphere Application Server est uniquement utilisée pour les journaux nommés, par exemple ceux qui sont instanciés avec des appels, tels que Logger.getLogger("com.xyz.SomeLoggerName"). Les programmes de consignation instanciés avec des appels vers les méthodes Logger.getAnonymousLogger et Logger.getLogger ou Logger.global n'utilisent pas l'implémentation WebSphere Application Server, et ne créent pas automatiquement des événements de base communs pour les requêtes de consignation qu'ils reçoivent. Les enregistrements de journal qui sont directement consignés avec la méthode Logger.log(LogRecord) ne sont pas automatiquement convertis en événements de base communs par les journaux d'événements WebSphere Application Server.

Le diagramme suivant illustre le mode de consignation des événements de base communs par le code de l'application :

Mode de consignation des événements de base communs par le code de l'application

Le traitement de l'API de consignation Java des programmes de consignation nommés et des événements de niveau message s'effectue de la façon suivante :
  1. Le code de l'application appelle le programme de consignation nommé (WsLevel.DETAIL ou ultérieur) avec les données spécifiques à l'événement.
  2. Le programme de consignation crée un événement de base commun à l'aide de la méthode createCommonBaseEvent de la fabrique d'événements associée au programme de consignation.
  3. Le programme de consignation crée un événement de base commun à l'aide de la fabrique d'événements associée au consignateur.
  4. Le programme de consignation recherche en boucle l'événement de base commun dans un enregistrement CommonBaseEventLogRecord, et ajoute les données spécifiques à l'événement.
  5. Le programme de consignation appelle la méthode complète de l'événement de base commun.
  6. L'événement de base commun appelle la méthode completeEvent ContentHandler.
  7. Le gestionnaire de contenu ajoute les données du modèle XML à l'événement de base commun (y compris par exemple, le nom du composant). Certains gestionnaires de contenu ne prennent pas en charge les modèles.
  8. Le gestionnaire de contenu ajoute des données d'exécution à l'événement de base commun (y compris par exemple, le nom de l'unité d'exécution).
  9. Le programme de consignation transmet l'enregistrement CommonBaseEventLogRecord aux gestionnaires.
  10. Les gestionnaires formatent les données et les inscrivent dans l'unité de sortie.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbejavaapi
Nom du fichier : rtrb_cbejavaapi.html