Instances de gestionnaires et de consignateurs JRas
Vous pouvez utiliser les extensions JRas en mode intégré, autonome ou combiné. La configuration de l'application varie en fonction du mode d'exploitation, mais l'utilisation des programmes de consignation de messages ou d'entrées de trace est identique pour tous les modes.
Obsolète : La structure JRas décrite dans cette tâche et ses sous-tâches est obsolète. Toutefois, vous pouvez atteindre des résultats similaires à l'aide de la consignation Java™.
Le mode intégré est le mode opératoire par défaut. Dans ce mode, les événements de messages et de traçage sont envoyés aux journaux WebSphere Application Server.
En mode combiné, les événements de messages et de traçage sont consignés dans les journaux WebSphere Application Server et les journaux définis par l'utilisateur.
En mode autonome, les événements de messages et de traçage ne sont consignés que dans les journaux définis par l'utilisateur.
Utilisation des consignateurs de messages et de traces
Quel que soit le mode opératoire retenu, les consignateurs de messages et de traces s'utilisent de la même manière.
Utilisation d'un consignateur de messages
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,"Chaîne et entier", "Une chaîne", new Integer(5));
Utilisation d'un consignateur de traces
private void methodX(int x, String y, Foo z)
{
// Traçage d'un point d'entrée. Utilisez la surveillance pour vous assurer que le traçage est activé.
Procédez à ce contrôle avant de collecter les paramètres à tracer.
if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT) {
// pour tracer trois paramètres, regroupez-les dans Object[]
Object[] parms = {new Integer(x), y, z};
trcLogger.entry(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX", parms);
}
... logic
// Point de trace de débogage ou prolixe
if (trcLogger.isLoggable(RASITraceEvent.TYPE_MISC_DATA) {
trcLogger.trace(RASITraceEvent.TYPE_MISC_DATA, this, "methodX" "reached here");
}
...
// Autre classification d'événement de trace. Un important changement d'état est
détecté, par conséquent, un autre type de trace est utilisé.
if (trcLogger.isLoggable(RASITraceEvent.TYPE_SVC) {
trcLogger.trace(RASITraceEvent.TYPE_SVC, this, "methodX", "un événement important");
}
...
// Prêt à quitter la méthode, la trace. Aucune valeur de retour ne doit faire l'objet d'un traçage
if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT)) {
trcLogger.exit(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX");
}
}