Exécution d'un client JAX-RPC de services Web non géré

WebSphere Application Server Version 9.0 et le client d'application pour WebSphere Application Server Version 9.0 fournissent une implémentation d'environnement d'exécution de client léger de services Web Java SE 6 (Java Platform, Standard Edition 6) conforme à la spécification JAX-RPC Java™ API for XML-based RPC) 1.1. Le client léger Thin Client for JAX-RPC avec WebSphere Application Server est un environnement client autonome Java SE 6 permettant d'exécuter des applications client de services Web JAX-RPC non gérées, dans un environnement non-WebSphere, pour appeler les services Web hébergés par le serveur d'applications.

Avant de commencer

Configurations prises en charge Configurations prises en charge: Le client léger Thin Client for JAX-RPC avec WebSphere Application Server peut être utilisé comme environnement d'exécution client autonome dans un environnement purement Java SE, ou dans un environnement OSGi. L'exécution du client léger Thin Client for JAX-RPC dans des environnements WebSphere Application Server ou WebSphere Application Client n'est pas prise en charge. Dans cette version du serveur d'applications, à l'exception du client léger d'administration, d'autres environnements d'exécution de client léger fournis avec le serveur d'applications peuvent également résider dans CLASSPATH et coexister avec Thin Client for JAX-RPC. sptcfg

Pour pouvoir configurer un environnement client non géré JAX-RPC, vous devez obtenir le fichier d'archive Java (JAR) de Thin Client for JAX-RPC. Pour obtenir Thin client for JAX-RPC, vous devez installer le serveur d'applications ou le client d'application.

Le fichier JAR de Thin Client for JAX-RPC, com.ibm.ws.webservices.thinclient_8.5.0.jar, se trouve dans le répertoire racine_serveur_app\runtimes. Reportez-vous au contrat de licence pour vérifier l'utilisation et le nombre de copies autorisées de Thin Client for JAX-RPC hors de l'environnement WebSphere.

Thin Client for JAX-RPC est pris en charge dans les environnements suivants :
  • IBM® Software Development Kits (SDK) version 6.0
  • Sun Java Development Kit (JDK) Version 6.0 proposé par IBM
  • Kits SDK non IBM Version 6.0 avec la restriction suivante :
    • Restriction Xerces sur les kits SDK non IBM

      Si vous utilisez un kit SDK non IBM, étant donné certaines dépendances avec l'implémentation Xerces, vous devez télécharger Xerces-J version 2.6.2 et définir ce dernier dans le chemin d'accès aux classes avant de tenter d'exécuter Thin Client for JAX-RPC.

    • Environnements d'exécution OSGi Equinox 3.6

Pourquoi et quand exécuter cette tâche

Configurations prises en charge Configurations prises en charge: Vous ne pouvez pas exécuter des clients de service Web qui appellent les services Web avant la fin du démarrage du serveur d'applications dans lequel le client est exécuté.sptcfg
Configurations prises en charge Configurations prises en charge: WS-Addressing n'est pas pris en charge pour les services Web JAX-RPC dans un environnement client non géré. Si vous devez utiliser WS-Addressing ou une norme de services Web basée sur WS-Addressing, telle que WS-Notification, utilisez à la place IBM Thin Client for Java API for XML-based Web Services (JAX-WS). Pour obtenir des informations sur la configuration et l'exécution de Thin Client for JAX-WS, reportez-vous à la documentation relative à Thin Client for JAX-WS.sptcfg

Procédure

  1. Configurez le chemin d'accès. Vous pouvez ajouter les répertoires Java bin à votre chemin d'accès en entrant :
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. Configurez le chemin d'accès aux classes (classpath).
    [Windows][z/OS]
    set CLASSPATH=.;<your_web_services_thin_client_install_directory>\com.ibm.ws.webservices.thinclient_8.5.0.jar;
    <your_application_jars>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<your_web_services_thin_client_install_directory>/com.ibm.ws.webservices.thinclient_8.5.0.jar:
    <your_application_jars>;$CLASSPATH
    • Si vous utilisez un kit SDK non IBM, obtenez un fichier xml-apis.jar Xerces et un fichier xercesImpl.jar à partir du site Web Xerces et configurez la définition de chemin d'accès aux classes.
      [Windows][z/OS]
      set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>
      \xercesImpl.jar;%CLASSPATH%
      [AIX][HP-UX][Solaris][Linux][IBM i]
      export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>
      \xercesImpl.jar:$CLASSPATH
  3. Configurez SSL pour le client.
    1. Ajoutez les propriétés système suivantes à la commande Java :
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props

      Vous pouvez obtenir le fichier ssl.client.props à partir de l'installation WebSphere Application Server et modifier le fichier pour l'adapter à votre environnement. Vous devez, au minimum, mettre à jour l'emplacement des fichiers de clés com.ibm.ssl.keyStore et com.ibm.ssl.trustStore dans le fichier ssl.client.props afin de le faire correspondre à l'emplacement de votre environnement cible.

      Par exemple, utilisez les paramètres de configuration SSL suivants lors de l'exécution de l'application avec un environnement d'exécution Java (JRE) Sun :
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStore=/home/user1/etc/key.jks
      
      com.ibm.ssl.trustStoreType=JKS
      com.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStore=/home/user1/etc/trust.jks

      Le fichier de clés et le fichier de clés certifiées doivent être créés à l'aide de l'outil de clé Java avant que l'application ne soit exécutée. La génération automatique de fichier de clés n'est pas prise en charge avec un environnement d'exécution Java (JRE) non IBM.

  4. Entrez la commande suivante pour exécuter votre application client :
    [Windows][z/OS]
    %JAVA_HOME%/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>

Résultats

Vous avez configuré un environnement d'exécution client JAX-RPC non géré qui permet d'appeler les services Web hébergés sur un serveur WebSphere Application Server.
Eviter les incidents Eviter les incidents: La commande suivante montre la manière d'afficher la version du client léger exécutée :
java -cp (wasHome)/runtimes/com.ibm.ws.webservices.thinclient_8.5.0.jar com.ibm.ws.webservices.Version
L'exemple suivant illustre la sortie de la commande :
IBM Web services build: cf021412.02
IBM Web services release: 8.5.5
Time stamp: 5/14/14 21:11:46
gotcha

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wbsthinclient
Nom du fichier : twbs_wbsthinclient.html