Création d'une configuration de gestionnaire JAX-RPC

Création d'une configuration de gestionnaire JAX-RPC à utiliser, dans une liste de gestionnaires, avec les services web déployés par le bus d'intégration de services. Les gestionnaires surveillent les messages sur les ports et effectuent les actions appropriées en fonction de l'émetteur et du contenu de chaque message.

Avant de commencer

Cette tâche suppose que vous avez déjà créé votre gestionnaire. Vous pouvez le faire en utilisant IBM® Rational Application Developer ou un outil similaire. Pour plus d'informations, voir l'article IBM developerWorks intitulé Support for J2EE Web Services in WebSphere Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers.

Vous devez également rendre la classe de gestionnaire disponible pour le serveur ou pour le cluster qui héberge le port du service à surveiller (voir Chargement des classes de gestionnaire JAX-RPC).

Pourquoi et quand exécuter cette tâche

Une API Java™ pour gestionnaire d'appels de procédure distante XML (JAX-RPC) est une classe Java qui effectue toute une série de tâches de gestion. Par exemple : consignation de messages, conversion de leurs données ou arrêt d'une demande entrante. Pour que WebSphere Application Server détecte l'existence de votre gestionnaire et pour que celui-ci soit susceptible d'être inclus à une ou plusieurs listes de gestionnaires, vous devez utiliser la console d'administration pour créer une nouvelle configuration de gestionnaire.

Procédure

  1. Dans le panneau de navigation, cliquez sur Intégration des services -> Services Web -> Gestionnaires JAX-RPC Le formulaire de collecte des gestionnaires JAX-RPC est affiché.
  2. Cliquez sur Nouveau. Le formulaire des paramètres des gestionnaires JAX-RPC s'affiche.
  3. Entrez les propriétés générales suivantes :
    Name
    Entrez le nom sous lequel le gestionnaire est connu.
    Ce nom doit être unique et respecter les règles de syntaxe suivantes :
    • Il ne doit pas commencer par un point (".").
    • Il ne doit pas commencer ou se terminer par un espace.
    • Il ne doit contenir aucun des caractères suivants : \ / , # $ @ : ; " * ? < > | = + & % '
    Par exemple, GestionnaireTest.
    Description
    Entrez la description facultative du gestionnaire.
    Nom de classe
    Entrez le nom de la classe à instancier. Par exemple, com.ibm.jaxrpc.handler.TestHandler.
    Remarque : Vous pouvez configurer plusieurs instances d'un gestionnaire en créant chaque instance avec un nom de gestionnaire différent, et en pointant vers la même classe de gestionnaires.
  4. Cliquez sur OK. Les propriétés générales de cet élément sont sauvegardées et les options relatives aux propriétés supplémentaires deviennent accessibles.
  5. Entrez les propriétés supplémentaires suivantes :
    Rôles SOAP
    Ajoutez des définitions d'acteur SOAP à la liste des rôles SOAP dans lesquels ce gestionnaire intervient. Pour plus d'informations, voir la spécification SOAP.
    En-têtes JAX-RPC
    Ajoutez les définitions d'en-tête JAX-RPC (URI de l'espace nom et partie locale) à la liste des en-têtes JAX-RPC sur lesquels ce gestionnaire intervient. Les en-têtes JAX-RPC sont des en-têtes SOAP qui sont traités par un gestionnaire JAX-RPC.
    Propriétés personnalisées
    Ajoutez des propriétés personnalisées (paires nom-valeur, le nom désignant une clé de propriété et la valeur correspondant à une chaîne qui permet de définir des propriétés de configuration du système interne).
  6. Sauvegardez les modifications de la configuration principale.

Résultats

Si le traitement se déroule correctement, la liste des gestionnaires est mise à jour pour inclure le nouveau gestionnaire. Sinon, un message d'erreur s'affiche.

Que faire ensuite

Pour utiliser ce gestionnaire, ajoutez-le à la liste de gestionnaires, comme décrit dans Création d'une liste de gestionnaires JAX-RPC ou Modification d'une liste de gestionnaires JAX-RPC existante.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_jaxrpc_handler_new
Nom du fichier : tjw_jaxrpc_handler_new.html