Stock Quote - Configuration et exécution


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

Il existe deux clients Stock Quote, une version J2SE (Java 2 Standard Edition) et une version J2EE (Java 2 Enterprise Edition) gérée par le conteneur. Si vous souhaitez tirer parti des services de conteneur de la plateforme J2EE, exécutez la version J2EE.

Configuration de l'exemple

Pour terminer la configuration de cet exemple, déployez l'application exemple de services Web JAX-RPC sur le serveur. Si le modèle d'application n'est pas déjà déployé, reportez-vous aux instructions de régénération et de déploiement du fichier WebServicesSamples.ear.

Exécution de l'exemple

Vérifiez que le serveur est lancé avant d'exécuter les clients.

L'exemple Stock Quote est constitué de deux clients et d'un bean enterprise unique déployé sur le serveur. L'un des clients est un client J2SE simple. Vous le trouverez dans un programme appelé GetQuote. L'autre est un client d'application J2EE (Java 2 Enterprise Edition). Vous le trouverez dans le fichier GetQuoteClient.jar.

Exécution de la version J2SE simple du client Stock Quote
Exécution de la version J2EE du client d'application Stock Quote

Clients Stock Quote

Les clients Stock Quote interrogent le bean enterprise StockQuote pour obtenir le cours d'actions à partir du Web. Le service Web StockQuote peut renvoyer une valeur fixe ou le cours réel d'une action si une connexion Internet est disponible. Le premier argument soumis aux clients Stock Quote est l'URL du point de contact cible, qui spécifie le service Web à utiliser. Le deuxième argument de GetQuote est le symbole du titre dont on souhaite obtenir le cours. Vous pouvez utiliser une valeur XXX pour obtenir le prix fixe sans utiliser de connexion Internet.

Exécution de la version J2SE simple du client Stock Quote

La version J2SE du client Stock Quote n'est pas gérée par le conteneur.

Pour des instructions plus générales sur l'appel d'un client WebSphere J2SE, reportez-vous à la rubrique relative au développement d'un code de client d'application partiel dans le Centre de documentation.

Pour exécuter la version J2SE simple du client de Stock Quote à partir d'un serveur d'applications WebSphere, procédez comme suit, en tenant compte de votre système d'exploitation :

  1. Démarrez le serveur.
  2. Ouvrez une invite de commande.
  3. Entrez les commandes suivantes :

    Sur les plateformes Windows :

    cd racine_profil\bin
    setupCmdLine
    cd racine_installation\bin
    setupCmdLine

    Sur les plateformes Linux, UNIX et z/OS :

    cd racine_profil/bin
    . ./setupCmdLine.sh
    cd racine_installation/bin
    . ./setupCmdLine.sh

    Sur les plateformes iSeries :

    cd racine_profil/bin
    . ./setupCmdLine
    cd racine_installation/bin
    . ./setupCmdLine

  4. Entrez la commande suivante :

    Sur les plateformes Windows :

    "%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <symbole>

    Sur les plateformes Linux, UNIX et z/OS :

    "$JAVA_HOME/bin/java" $WAS_LOGGING -classpath "$CLASSPATH:$WAS_CLASSPATH:$WAS_HOME/samples/lib/WebServicesSamples/simpleClients.jar:$WAS_HOME/runtimes/com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <symbole>

    Sur les plateformes iSeries :

    java $JAVA_PARM -classpath "$CLASSPATH:$WAS_CLASSPATH:$WAS_HOME/samples/lib/WebServicesSamples/simpleClients.jar:$WAS_HOME/runtimes/com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote <URL> <symbole>

    où :
    <URL> est l'adresse du noeud final du servicehttp://<nom_hôte>:<port>/StockQuote/services/xmltoday-delayed-quotes<nom_hôte> est le nom de l'hôte (par défaut localhost) et <port> est le numéro de port (par défaut : 9080).
    <symbole> est un symbole boursier.

    Le résultat suivant s'affiche lorsque l'exécution du client Stock Quote sous Windows aboutit :

    C:\>"%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote http://localhost:9080/StockQuote/services/xmltoday-delayed-quotes XXX
    XXX: 55.25
     
    C:\>"%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.stock.GetQuote http://localhost:9080/StockQuote/services/xmltoday-delayed-quotes DELL
    DELL: 23.67
     
    

