Classes d'extension JRas
WebSphere Application Server fournit un ensemble de classes d'implémentation de base appelées collectivement JRas extensions. Un grand nombre de ces classes offrent des implémentations de consignateurs, gestionnaires et modules de formatage destinées à être utilisées dans un environnement WebSphere Application Server.
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™.
Cette collection de classes JRas est spécifiquement conçue pour un mode de fonctionnement intégré. Si vous choisissez d'utiliser les extensions JRA en mode autonome ou combiné, vous pouvez réutiliser la classe de consignateur et de gestionnaire fournie par les extensions mais vous devez fournir vos propres implémentations de gestionnaires et modules de formatage.
Consignateurs de messages et de traces WebSphere Application Server
Les consignateurs de messages et de traces fournis par le kit d'outils de consignation JRA autonome ne peuvent pas être utilisés directement dans l'environnement WebSphere Application Server. Les extensions JRA fournissent les classes d'implémentation du consignateur appropriées. Les instances de ces classes de consignateur de traces et de messages sont obtenues de manière directe et exclusive à partir de la classe Manager WebSphere Application Server. Les consignateurs de traces et de messages ne peuvent pas être instanciés directement. Les consignateurs ne peuvent être obtenus que directement à partir de la classe Manager, sinon cela viole directement le modèle de programmation.
Les instances des consignateurs de messages et de traces obtenues à partir de la classe Manager WebSphere Application Server Manager sont des sous-classes des classes RASMessageLogger et RASTraceLogger fournies par le kit d'outils de consignation JRA autonome. Les classes RASMessageLogger et RASTraceLogger définissent l'ensemble de méthodes disponible directement. Les méthodes publiques introduites par les sous-classes du consignateur d'extensions JRA ne peuvent pas être appelées directement par le code utilisateur car cela est une violation du modèle de programmation.
Les consignateurs sont des objets nommés identifiés par leur nom. Lorsque la classe Manager est appelée en vue de l'obtention d'un consignateur, l'appelant doit indiquer le nom du consignateur. La classe Manager gère un mappage d'instances définissant les associations entre un nom et un consignateur. Une seule instance d'un consignateur nommé est créée pendant la durée de vie d'un processus. Lorsque la classe Manager dotée d'un nom particulier est appelée pour la première fois, le consignateur est configuré par la classe Manager. Cette dernière enregistre une référence à l'instance dans le cache et la renvoie à l'appelant. Les appels suivants à la classe Manager indiquant ce même nom entraînent l'envoi d'une référence au consignateur mis en cache. Des espaces de noms distincts sont gérés pour les consignateurs de messages et de traces. Vous pouvez utiliser un nom unique pour gérer à la fois un consignateur de messages et un consignateur de traces à partir de la classe Manager, sans ambiguïté, et sans entraîner de conflit dans l'espace de noms.
En général, les consignateurs n'ont aucune granularité ou portée prédéfinie. Un consignateur unique peut être utilisé pour instrumenter une application toute entière. Vous pouvez déterminer qu'il est plus efficace de disposer d'un consignateur par classe ou la granularité appropriée sera entre les deux. Le partitionnement d'une application dans des domaines de consignation est déterminé par le développeur de l'application.
Les classes du consignateur WebSphere Application Server obtenues à partir de la classe Manager peuvent être utilisées par plusieurs unités d'exécution. Bien que les consignateurs faisant partie du kit d'outils de consignation JRA autonome implémentent l'interface sérialisable, ceux-ci ne sont pas sérialisables. Les consignateurs sont des objets avec état, liés à une instance de machine virtuelle Java et ne sont pas sérialisables. Toute tentative visant à sérialiser un consignateur est en total désaccord avec les règles du modèle de programmation.
Les sous-classes personnelles ou individuelles ne sont pas prises en charge dans un environnement WebSphere Application Server.
Gestionnaires de WebSphere Application Server
WebSphere Application Server fournit la classe de gestionnaire appropriée qui permet d'enregistrer des événements de traçage et de messages dans les journaux d'exécution de WebSphere Application Server. Le gestionnaire WebSphere Application Server ne peut pas être configuré dans le but d'enregistrer des données sur une autre destination. La création d'un gestionnaire WebSphere Application Server est une opération à usage restreint qui n'est pas disponible dans le code utilisateur. Chaque consignateur obtenu à partir de la classe Manager est préconfiguré et une instance de ce gestionnaire est déjà installée. Vous pouvez supprimer le gestionnaire WebSphere Application Server d'un consignateur lors d'une exécution en mode autonome. Lorsque vous supprimez un gestionnaire WebSphere Application Server il n'est plus possible de le réintégrer dans le consignateur d'origine (ou tout autre consignateur). De plus, il n'est pas possible d'appeler directement une méthode du gestionnaire WebSphere Application Server. Toute tentative de création d'une instance du gestionnaire WebSphere Application Server, d'appel de méthodes du gestionnaire WebSphere Application Server ou d'ajout d'un gestionnaire WebSphere Application Server à un consignateur par le biais du code utilisateur, est en désaccord total avec les règles du modèle de programmation.
Modules de formatage de WebSphere Application Server
Le gestionnaire WebSphere Application Server est préconfiguré avec le module de formatage adapté aux données enregistrées dans les journaux WebSphere Application Server. La création d'un module de formatage WebSphere Application Server est une opération à usage restreint qui n'est pas disponible dans le code utilisateur. L'utilisateur n'a pas la possibilité d'obtenir une référence au module de formatage installé dans un gestionnaire WebSphere Application Server ou de modifier le module de formatage utilisé par un gestionnaire WebSphere Application Server.
Gestionnaires de WebSphere Application Server
WebSphere Application Server fournit une classe Manager dans le package com.ibm.websphere.ras. Tous les consignateurs de messages et de traces doivent être obtenus à partir de la classe Manager. Une référence à la classe Manager peut être obtenue en appelant la méthode statique Manager.getManager. Les consignateurs de messages sont obtenus en appelant la méthode createRASMessageLogger dans la classe Manager. Les consignateurs de traces sont obtenus en appelant la méthode createRASTraceLogger dans la classe Manager.
Le gestionnaire prend également en charge une abstraction de groupe qui permet de gérer les consignateurs de traces. L'abstraction de groupe permet d'enregistrer plusieurs consignateurs de traces distincts au sein d'une entité nommée appelée groupe. WebSphere Application Server offre les fonctions de gestion de systèmes appropriées permettant de gérer le paramètre de trace d'un groupe, comme pour les paramètres de trace d'un travail de consignateur de trace individuel.
Supposons, par exemple, qu'un composant A contienne 10 classes. Supposons encore que chaque classe soit configurée de manière à utiliser un consignateur de trace distinct. Les 10 consignateurs de traces du composant soient enregistrés en tant que membres du même groupe, par exemple Component_A_Group. Vous pouvez activer la trace pour les 10 classes en une seule fois à l'aide du nom du groupe si vous voulez générer une trace de composant. Les noms de groupes sont gérés dans le même espace de noms que les consignateurs de traces.