Ejecución de un cliente JAX-RPC de servicios web no gestionado

WebSphere Application Server Versión 9.0 y Application Client para WebSphere Application Server Versión 9.0 proporcionan una implementación ligera de ejecución de cliente de servicios web de Java Platform, Standard Edition 6 (Java SE 6) que se basa en la especificación Java™ API for XML-based RPC (JAX-RPC) 1.1. El cliente ligero para JAX-RPC con WebSphere Application Server es un entorno de cliente Java SE 6 autónomo que permite ejecutar aplicaciones cliente de servicios web JAX-RPC no gestionadas en un entorno no WebSphere para invocar servicios web alojados por el servidor de aplicaciones.

Antes de empezar

Supported configurations Supported configurations: Puede utilizar el cliente ligero para JAX-RPC con WebSphere Application Server como ejecución de cliente autónomo un entorno Java SE puro o en un entorno OSGi. El cliente ligero para JAX-RPC no se soporta cuando se ejecuta en entornos de WebSphere Application Server o WebSphere Application Client. En esta versión del servidor de aplicaciones, salvo el cliente ligero de administración, otros tiempos de ejecución de cliente ligero proporcionados con el servidor de aplicaciones también pueden residir en la CLASSPATH y coexistir con el cliente ligero de JAX-RPC. sptcfg

Para poder configurar un entorno de cliente no gestionado JAX-RPC, tendrá que obtener el archivo JAR (Java archive) del cliente ligero para JAX-RPC. Para obtener el cliente ligero para JAX-RPC, debe instalar el servidor de aplicaciones o el cliente de aplicación.

El archivo JAR del cliente ligero para JAX-RPC, com.ibm.ws.webservices.thinclient_8.5.0.jar, se encuentra en el directorio raíz_servidor_aplicaciones\runtimes. Consulte los acuerdos de licencia para garantizar el uso correcto y para las limitaciones en las copias del cliente ligero para JAX-RPC fuera del entorno de WebSphere.

El cliente ligero para JAX-RPC recibe soporte en los entornos siguientes:
  • IBM® Software Development Kits (SDK) Versión 6.0
  • Sun Java Development Kit (JDK) versión 6.0 proporcionados por IBM
  • Los SDK Versión 6.0 no de IBM con esta limitación:
    • Limitación de Xerces en SDK no IBM

      Si utiliza SDK no IBM, debido a las dependencias con la implementación de Xerces, tendrá que bajar Xerces-J versión 2.6.2 y establecerlo en la classpath antes de ejecutar el cliente ligero para JAX-RPC.

    • Entornos de ejecución OSGi de Equinox 3.6

Acerca de esta tarea

Supported configurations Supported configurations: No se admite la ejecución de clientes de servicios web que invocan los servicios web antes de que el servidor de aplicaciones, en el que el cliente se ejecuta, haya terminado de iniciarse.sptcfg
Supported configurations Supported configurations: WS-Addressing no está soportado para servicios web JAX-RPC en un entorno de cliente no gestionado. Si necesita utilizar WS-Addressing, o bien un estándar de servicio web que se basa en WS-Addressing como, por ejemplo, WS-Notification, debe utilizar en cambio el cliente ligero para la API JAX-WS (API de Java para servicios web XML). Si desea obtener información sobre cómo configurar y ejecutar el cliente ligero para JAX-WS, consulte la documentación Cliente ligero para JAX-WS.sptcfg

Procedimiento

  1. Configure la vía de acceso. Puede añadir los directorios Java bin a la vía de acceso escribiendo:
    [Windows][z/OS]
    set PATH=<directori_bin_JDK>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<directorio_bin_JDK>:$PATH
  2. Configure la classpath.
    [Windows][z/OS]
    set CLASSPATH=.;<directorio_instalación_cliente_ligero_servicios_web>\com.ibm.ws.webservices.thinclient_8.5.0.jar;
    <jars_de_aplicación>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<el_directorio_instalación_cliente_ligero_servicios_web>/com.ibm.ws.webservices.thinclient_8.5.0.jar:
    <jars_de_aplicación>;$CLASSPATH
    • Si utiliza un SDK no IBM, obtenga archivos xml-apis.jar y xercesImpl.jar Xerces desde el sitio web de Xerces y configure la definición de la vía de acceso de clases.
      [Windows][z/OS]
      set CLASSPATH=.;<el_directorio_instalación_Xerces>\xml-apis.jar;<el_directorio_instalación_Xerces>
      \xercesImpl.jar;%CLASSPATH%
      [AIX][HP-UX][Solaris][Linux][IBM i]
      export CLASSPATH=.:<directorio_instalación_Xerces>/xml-apis.jar:<directorio_instalación_Xerces>
      \xercesImpl.jar:$CLASSPATH
  3. Configure SSL para el cliente.
    1. Añada las siguientes propiedades del sistema al mandato Java:
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props

      Puede obtener el archivo ssl.client.props de la instalación de WebSphere Application Server y modificarlo para adecuarlo a su entorno. Debe, al menos, actualizar la ubicación de los archivos de claves com.ibm.ssl.keyStore y com.ibm.ssl.trustStore del archivo ssl.client.props para que coincidan con la ubicación del entorno de destino.

      Por ejemplo, utilice estos valores de configuración SSL cuando ejecute la aplicación con JRE de 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

      El archivo del almacén de claves y el archivo del almacén de confianza se deben crear utilizando el programa de utilidad keytool de Java antes de ejecutar la aplicación. No se da soporte a la generación automática de archivos de claves con un JRE de un producto que no es de IBM.

  4. Especifique el mandato siguiente para ejecutar la aplicación cliente:
    [Windows][z/OS]
    %JAVA_HOME%/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <aplicación_cliente>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <aplicación_cliente>

Resultados

Ha configurado un entorno de ejecución de cliente JAX-RPC no gestionado que se puede utilizar para invocar servicios web alojados en un WebSphere Application Server.
Avoid trouble Avoid trouble: El mandato siguiente muestra cómo visualizar la versión del cliente ligero que está ejecutando:
java -cp (wasHome)/runtimes/com.ibm.ws.webservices.thinclient_8.5.0.jar com.ibm.ws.webservices.Version
El ejemplo siguiente muestra la salida del mandato:
IBM Web services build: cf021412.02
IBM Web services release: 8.5.5
Time stamp: 5/14/14 21:11:46
gotcha

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wbsthinclient
File name: twbs_wbsthinclient.html