Infrastructure JRas (obsolète)
Les classes d'extensions JRas n'ayant pas la souplesse et le comportement requis par la plupart des scénarios, une grande variété de points d'extension sont définis. Vous pouvez écrire vos propres classes d'implémentation afin d'obtenir le comportement voulu.
Obsolète : Il est déconseillé d'utiliser la structure JRas décrite dans cette rubrique. Toutefois, vous pouvez atteindre des résultats similaires à l'aide de la consignation Java™.
En général, les extensions JRas exigent que vous appeliez la classe Manager pour se procurer un consignateur de messages ou un consignateur de traces. Aucune mise à disposition ne permet de fournir vos propres sous-classes de programmes de consignation de message ou de trace. Généralement, les extensions que vous fournissez ne permettent pas de modifier le mode d'exploitation intégré. Le comportement de ce mode ne dépend que de l'environnement d'exécution de WebSphere Application Server et des classes d'extensions JRas.
Gestionnaires
Le jeu d'outils de consignation JRas autonome définit l'interface RASIHandler. Tous les gestionnaires doivent implémenter cette interface. Vous pouvez écrire vos propres classes de gestionnaire qui implémentent l'interface RASIHandler. Vous devez directement créer des instances de gestionnaires définies par l'utilisateur et les ajouter dans les consignateurs obtenus à partir de la classe de gestionnaire.
Le jeu d'outils de consignation JRas autonome fournit plusieurs classes d'implémentation de gestionnaire. Ces classes de gestionnaires ne sont pas adaptées à l'environnement J2EE (Java 2 Platform, Enterprise Edition). Vous ne devez pas utiliser directement ou sous-classer les classes de gestionnaires fournies par le jeu d'outils de consignation JRas autonome. Cette pratique est en total désaccord avec les règles du modèle de programmation.
Programmes de formatage
Le jeu d'outils de consignation JRas autonome définit l'interface RASIFormatter. Tous les gestionnaires doivent implémenter cette interface. Vous pouvez écrire vos propres classes de formatage qui implémentent l'interface RASIFormatter. Vous ne pouvez ajouter ces classes qu'à un gestionnaire défini par l'utilisateur. Vous ne pouvez pas configurer les gestionnaires WebSphere Application Server de sorte qu'ils utilisent des programmes de formatage définis par l'utilisateur. Vous devez directement créer des instances de vos programmes de formatage et les ajouter de manière appropriée à vos gestionnaires.
Comme pour les gestionnaires, le jeu d'outils de consignation JRas autonome fournit plusieurs classes d'implémentation de programme de formatage. L'utilisation directe de ces classes de programmes de formatage n'est pas prise en charge.
Types d'événements de messages
Le jeu d'outils JRas autonome définit les types d'événements de message dans l'interface RASIMessageEvent. De plus, WebSphere Application Server réserve une série de types d'événements de messages pour usage ultérieur. L'interface RASIMessageEvent définit trois types dont les valeurs sont : 0x01, 0x02 et 0x04. Les valeurs comprises entre 0x08 et 0x8000 sont réservées pour usage ultérieur. Vous pouvez fournir vos propres types d'événements de messages en développant cette interface de manière appropriée. Les types de message définis par l'utilisateur doivent avoir la valeur 0x1000 ou supérieure.
Les consignateurs de messages extraits de la classe Manager ont des masques de message définis sur pass ou traitent tous les types d'événements de messages définis dans l'interface RASIMessageEvent. Pour traiter les types de message définis par l'utilisateur, vous devez définir manuellement le consignateur de messages à l'état approprié par code utilisateur, après obtention du consignateur de messages à partir de la classe Manager. WebSphere Application Server ne fournit aucun support intégré de gestion des systèmes pour la gestion des types de message.
Objets événements de messages
Le jeu d'outils de consignation JRas autonome fournit une classe d'implémentation RASMessageEvent. A l'appel d'une méthode de consignation de messages sur le consignateur de messages, si le type de message est actif, le consignateur crée et distribue un événement de cette classe à tous les gestionnaires actuellement enregistrés auprès de ce consignateur.
Vous pouvez fournir vos propres classes d'événements de messages, sous réserve qu'elles implémentent l'interface RASIEvent. Vous devez directement créer des instances de ces classes d'événements de messages définies par l'utilisateur. Une fois qu'il a été créé, transmettez l'événement de message défini par l'utilisateur au consignateur de messages par appel direct de la méthode fireRASEvent du consignateur de messages. Les consignateurs de messages WebSphere Application Server ne peuvent pas créer directement des instances de types définis par l'utilisateur en réponse à l'appel d'une méthode de consignation (msg.message) sur le consignateur. De plus, les instances de types de messages définis par l'utilisateur ne sont jamais traitées par le gestionnaire WebSphere Application Server. Vous ne pouvez pas créer directement d'instances de la classe RASMessageEvent.
Types d'événements de traçage
Le jeu d'outils de consignation JRas autonome définit des types d'événements de traçage dans l'interface RASITraceEvent. Vous pouvez fournir vos propres types d'événements de traçage en développant cette interface de manière appropriée. Auquel cas, assurez-vous que les valeurs des types d'événement de traçage définis n'entrent pas en conflit avec les valeurs des types définis dans l'interface RASITraceEvent.
Les masques de trace des consignateurs de trace extraits de la classe Manager sont généralement définis de manière à rejeter tous les types. Des fonctions WebSphere Application Server de gestion des systèmes permettent de modifier cet état défini au démarrage. De plus, vous pouvez modifier l'état du masque de trace d'un consignateur au cours de l'exécution en utilisant les fonctions de gestion des systèmes de WebSphere Application Server.
Pour traiter les types de trace définis par l'utilisateur, le consignateur de traces doit être défini manuellement à l'état approprié par le code utilisateur. Les fonctions WebSphere Application Server de gestion des systèmes ne permettent pas de gérer les types de trace définis par l'utilisateur, que ce soit au démarrage ou lors de l'exécution.
Objets événements de traçage
Le jeu d'outils de consignation JRas autonome fournit une classe d'implémentation RASTraceEvent. A l'appel d'une méthode de consignation de traces sur le consignateur de traces WebSphere Application Server, si le type de trace est actif, le consignateur crée et distribue un événement de cette classe à tous les gestionnaires actuellement enregistrés auprès de ce consignateur.
Vous pouvez fournir vos propres classes d'événements de traces. Ces classes d'événements de traçage doivent implémenter l'interface RASIEvent. Vous devez créer des instances de ces classes d'événements de traçage définies par l'utilisateur directement. Une fois que l'événement de trace a été créé, transmettez-le au consignateur de trace en appelant directement la méthode fireRASEvent de ce dernier. Les consignateurs de trace WebSphere Application Server ne peuvent pas créer des instances de types définis par l'utilisateur en réponse à l'appel d'une méthode de trace (entrée, exit, trace) sur le consignateur de trace. De plus, les instances de types de trace définis par l'utilisateur ne sont jamais traitées par le gestionnaire WebSphere Application Server. Vous ne pouvez pas créer directement d'instances de la classe RASTraceEvent.
Types définis par l'utilisateur, événements définis par l'utilisateur et WebSphere Application Server
Le gestionnaire WebSphere Application Server est conçu pour traiter les classes de messages ou de traces définies par l'utilisateur ou bien les classes d'événements de messages ou de traces définies par l'utilisateur. Les entrées de messages ou de traces des types et classes définis par l'utilisateur ne sont pas consignées dans les journaux d'exécution de WebSphere Application Server.