运行非受管 Web Service JAX-RPC 客户机

WebSphere® Application Server V9.0 和 Application Client for WebSphere Application Server V9.0 提供了基于 Java™ API for XML-based RPC (JAX-RPC) 1.1 规范的瘦 Java Platform, Standard Edition 6 (Java SE 6) Web Service 客户机运行时实现。带有 WebSphere Application Server 的 JAX-RPC 瘦客户机是独立的 Java SE 6 客户机环境,使您可以在非 WebSphere 环境中运行非受管 JAX-RPC Web Service 客户机应用程序以调用由应用程序服务器主管的 Web Service。

开始之前

支持的配置 支持的配置: 可以将带有 WebSphere Application Server 的 JAX-RPC 瘦客户机用作纯净 Java SE 环境或 OSGi 环境内的独立客户机运行时。在 WebSphere Application Server 或 WebSphere Application Client 环境中运行时,JAX-RPC 瘦客户机不受支持。 在此版本的应用程序服务器中,除了管理瘦客户机外,随应用程序服务器提供的其他瘦客户机运行时都可以位于 CLASSPATH 中并可与 JAX-RPC 瘦客户机共存。sptcfg

设置 JAX-RPC 非受管客户机环境前,您将需要获取 JAX-RPC 瘦客户机 Java 归档 (JAR) 文件。要获取 JAX-RPC 瘦客户机,必须安装应用程序服务器或应用程序客户机。

JAX-RPC 瘦客户机 JAR 文件 com.ibm.ws.webservices.thinclient_8.5.0.jar 位于 app_server_root\runtimes 目录中。 请参阅许可协议以确保使用正确并了解 WebSphere 环境外部 JAX-RPC 瘦客户机副本的局限性。

JAX-RPC 瘦客户机在以下环境中受支持:
  • IBM® 软件开发包 (SDK) V6.0
  • IBM 提供的 Sun Java Development Kit (JDK) V6.0
  • 具有以下限制的非 IBM SDK V6.0:
    • 非 IBM SDK 上的 Xerces 局限性

      如果因为依赖于 Xerces 实现而使用非 IBM SDK,那么需要下载 Xerces-J V2.6.2 并在类路径中设置,然后才尝试运行 JAX-RPC 瘦客户机。

    • Equinox 3.6 OSGi 运行时环境

关于此任务

支持的配置 支持的配置: 不支持在应用程序服务器(用于运行客户机)完成启动之前运行 Web Service 客户机(用于调用 WebService)。sptcfg
支持的配置 支持的配置: 对于非受管客户机环境中的 JAX-RPC Web Service 不支持 WS-Addressing。如果需要使用 WS-Addressing,或依赖 WS-Addressing 的 Web Service 标准(例如 WS-Notification),那么必须改为使用 Java API for XML-based Web Services (JAX-WS)的瘦客户机。要了解如何设置和运行 JAX-WS 瘦客户机,请参阅“JAX-WS 瘦客户机”文档。sptcfg

过程

  1. 配置路径。 可以通过输入以下内容,将 Java bin 目录添加到您的路径:
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. 配置类路径。
    [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
    • 如果使用的是非 IBM SDK,请从 Xerces Web 站点获取 Xerces xml-apis.jarxercesImpl.jar,然后配置类路径定义。
      [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. 配置客户机的 SSL。
    1. 将以下系统属性添加到 Java 命令中:
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props

      您可以从 WebSphere Application Server 安装中获取 ssl.client.props 文件并修改该文件以适合您的环境。必须至少将 ssl.client.props 文件中的 com.ibm.ssl.keyStorecom.ibm.ssl.trustStore 密钥文件的位置更改为目标环境的匹配位置。

      例如,运行应用程序和 Sun JRE 时,请使用以下 SSL 配置设置:
      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

      在运行应用程序之前,必须使用 Java keytool 实用程序来创建密钥库文件和信任库文件。不支持使用非 IBM 产品的 JRE 来生成自动密钥文件。

  4. 输入以下命令以运行客户机应用程序:
    [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>

结果

您已设置了非受管 JAX-RPC 客户机运行时环境,该运行时环境可用于调用在 WebSphere Application Server 上主管的 Web Service。
避免故障 避免故障: 以下命令说明如何显示所运行的瘦客户机的版本:
java -cp (wasHome)/runtimes/com.ibm.ws.webservices.thinclient_8.5.0.jar com.ibm.ws.webservices.Version
以下示例说明命令的输出:
IBM Web services build: cf021412.02
IBM Web services release: 8.5.5
Time stamp: 5/14/14 21:11:46
gotcha

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wbsthinclient
文件名:twbs_wbsthinclient.html