Exécution de la version client d'application J2EE Stock Quote

L'application J2EE GetQuoteClient.jar est une version gérée par conteneur du client Stock Quote.

Dans les étapes ci-après, la variable racine_installation symbolise la racine d'installation de WebSphere.

Pour exécuter la version client d'application J2EE du service Stock Quote à partir d'un serveur d'applications WebSphere, procédez comme suit, en tenant compte de votre système d'exploitation :

  1. Démarrez le serveur.
  2. Ouvrez une invite de commande.
  3. Entrez les commandes suivantes :

    Sur les plateformes Windows :

    cd <racine_profil>\bin
    setupCmdLine

    Sur les plateformes Linux, UNIX et z/OS :

    cd <racine_profil>/bin
    . ./setupCmdLine.sh

    Sur les plateformes iSeries :

    cd <racine_profil>/bin
    . ./setupCmdLine

    <racine_profil> représente le répertoire d'installation du profil.
  4. Accédez au répertoire racine_installation/samples/lib/WebServicesSamples
    où :
    racine_installation correspond à la racine d'installation de WebSphere Application Server ou à la racine d'installation du profil si l'exemple est régénéré.
  5. Entrez la commande suivante :

    Sur les plateformes Windows :

    <racine_installation>\bin\launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <symbole>

    Sur les plateformes Linux, UNIX et z/OS :

    <racine_installation>/bin/launchClient.sh ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <symbole>

    Sur les plateformes iSeries :

    <racine_installation>/bin/launchClient ApplicationClients.ear -CCjar=GetQuoteClient.jar [<URL>] <symbole>

    où :
    <URL> est l'adresse du noeud final du servicehttp://<nom_hôte>:<port>/StockQuote/services/xmltoday-delayed-quotes<nom_hôte> est le nom de l'hôte (par défaut localhost) et <port> est le numéro de port (par défaut : 9080).
    <symbole> est un symbole boursier.

    L'exemple suivant montre deux exécutions réussies du client Stock Quote version application J2EE :

    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=GetQuoteClient.jar IBM
    IBM WebSphere Application Server, Release 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Traitement des arguments de la ligne de commande.
    WSCL0013I: Initialisation de l'environnement J2EE Application Client.
    [3/29/06 14:55:22:359 CST] 0000000a  W UOW=null source=com.ibm.ws.ssl.config.SSLConfig org=IBM prod=WebSphere component=Application Server thread=[P=720609:O=0:CT]
              CWPKI0041W: Au moins un magasin de clés utilise le mot de passe par défaut.
    WSCL0035I: L'initialisation de l'environnement pour J2EE Application Client est terminée.
    WSCL0014I: Appel de la classe com.ibm.websphere.samples.webservices.stockClient.GetQuote du client d'application
    IBM: 83.36
     
    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=GetQuoteClient.jar XXX
    IBM WebSphere Application Server, Release 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Traitement des arguments de la ligne de commande.
    WSCL0013I: Initialisation de l'environnement J2EE Application Client.
    [3/29/06 15:00:04:062 CST] 0000000a  W UOW=null source=com.ibm.ws.ssl.config.SSLConfig org=IBM prod=WebSphere component=Application Server thread=[P=2171:O=0:CT]
              CWPKI0041W: Au moins un magasin de clés utilise le mot de passe par défaut.
    WSCL0035I: L'initialisation de l'environnement pour J2EE Application Client est terminée.
    WSCL0014I: Appel de la classe com.ibm.websphere.samples.webservices.stockClient.GetQuote du client d'application
    XXX: 55.25
      

Pour plus d'informations sur le client et le traitement opéré par l'application, vous pouvez vous reporter aux notes techniques relatives à l'exemple Stock Quote ainsi qu'à son code source Java.