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: 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: 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: 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
- Configure la vía de acceso. Puede añadir los directorios Java bin
a la vía de acceso escribiendo:
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set PATH=<directori_bin_JDK>;%PATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
export PATH=<directorio_bin_JDK>:$PATH
- Configure la classpath.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set CLASSPATH=.;<directorio_instalación_cliente_ligero_servicios_web>\com.ibm.ws.webservices.thinclient_8.5.0.jar;
<jars_de_aplicación>;%CLASSPATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
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]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set CLASSPATH=.;<el_directorio_instalación_Xerces>\xml-apis.jar;<el_directorio_instalación_Xerces>
\xercesImpl.jar;%CLASSPATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
export CLASSPATH=.:<directorio_instalación_Xerces>/xml-apis.jar:<directorio_instalación_Xerces>
\xercesImpl.jar:$CLASSPATH
- Configure SSL para el cliente.
- 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.
- Especifique el mandato siguiente para ejecutar la aplicación cliente:
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%JAVA_HOME%/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <aplicación_cliente>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$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: 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