Service MTOM - Configurer et exécuter


Configuration de l'exemple
Exécution de l'exemple

Il existe deux clients de service MTOM (Message Transmission Optimization Mechanism), une version ligne de commande qui utilise le fichier d'archive Java (JAR) du client léger pour JAX-WS avec WebSphere Application Server, et une version servlet qui utilise un fichier JSP (JavaServer pages) pour accéder au service MTOM.

Exemple de noeuds finaux de service
URI Description
http://localhost:9080/WSSampleMTOM/MtomSampleService
Exemple de service MTOM utilisant SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Exemple de service MTOM utilisant SOAP 1.2

Le port 9080 est la valeur par défaut, mais le numéro de port sera différent si vous installez un profil autre que le profil AppSrv01.



Configuration de l'exemple

Pour effectuer la configuration de cet exemple, déployez l'exemple d'application de services Web JAX-WS sur le serveur. Si l'exemple d'application n'est pas déjà déployé, reportez-vous aux instructions Régénération et déploiement du fichier JaxWSServicesSamples.ear.

Exécution de l'exemple

Avant de commencer, vous devez vérifier que le serveur d'applications fonctionne avant d'exécuter les clients.

L'exemple de service MTOM se compose de deux clients et d'un seul bean enterprise déployé sur le serveur. Le premier client est une version ligne de commande qui utilise le client léger pour JAX-WS avec le fichier JAR WebSphere Application Server. L'autre client est une version servlet qui utilise un fichier JSP pour accéder au service MTOM.

Exécution du servlet de service MTOM
Exécution de l'application client léger de service MTOM

Clients de service MTOM

Les clients de service MTOM envoient un fichier codé avec MTOM vers le noeud final de service spécifié. Par défaut, l'hôte est défini sur l'hôte local, mais vous pouvez modifier cette valeur. Un nom de fichier est nécessaire et aucune valeur par défaut n'est fourni. Dans cet exemple, le service reçoit le fichier envoyé par le client, puis le fichier est retourné au client dans le modèle de programmation dispatch ou proxy selon ce qui est spécifié.

Exécution du client de servlet de service MTOM

Le client de servlet de service MTOM n'est pas géré par conteneur.

Pour davantage d'informations sur l'appel d'un client servlet dans un environnement de client léger pour JAX-WS, voir la documentation sur l'exécution d'un client JAX-WS de services Web non gérés dans la bibliothèque du Centre de documentation de WebSphere Application Server.

Pour exécuter un client de service de servlet MTOM simple à partir de WebSphere Application Server, procédez ce qui suit :

  1. Démarrez le serveur.
  2. Cliquez sur Exécuter.

Exécution de l'application client léger de service MTOM

Le fichier WSSampleMTOMClient.jar est une version ligne de commande de l'application client léger de service MTOM.

Dans les étapes suivantes, la variable racine_serveur_applications fait référence au répertoire racine d'installation du serveur d'applications.

Pour exécuter l'application client léger de service MTOM à partir de WebSphere Application Server, procédez comme suit en fonction de votre système d'exploitation :

  1. Démarrez le serveur.
  2. Ouvrez une invite de commande.
  3. Allez au répertoire JaxWSServicesSamples.

    Sur les systèmes d'exploitation Windows :

    cd racine_serveur_applications\samples\bin\JaxWSServicesSamples

    Sur des systèmes d'exploitation tels qu'AIX, Linux et z/OS :

    cd racine_serveur_applications/samples/bin/JaxWSServicesSamples

    Sur les systèmes d'exploitation iSeries :

    cd racine_serveur_applications/samples/bin/JaxWSServicesSamples

  4. Exécuter l'exemple de service MTOM.

    Sur les systèmes d'exploitation Windows :

    runSampleMtom.bat -i nomfichier -h nomhôte -p port -f urlSuffix -d -x -1 -2

    Sur des systèmes d'exploitation tels qu'AIX, Linux et z/OS :

    ./runSampleMtom.sh -i nomfichier -h nomhôte -p port -f urlSuffix -d -x -1 -2

    Sur les systèmes d'exploitation iSeries :

    ./runSampleMtom -i nomfichier -h nomhôte -p port -f urlsuffix -d -x -1 -2

    Les paramètres sont :
    -i <nomfichier> est le nom du fichier à envoyer. Il s'agit d'un paramètre obligatoire et aucune valeur par défaut n'est fournie.
    -h <nomhôte> est le nom de l'hôte. Le nom d'hôte par défaut est hôte_local.
    -p <port> est le numéro de port. La valeur par défaut 9080.
    -f <urlsuffix> correspond au contexte du noeud final de service. La valeur par défaut est /WSSampleMTOM/MtomSampleService.
    -d spécifie l'utilisation du modèle dispatch uniquement.
    -x spécifie l'utilisation du modèle proxy uniquement.
    -1 spécifie l'utilisation de SOAP 1.1. Il s'agit de la valeur par défaut.
    -2 spécifie l'utilisation de SOAP 1.2.

    L'exemple suivant illustre une exécution réussie de l'application de client léger de service MTOM sur le système d'exploitation Windows :

    runSampleMtom.bat -i c:\SYSLEVEL.IBM -p 9081
    >>---------------------------------------
    >>Test Dispatch MTOM
    >>MTOM chargement de données de : 'file:/c:/SYSLEVEL.IBM'
    Aug 10, 2007 12:11:49 PM com.ibm.ws.ssl.config.SSLConfigManager
    INFO: ssl.disable.url.hostname.verification.CWPKI0027I
    >>MTOM Appel de Dispatch avec une charge binaire
    >>MTOM Réponse reçue
    >>MTOM écriture de l'image retournée vers dispatch_response.gif
    >>MTOM Dispatch exécuté
    >>---------------------------------------
    >>MTOM test Proxy
    >>MTOM Appel de proxy avec une charge binaire
    >>MTOM Réponse reçue
    >>MTOM Ecriture de l'image retournée vers proxy_response.gif
    e>>MTOM Proxy exécuté

Pour en savoir davantage sur la façon dont le client et l'application fonctionnent, reportez-vous aux notes techniques du service MTOM ou consultez le code source Java.