Meilleures méthodes pour la migration des services Web
Les meilleures pratiques recommandées ici vous seront utiles pour la migration des applications de services Web.
Si vous avez utilisé la prise en charge SOAP par Apache pour développer dans WebSphere Application Server versions 4, 5 ou 5.1 des applications de clients de services Web, vous aurez peut-être à faire migrer vos applications ou les fichiers de sécurité de vos applications. Le tableau suivant récapitule les spécifications de services Web prises en charge par les produits WebSphere.
WebSphere Application Server Version | Spécifications de services Web prises en charge |
---|---|
4.0 | Apache SOAP 2.2 |
5.0 et 5.0.1 | Apache SOAP 2.3 |
5.0.2 ou ultérieure | Java™ 2 Platform, Enterprise Edition (J2EE), également connu sous le nom de JSR 109 |
6.0.x et 6.1 | J2EE (JSR 109) |
7.0 ou plus récent | Web Services for Java EE (Java Platform, Enterprise Edition) 5, également connu sous le nom de JSR 109 |

Pour plus d'informations sur la migration de vos services Web, voir la section sur la migration de services Web Apache SOAP vers des services Web JAX-RPC basés sur les normes Java EE.
Il est recommandé de développer de nouveaux services Web à l'aide de la spécification de service Web pour Java EE. Pour plus d'informations, voir Implémentations d'applications de services Web.
Il est impossible de faire migrer la sécurité directement depuis SOAP 2.3 vers les normes Java EE. Après avoir fait migrer les services Web vers les normes Java EE, sécurisez vos applications de service Web. Pour plus de détails, consultez les informations sur la sécurisation des applications de services Web à l'aide de la sécurité au niveau des messages.
Suivez ces méthodes recommandées pour optimiser vos opérations de migration :
Le serveur d'applications prend en charge les modèles de programmation JAX-WS (API Java des services Web XML) et JAX-RPC (API Java pour le RPC basé sur XML). JAX-WS représente la future génération du modèle de programmation des services Web qui étend la base du modèle JAX-RPC.
Des applications JAX-RPC existantes souhaitant utiliser les fonctions JAX-WS doivent être réécrites à l'aide du modèle de programmation JAX-WS.
Redéploiement de services Web JAX-RPC existants après la migration d'une nouvelle version du serveur d'applications
Après avoir migré vers une nouvelle version du serveur d'applications, il est recommandé de redéployer les applications de services Web. Vous devez redéployer vos applications de services Web dans le nouvel environnement de serveur d'applications car les niveaux des spécifications de services Web et les descripteurs de ces derniers ont très bien pu changer dans la nouvelle version. Pour redéployer vos services Web, sélectionnez Déployer les services Web dans l'assistant Installation d'une nouvelle application ou utilisez la commande wsdeploy. Pour en savoir plus sur cette procédure, reportez-vous à la documentation consacrée au déploiement d'applications de services Web sur des serveurs d'applications.
Migration d'un client JAX-RPC (API Java pour appel de procédure éloignée basé sur XML) version 5 utilisant SOAP sur JMS (Java Message Service) pour appeler un service Web
Un client JAX-RPC qui est exécuté sur WebSphere Application Server version 5 utilise SOAP sur JMS pour appeler un service Web qui est exécuté sur un serveur d'applications version 5.
SibMessage W [:] CWSIT0009W: Une requête client a échoué sur le serveur d'applications avec
le noeud final <nom noeud final> dans le bus <nom bus> pour la raison ci-après : CWSIT0016E: L'ID utilisateur
de valeur null a échoué l'identification dans le bus <nom_bus>.
Lors de la migration du serveur d'applications vers la version 6.x, si le fournisseur de messagerie par défaut (technologies d'intégration de services) est utilisé et que la sécurité administrative et d'application est activée pour le serveur ou la cellule, la destination de file d'attente du bus d'intégration de service hérite, par défaut, des caractéristiques de sécurité du serveur ou de la cellule. Si l'authentification de base est activée sur le serveur ou la cellule, les demandes des clients échouent.
- Désactivez la sécurité administrative et d'applications sur le panneau de sécurité principal de la console d'administration. Pour ce faire, cliquez sur Activer la sécurité administrative et Activer la sécurité d'applications. . Désélectionnez les options
- Modifiez les paramètres du bus d'intégration de services hébergeant la destination de file d'attente afin de désactiver la sécurité du bus et de faire en sorte qu'il n'hérite pas des caractéristiques de sécurité du serveur ou de la cellule. Cette option est l'équivalent du niveau de sécurité que vous pouvez configurer dans la version 5.
- Configurez l'authentification de base sur chaque client qui utilise le service. Pour en savoir plus, voir les informations sur la configuration de l'authentification de base HTTP pour les services Web JAX-RPC avec la console d'administration.
Migration de services Web Apache SOAP
Vous pouvez migrer des services Web qui ont été développés à l'aide d'Apache SOAP vers des services Web développés conformément à la spécification Java 2 Platform, Enterprise Edition (J2EE). Voir la rubrique Migration de services Web Apache SOAP vers des services Web JAX-RPC basés sur les normes Java EE.
Migration de services Web assemblés avec les premières versions d'Application Server Toolkit ou d'Assembly Toolkit
- Lorsque vous faites migrer des services Web de J2EE 1.3 vers J2EE 1.4, l'assistant de migration J2EE ne fait pas migrer ceux de ces services qui sont sécurisés.
- La migration des services Web sécurisés requiert des étapes manuelles.
- Après la migration J2EE, vous devez faire migrer manuellement les fichiers d'extension et de liaison sécurisés
vers J2EE 1.4 en procédant comme suit :
- Cliquez deux fois sur le fichier webservices.xml pour ouvrir l'éditeur de services Web.
- Sélectionnez l'onglet Configurations de liaison pour éditer le fichier de liaison.
- Ajoutez toutes les configurations de liaison nécessaires sous les nouvelles sections Configuration de liaison du destinataire de la demande et Configuration de liaison du générateur de la réponse.
- Sélectionnez l'onglet Extension pour éditer le fichier d'extension.
- Ajoutez toutes les configurations d'extension nécessaires sous les nouvelles sections Configuration de service du destinataire de la demande et Configuration de service du générateur de la réponse.
- Enregistrez vos modifications et quittez l'éditeur.
Migration d'un noeud WebSphere Application Server antérieur à la version 8.5 vers une version 8.5 ou ultérieure
[7/31/12 14:48:34:323 CDT] 0000043f EditionHelper E Unexpected Error: ibmasyncrsp -- The Application's Directory in the Repository is EMPTY.
[7/31/12 14:48:34:339 CDT] 0000043f FfdcProvider W com.ibm.ws.ffdc.impl.FfdcProvider logIncident FFDC1003I: FFDC Incident emitted on c:\opt\WAS85\profiles\dmgr.xd61\logs\ffdc\dmgr_483a68e7_12.07.31_14.48.34.3396174315962980574983.txt com.ibm.ws.xd.appeditionmgr.EditModuleTargetsTaskHandler 104
[7/31/12 14:48:34:339 CDT] 0000043f EditModuleTar E ERROR_IN_EDIT_MODULE_TARGETS_TASK_HANDLER
Cette erreur s'affiche uniquement si des serveurs d'applications non-WebSphere sont fédérés dans la cellule. Ce message consigné concerne le fichier ibmasyncrsp.ear, qui est une application système interne utilisée par le moteur JAX-WS interne du serveur d'applications. Comme le moteur JAX-WS n'a aucune pertinence pour les serveurs d'applications non-WebSphere, une interruption de fonctionnalité a lieu. Le message peut être ignoré.