Vous pouvez utiliser une tâche Ant à la place des assistants de services Web afin de générer un service Web
Java™ pour l'environnement d'exécution IBM® WebSphere JAX-WS. Les tâches Ant prennent en charge le développement de services Web ascendants et descendants.
Avant de commencer
Avant de créer un service Web, vous devez satisfaire les exigences préalables suivantes :
- Créez un serveur et un projet Web pour votre service Web : Création d'un serveur WebSphere compatible avec JAX-WS
- Importez la tâche Ant et les fichiers de propriétés dans votre espace de travail : Importation de fichiers Ant pour votre service Web JAX-WS
- Personnalisez les fichiers de propriétés Ant pour votre service Web :
- Créez ou importez des fichiers dans un dossier du projet Web que vous avez créé, selon le type de service Web que vous voulez créer :
- Pour créer un service ascendant, créez ou importez un bean dans le dossier src.
- Pour créer un service descendant, localisez ou créez le fichier WSDL ou importez-en un dans le projet que vous avez créé.
Pourquoi et quand exécuter cette tâche
Pour créer le service Web, modifiez le fichier de propriétés Ant du service. Le nom du fichier de propriétés Ant dépend du type de service Web que vous créez :
- Si vous créez un service ascendant, le nom du fichier de propriétés Ant est was_jaxws_bujava.properties.
- Si vous créez un service descendant, le nom du fichier de propriétés Ant est was_jaxws_tdjava.properties.
- Si vous créez un client, le nom du fichier de propriétés Ant est was_jaxws_client.properties.
Procédure
Exécutez votre tâche Ant : - Pour exécuter la tâche dans l'espace de travail du produit :
- Cliquez avec le bouton droit de la souris sur le fichier XML de génération de services Web et sélectionnez .
- Dans la boîte de dialogue, cliquez sur l'onglet JRE et sélectionnez Exécuter dans le même JRE que l'espace de travail.
- Cliquez sur Appliquer, puis sur Exécuter.
Une fois votre service Web généré, la console ou la ligne de commande affiche le message
La génération a abouti.
Résultats
Lorsque votre service Web est généré, les fichiers suivants sont créés en fonction des options que vous avez sélectionnées et du type de service Web généré :
- Descendant : l'interface de noeud final de service. L'interface de noeud final de service est la représentation Java annotée du fichier WSDL pour le service Web. Cette interface permet d'implémenter des noeuds finaux JavaBeans ou de créer des instances de client Dynamic Proxy. Références de types de données dans l'interface de noeud final de service.
- Ascendant : la classe déléguée. Il s'agit d'un encapsuleur qui contient toutes les méthodes du bean et l'annotation JAX-WS que l'environnement d'exécution reconnaît en tant que service Web. Si vous possédez déjà un bean comportant l'annotation @javax.jws.WebService avant d'exécuter la tâche Ant, ce bean est utilisé tel quel et aucune nouvelle annotation n'est ajoutée.
- Classes d'encapsuleur Demande/Réponse/Exception.
Conseil : Le fichier
wsant.bat est installé dans le répertoire
bin du produit.
Sur certains systèmes, ce répertoire peut être accessible en lecture seule. Dans ce cas, la tâche Ant ne peut pas créer la sortie et la création du service Web échoue. Vous pouvez remédier au problème de deux façons :
- Définissez votre variable PATH de sorte qu'elle désigne le dossier bin, placez-vous dans un répertoire pour lequel vous disposez des droits d'accès en écriture, et exécutez le script à partir de ce répertoire.
- Copiez le fichier wsant.bat dans un répertoire inscriptible.