Utilisation d'un moteur de services Web tiers

Dans certaines situations, vous pouvez avoir besoin d'installer un moteur de services Web JAX-WS tiers. Par exemple, si vous devez déployer des applications utilisant un environnement d'exécution unique sur différents serveurs d'applications, comme WebSphere Application Server, JBoss et WebLogic, ou si vous voulez générer des applications de services Web utilisant des environnements d'exécution JAX-WS tierces, comme CXF, Axis2 et Metro.

Avant de commencer

L'utilisation d'un environnement d'exécution JAX-WS tierce a des limitations. Elle nécessite aussi des modifications obligatoires de la configuration et, dans certains cas, des interventions manuelles pour résoudre les problèmes qui surviennent au cours du déploiement et pendant le fonctionnement de l'application. Ces limitations et ces problèmes varient en fonction de l'environnement d'exécution JAX-WS tiers que vous choisissez d'utiliser. Vous devez comprendre les limitations liées à l'environnement d'exécution JAX-WS tiers que vous vous préparez à utiliser, avant de configurer votre système pour l'utilisation de cette implémentation.

Les limitations suivantes existent, quelle que soit l'implémentation JAX-WS tierce que vous utilisez :
  • L'environnement d'exécution de WebSphere Application Server restreint l'utilisation des modules applicatifs qui utilisent à la fois l'implémentation JAX-WS fournie avec WebSphere Application Server et une implémentation JAX-WS externe dans le même fichier EAR d'application. Dans un fichier EAR d'application, vous devez choisir entre l'implémentation JAX-WS fournie avec WebSphere Application Server, et l'implémentation externe. Cette limitation évite les conflits entre l'environnement d'exécution de WebSphere Application Server et l'implémentation JAX-WS tierce.
  • Tous les fichiers JAR générant des conflits doivent avoir été supprimés de la bibliothèque de votre application avant le déploiement d'une application utilisant une implémentation JAX-WS externe. La plupart des environnements d'exécution JAX-WS tiers externes comprennent des bibliothèques de fichiers JAR qui sont déjà installées sur WebSphere Application Server. Cette situation provoque des conflits dans votre bibliothèque d'application.
  • Après qu'une application utilisant un environnement d'exécution JAX-WS tiers est déployée sur WebSphere Application Server, elle n'est plus reconnue comme un client ou un fournisseur de services. Il n'est donc pas possible d'y associer des ensembles de règles de niveau application. Vous devez vous fier à la qualité de service du support des environnements d'exécution externes. Vous trouverez ci-dessous une liste de fonctions de WebSphere Application Server qui ne sont pas disponibles si vous décidez de déployer et d'exécuter une application qui utilise une implémentation JAX-WS tierce :
    • Les ensembles de règles WS-Security, WS-RM et WS-Transactions
    • WSDM
    • La recherche JNDI pour récupérer un service ou une instance de port JAX-WS.
Eviter les incidents Eviter les incidents: Même si IBM fournit une assistance pour la mise en oeuvre des environnements d'exécution JAX-WS tiers sur WebSphere Application Server, et s'assure de la réussite du déploiement des applications qui les utilisent, IBM ne fournit pas d'assistance pour résoudre les problèmes de conflit des fichiers JAR, ni des problèmes dont une trace de pile indique qu'ils proviennent du code tiers.gotcha

Pourquoi et quand exécuter cette tâche

Lorsque vous déployez un fichier EAR d'application avec une implémentation JAX-WS tierce sur WebSphere Application Server, l'environnement d'exécution de WebSphere Application Server doit garantir l'utilisation du moteur tiers et désactiver l'utilisation du moteur de services Web JAX-WS WebSphere Application Server existant.

WebSphere Application Server ne garantit pas la prise en charge des environnements d'exécution JAX-WS tiers, mais a testé le déploiement et l'exécution des applications qui les utilisent.

Vous devez effectuer les opérations ci-dessous avant de pouvoir utiliser un environnement d'exécution JAX-WS externe dans une application.

Procédure

  1. Définissez la règle du chargeur de classe à Classes chargées en premier avec un chargeur de classe local (dernier parent) au niveau du module.

    La modification de la règle du chargeur de classe et son réglage sur "dernier parent" garantit que l'environnement d'exécution externe JAX-WS tiers et les fichiers JAR de bibliothèque dépendants sont les premiers dans le chemin de recherche du chargeur de classe, permettant à l'implémentation tierce d'être utilisée à la place de WebSphere Application Server.

    1. Dans la console d'administration, cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere > nom_application> Gestion des modules>nom_module_Web.
    2. Sélectionnez Classes chargées en premier avec un chargeur de classe local (dernier parent) dans la liste déroulante.
    3. Cliquez sur OK, puis sur Sauvegarder pour enregistrer les modifications.
    1. Cliquez sur OK, puis sur Sauvegarder pour enregistrer les modifications.
  2. Désactivez l'analyse des annotations des services Web.

    L'analyse des annotations peut être désactivée au niveau de l'application ou du serveur.

    Pour la désactiver au niveau de l'application, affectez la valeur true à la propriété DisableIBMJAXWSEngine dans META-INF/MANIFEST.MF dans un fichier WAR ou un module EJB. Exemple :
    Manifest-Version: 1.0
    DisableIBMJAXWSEngine: true

    Pour désactiver l'analyse des annotations des services Web au niveau du serveur :

    1. Dans la console d'administration, allez à la page des propriétés personnalisées de la machine virtuelle Java.

      [z/OS]Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur, puis, dans la section Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus > Contrôle > Machine virtuelle Java > Propriétés personnalisées.

      [AIX Solaris HP-UX Linux Windows][IBM i]Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur, puis, sous Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus > Machine JVM > Propriétés personnalisées.

    2. Attribuez à la propriété com.ibm.websphere.webservices.DisableIBMJAXWSEngine la valeur true.

      Si cette propriété n'existe pas déjà pour votre configuration, cliquez sur Nouveau et ajoutez com.ibm.websphere.webservices.DisableIBMJAXWSEngine dans la zone Nom et true dans la zone Valeur.

Résultats

Que faire ensuite

  • Déployez et exécutez le fichier EAR d'application avec une implémentation JAX-WS tierce sur WebSphere Application Server.

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=twbs_thirdparty
Nom du fichier : twbs_thirdparty.html