java.util.logging -- Programmierschnittstelle für Java-Protokollierung

Die Klasse java.util.logging.Logger stellt eine Vielzahl von Methoden für die Protokollierung von Daten bereit.

Die Java™-Protokollierungs-API in WebSphere Application Server (java.util.logging) erstellt automatisch Common Base Events (CBEs) für Ereignisse der Protokollstufe WsLevel.DETAIL und höher (einschließlich WsLevel.DETAIL, Level.CONFIG, Level.INFO, WsLevel.AUDIT, Level.WARNING, Level.SEVERE und WsLevel.FATAL). Diese Common Base Events werden mit der Ereignisfactory erstellt, die der Protokollfunktion (Logger) zugeordnet sind, für den die Nachricht protokolliert wurde. Wenn keine Ereignisfactory angegeben ist, verwendet WebSphere Application Server eine Standardereignis-Factory, die die spezifischen Informationen für WebSphere Application Server automatisch belegt.

WebSphere Application Server verwendet eine spezielle Implementierung der Klasse java.util.logging.Logger, die automatisch Common Base Events für die folgenden Methoden erstellt:
  • config
  • info
  • warning
  • severe
  • log: Alle Varianten mit Ausnahme von log(LogRecord), wenn diese Methode mit WsLevel.DETAIL oder höheren Stufen verwendet wird.
  • logp: Wenn diese Methode mit WsLevel.DETAIL oder höheren Stufen verwendet wird.
  • logrb: Wenn diese Methode mit WsLevel.DETAIL oder höheren Stufen verwendet wird.
Die Protokollfunktionsimplementierung von WebSphere Application Server wird nur für benannte Protokollfunktionen verwendet, z. B. Protokollfunktionen, die mit Aufrufen wie Logger.getLogger("com.xyz.SomeLoggerName") instanziert werden. Logger, die mit Aufrufen der Methoden Logger.getAnonymousLogger und Logger.getLogger oder Logger.global instanziert werden, verwenden die WAS-Implementierung nicht und erstellen nicht automatisch Common Base Events für Protokollierungsanforderungen, die an sie übergeben werden. Direkt mit Logger.log(LogRecord) protokollierte Protokollsätze werden nicht automatisch von den WebSphere Application Server-Protokollfunktionen in Common Base Events konvertiert.

Die folgende Abbildung veranschaulicht, wie Anwendungscode Common Base Events protokollieren kann:

CBE-Protokollierung durch den Anwendungscode

Die Java-Protokollierungs-API verarbeitet benannte Protokollfunktionen und Ereignisse auf Nachrichtenebene wie folgt:
  1. Der Anwendungscode ruft die benannte Protokollfunktion (WsLevel.DETAIL und höher) mit ereignisspezifischen Daten auf.
  2. Die Protokollfunktion erstellt unter Verwendung der Methode "createCommonBaseEvent" in der Ereignisfactory, die der Protokollfunktion zugeordnet ist, ein Common Base Event.
  3. Die Protokollfunktion erstellt unter Verwendung der Ereignisfactory, die der Protokollfunktion zugeordnet ist, ein Common Base Event.
  4. Die Protokollfunktion packt das Common Base Event in einen CommonBaseEventLogRecord-Datensatz und fügt ereignisspezifische Daten hinzu.
  5. Die Protokollfunktion ruft die Methode "complete" von Common Base Event auf.
  6. Das Common Base Event ruft die Methode "completeEvent" des ContentHandler auf.
  7. Der ContentHandler fügt dem Common Base Event XML-Schablonendaten hinzu (z. B. den Komponentennamen). Nicht alle ContentHandler unterstützen Schablonen.
  8. Der ContentHandler fügt dem Common Base Event Laufzeitdaten hinzu (z. B. den Namen des aktuellen Thread).
  9. Die Protokollfunktion übergibt den CommonBaseEventLogRecord-Datensatz an die Handler.
  10. Die Handler formatieren die Daten und schreiben sie in die Ausgabeeinheit.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbejavaapi
Dateiname:rtrb_cbejavaapi.html