Instanzen von JRas-Managern und -Protokollfunktionen
Sie können JRas-Erweiterungen im integrierten, eigenständigen oder kombinierten Modus verwenden. Die Konfiguration der Anwendung hängt vom Betriebsmodus ab, aber die Verwendung der Protokollfunktionen (Logger) zum Protokollieren von Nachrichten oder Traceeinträgen ist in allen Betriebsmodi gleich.
Veraltet: Das JRas-Framework, das in dieser Task und den untergeordneten Tasks beschrieben wird, wird nicht weiter unterstützt. Sie können jedoch ähnliche Ergebnisse mit der Java™-Protokollierung erzielen.
Der integrierte Modus ist der Standardbetriebsmodus. In diesem Modus werden Nachrichten- und Traceereignisse an die Protokolle von WebSphere Application Server gesendet.
Im kombinierten Modus werden Nachrichten- und Traceereignisse an die Protokolle von WebSphere Application Server und an benutzerdefinierte Protokolle gesendet.
Im eigenständigen Modus werden Nachrichten- und Traceereignisse nur an benutzerdefinierte Protokolle gesendet.
Nachrichten- und Traceprotokollfunktionen verwenden
Unabhängig vom Betriebsmodus ist die Verwendung von Nachrichten- und Traceprotokollfunktionen dieselbe.
Nachrichtenprotokollfunktion verwenden
msgLogger.message(RASIMessageEvent.TYPE_WARNING, this, methodName, "MSG_KEY_00"); ... msgLogger.message(RASIMessageEvent.TYPE_WARN, this, methodName, "MSG_KEY_01", "some string");
msgLogger.msg(RASIMessageEvent.TYPE_ERR, this, methodName, "ALT_MSG_KEY_00", "alternateMessageFile");
msgLogger.textMessage(RASIMessageEvent.TYPE_INFO, this, methodName,"String and Integer", "A String", new Integer(5));
Traceprotokollfunktion verwenden
private void methodX(int x, String y, Foo z)
{
// Trace eines Einstiegspunktes. Mit Hilfe der Überwachung prüfen, ob die Traceerstellung aktiviert ist.
// Prüfen Sie dies, bevor Sie Parameter zusammenstellen, für die ein Trace durchgeführt werden soll.
if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT) {
// Da ein Trace für drei Parameter durchgeführt werden soll, diese in ein Object[] packen
Object[] parms = {new Integer(x), y, z};
trcLogger.entry(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX", parms);
}
... logic
// a debug or verbose trace point
if (trcLogger.isLoggable(RASITraceEvent.TYPE_MISC_DATA) {
trcLogger.trace(RASITraceEvent.TYPE_MISC_DATA, this, "methodX" "reached here");
}
...
// Eine weitere Klassifizierung des Traceereignisses. Es wurde eine wichtige Statusänderung festgestellt,
// daher wird ein anderer Tracetyp verwendet.
if (trcLogger.isLoggable(RASITraceEvent.TYPE_SVC) {
trcLogger.trace(RASITraceEvent.TYPE_SVC, this, "methodX", "an important event");
}
...
// Bereit zum Verlassen der Methode, Trace. Kein Rückgabewert an den Trace
if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT)) {
trcLogger.exit(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX");
}
}