Recommandation : Envisager la migration vers JAX-WS
Si vous apportez déjà des modifications à vos services web JAX-RPC dans le cadre de vos efforts de migration ou de modernisation, nous vous recommandons vivement d'évaluer le passage à JAX-WS ( Java API for XML Web Services).

JAX-WS est le successeur de JAX-RPC et offre plusieurs avantages :

La migration vers JAX-WS permet de réduire la dette technique future et d'aligner votre application sur les normes actuelles des services web ( Java ).

Pour obtenir des conseils sur la migration de JAX-RPC vers JAX-WS, reportez-vous à la section Scénarios de migration des services web : JAX-RPC vers JAX-WS et JAXB.

Ne pas utiliser le descripteur de déploiement de service web JBoss
Cette règle marque tout fichier webservices.xml existant afin de détecter la présence d'un fichier descripteur de déploiement de services Web J2EE pour JBoss.

Pour générer des services web JAX-RPC basés sur JBoss Java Platform, Enterprise Edition ( Java EE ) des descripteurs de déploiement de services web, le correctif automatisé créera un script Ant qui utilise les tâches appropriées IBM Ant. Il s'agit d'analyser les descripteurs de déploiement des services web et de configurer le script pour générer les artefacts nécessaires et de configurer le script Ant pour qu'il génère les artefacts requis.


Conditions de déclenchement de la règle :
Cette règle détecte la présence des services Web JAX-RPC en fonction des critères suivants :
a. Présence du fichier descripteur de déploiement des services web J2EE webservices.xml
b. L'analyseur binaire détecte que le fichier généré IBM Ant n'existe pas encore dans le dossier racine du projet.

Propriétés de la règle :
Vous devez indiquer les valeurs requises pour les propriétés de la règle. Pour changer les valeurs des propriétés de cette règle, sélectionnez la règle dans la fenêtre Configurations Software Analyzer. Renseignez ensuite les zones de l'onglet Propriétés. Les propriétés pour cette règle sont les suivantes :
  • Nom du script Ant généré :
    Il s'agit du nom du nouveau script Ant qui sera généré doit être un nom de fichier valide.  La valeur ne doit pas inclure de barres obliques avant ou arrière.  Le fichier généré sera dans le dossier racine du projet.
    Valeur par défaut : build-ibm-ws.xml

  • Nom du dossier de génération :
    Il s'agit du nom du dossier dans lequel les artefacts générés sont placés. la valeur ne doit pas inclure de barres obliques avant ou arrière.  Le dossier de génération se trouve dans le dossier racine du projet.
    Valeur par défaut : ibm-ws-gen

Chemin d'accès aux classes Ant :
Le chemin de la classe de fourmis est calculé à partir du projet Eclipse.  Il est important de vérifier que tous les éléments nécessaires à la se trouvent sur le chemin de classe Eclipse.

Services JAX-RPC définis dans le fichier webservices.xml
Un script Ant est généré sur la base des données et du type des services définis dans le fichier webservices.xml afin de reproduire le service JAX-RPC.

  • Cibles Ant générées :
    Le script Ant généré contient des cibles pour générer le fichier WSDL et le service JAX-RPC.
    La cible de génération WSDL n'est générée que si vous ne pouvez pas localiser le fichier WSDL tel qu'il est défini dans l'élément <wsdl-file>.
    Le tagret de génération du WSDL (s'il a été créé) porte le nom suivant le nom : genWSDL_ssss où ssss est le nom du service tel que défini dans l'élément dans l'élément <webservice-description-name>.
    Les cibles de génération de service portent le nom, genService_pppp, où pppp est le nom du port tel que défini par l'élément <port-component-name>.

Tâches Ant d'IBM de WebSphere Application Server
IBM WebSphere Application Server inclut des tâches Ant telles que java2wsdl et wsdl2java pour générer les artefacts nécessaires pour les services JAX-RPC.  Le script Ant généré utilise ces tâches pour générer le service. Pour plus d'informations sur ces tâches, consultez la documentation WebSphere Application Server.

Exécution du script Ant
Une fois que le correctif automatisé a généré le script Ant, passez-le en revue et ajoutez toutes les personnalisations nécessaires. Reportez-vous à la documentation de WebSphere Application Server pour obtenir des conseils sur la personnalisation des tâches IBM Ant tâches. Vous devez exécuter le script à l'aide des outils Ant fournis par IBM, qui sont inclus dans IBM WebSphere Application Server   Le script IBM Ant peut être exécuté à partir de :
  • WAS_HOME\bin\ws_ant.bat sur Windows(R)
  • WAS_HOME\bin\ws_ant.sh sur UNIX(R)
Exemple : c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

Lorsque les cibles Ant sont exécutées, les artefacts produits résident dans le dossier de génération dans le dossier de génération.  Vous pouvez inspecter le code généré, les générés, les descripteurs de déploiement, puis ajouter ces artefacts à leurs modules.