Résumé du modèle de programmation
Le modèle de programmation décrit ici s'appuie sur et reprend certains des concepts déjà évoqués. La présente section définit également les exigences et restrictions d'utilisation. L'utilisation des extensions WebSphere Application Server JRas d'une manière non conforme aux instructions de programmation ci-après est interdite.
Remarque : 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™.
Vous pouvez utiliser les extensions WebSphere Application Server JRas dans trois modes opératoires distincts. Les restrictions et concepts
des modèles de programmation sont applicables à tous les modes opératoires.
- Vous ne devez pas utiliser directement les classes d'implémentation du jeu d'outils de consignation JRas autonome, sauf spécification inverse. L'utilisation directe de ces classes n'est pas prise en charge. Le Support IBM® ne fournit pas d'aide au diagnostic ni de correctifs de bogues pour l'utilisation directe des classes du jeu d'outils de consignation JRas autonome.
- Vous devez extraire les consignateurs de messages et de traces directement de la classe Manager. Vous ne pouvez pas instancier directement des consignateurs.
- Vous ne pouvez pas remplacer les classes de consignateurs de messages et de traces WebSphere Application Server.
- Vous devez vous assurer que les noms de consignateurs transmis à la classe Manager sont uniques et doivent respecter les règles de dénomination décrites. Vous ne devez pas essayer de modifier le nom de ce consignateur obtenu à partir de cette classe en appelant la méthode setName.
- Les consignateurs de nom peuvent être utilisés plusieurs fois. Pour chaque nom, le premier appel de la classe Manager implique la création d'un consignateur associé à ce nom. Les appels suivants à cette classe qui spécifient le même nom entraînent le renvoi d'une référence au consignateur existant.
- La classe Manager gère un espace de nom hiérarchique pour consignateurs. Désignez un consignateur en spécifiant un nom de classe qualifié avec un point comme séparateur. Hormis les points, les noms de consignateurs ne doivent contenir aucun caractère de ponctuation, tel que l'astérisque (*), la virgule (,), le signe égal (=), le signe deux-point (:) ou les guillemets.
- Les noms de groupes doivent respecter les mêmes règles de dénomination que les noms de consignateurs.
- Les consignateurs renvoyés par la classe Manager sont des sous-classes des classes RASMessageLogger et RASTraceLogger que fournit le jeu d'outils de consignation JRas autonome. Vous pouvez appeler n'importe quelle méthode publique définie par les classes RASMessageLogger et RASTraceLogger. En revanche, vous ne pouvez pas appeler celles qui ont été introduites par les sous-classes fournies.
- Si vous souhaitez travailler en mode autonome ou combiné, vous devez fournir vos propres sous-classes de gestionnaires et de programmes de formatage. Vous ne pouvez pas utiliser les classes de gestionnaires et de programmes de formatage du jeu d'outils de consignation JRas autonome. Les gestionnaires et les programmes de formatage écrits par l'utilisateur doivent respecter les règles indiquées dans la documentation.
- Les consignateurs provenant de la classe Manager sont fournis avec un gestionnaire WebSphere Application Server déjà installé. Ce gestionnaire écrit les enregistrements de message et de trace dans des journaux définis par WebSphere Application Server en phase d'exécution. Pour gérer ces journaux, utilisez les interfaces de gestion de systèmes fournies.
- Vous pouvez à tout moment ajouter par programmation à un consignateur des gestionnaires définis par l'utilisateur ou les supprimer. Plusieurs ajouts ou suppressions de ce type de gestionnaire sont pris en charge. Vous devez créer une instance du gestionnaire pour ajouter, configurer de manière appropriée le gestionnaire en définissant la valeur de masque du gestionnaire et du programme de formatage, puis ajouter le gestionnaire au consignateur avec la méthode addHandler. Vous devez mettre correctement à jour par programmation les masques des gestionnaires définis par l'utilisateur.
- Vous devez extraire une référence sur le gestionnaire installé dans un consignateur par appel de la méthode getHandlers sur le consignateur et par traitement des résultats. Vous ne devez appeler aucune méthode sur le gestionnaire obtenu de cette façon. Vous pouvez supprimer le gestionnaire WebSphere Application Server du consignateur en appelant la méthode removeHandler des consignateurs et en transmettant la référence au gestionnaire WebSphere Application Server. Une fois supprimé, le gestionnaire WebSphere Application Server ne peut plus être ajouté de nouveau au consignateur.
- Vous pouvez définir votre propre type de message. Pour plus d'informations sur le comportement des types de messages définis par l'utilisateur et les restrictions liées à leurs définitions, voir Canevas JRas (obsolète).
- Vous pouvez définir vos propres classes d'événements de message. L'utilisation des classes d'événements de message définies par l'utilisateur est décrite dans Canevas JRas (obsolète).
- Vous pouvez définir vos propres types de trace. Pour plus d'informations sur les types de traces définis par l'utilisateur et les restrictions liées à vos définitions, voir Canevas JRas (obsolète).
- Vous pouvez définir vos propres classes d'événements de trace. L'utilisation des classes d'événements de trace définies par l'utilisateur est décrite dans Canevas JRas (obsolète).
- Vous devez gérer par programmation les éléments binaires des masques des consignateurs de messages et de traces correspondant aux types définis par l'utilisateur. Si vous utilisez des fonctions WebSphere Application Server pour gérer les types prédéfinis, ces mises à jour ne doivent modifier l'état d'aucun des bits correspondant à ces types. Si vous assumez l'entière responsabilité en tant que possesseur des types prédéfinis, vous pouvez modifier tous les bits des masques.