java.util.logging -- Interface de programmation de la journalisation 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 consignation et de trace de base, l'API de consignation Java™ (java.util.logging) crée automatiquement des événements de base communs pour les événements qui sont consignés à WsLevel.Niveau DETAIL ou ultérieur (y compris WsLevel).DETAIL, Level.CONFIG, Level.INFO, WsLevel.AUDIT, Level.WARNING, Level.SEVEREet 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 à WebSphere Application Server.

WebSphere Application Server 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 consignateur WebSphere Application Server est utilisée uniquement pour les consignateurs nommés, par exemple, les consignateurs 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 demandes de journalisation 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 la façon dont le code d'application peut consigner des événements de base communs:
Comment le code d'application peut consigner CBE
Le traitement de l'interface de programmation de la journalisation Java des programmes de consignation nommés et des événements au niveau du message se fait 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.