Implementación de un cliente utilizando el cliente JAX-RS 2.0 de servicios web RESTful no gestionado
WebSphere Application Server proporciona un tiempo de ejecución de cliente de servicios web RESTful Java™ SE 8 (Java Platform, Standard Edition 8) ligero para que los desarrolladores de aplicaciones puedan crear fácil y rápidamente aplicaciones de cliente JAX-RS. El cliente ligero para JAX-RS con WebSphere Application Server es un entorno de cliente autónomo Java SE 8 que permite ejecutar aplicaciones de cliente de servicios web JAX-RS RESTful no gestionados en un entorno no WebSphere para invocar servicios web RESTful JAX-RS alojados en el servidor de aplicaciones.
Antes de empezar
Supported configurations: Puede utilizar el cliente ligero para JAX-RS con WebSphere Application Server como un tiempo de ejecución de cliente autónomo en un entorno Java SE puro. El cliente ligero para JAX-RS que se ejecuta en entornos WebSphere Application Server o WebSphere Application Client no está soportado. En esta versión del servidor de aplicaciones, otros tiempos de ejecución del cliente ligero proporcionados con el servidor de aplicaciones también pueden residir en la CLASSPATH y coexistir con el cliente ligero para JAX-RS.sptcfgAntes de configurar un entorno de ejecución de cliente JAX-RS no gestionado, obtenga el archivo JAR (archivador Java) del cliente ligero para JAX-WS. Para obtener el cliente ligero para JAX-RS, instale WebSphere Application Server Versión 9.0 o el cliente de aplicaciones para WebSphere Application Server Versión 9.0. El cliente ligero para el archivo JAR de JAX-WS, com.ibm.jaxrs2.0.thinclient_9.0.jar, se encuentra en el directorio raíz_servidor_aplicaciones\runtimes.
Copie el archivo del cliente ligero para JAX-RS, com.ibm.jaxrs2.0.thinclient_9.0.jar, en otras máquinas para crear un entorno de cliente ligero que permita la comunicación con el producto. Las copias del cliente ligero para JAX-RS están sujetas a los mismos términos y condiciones del acuerdo de licencia para el producto WebSphere donde se ha obtenido el cliente ligero para JAX-RS. Consulte los acuerdos de licencia para un uso correcto y otras limitaciones.
El cliente ligero para JAX-RS funciona con IBM® Software Development Kits (SDK) Versión 8.0 y posteriores. El cliente ligero para JAX-RS también recibe soporte en los kits de desarrollo de software no IBM que son de la versión 8.0 y posteriores.
Acerca de esta tarea
Procedimiento
Qué hacer a continuación
- Utilice las propiedades del cliente ligero com.ibm.ws.jaxrs.client.connection.timeout y com.ibm.ws.jaxrs.client.receive.timeout para establecer los valores de tiempo de espera.
- com.ibm.ws.jaxrs.client.connection.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.connection.timeout", "1000"); Client c = cb.build(); - com.ibm.ws.jaxrs.client.receive.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.receive.timeout", "1000"); Client c = cb.build();
Consejo: El valor de la propiedad de tiempo de espera es en milisegundos y el tipo debe ser long o entero. Si el tipo del valor no es válido, aparece el siguiente mensaje:CWTRS0700E: El valor de tiempo de espera {0} que ha especificado en la propiedad com.ibm.ws.jaxrs.client.receive.timeout en el lado del cliente JAX-RS no es válido. El valor se establece en 30000 de forma predeterminada. {3} - com.ibm.ws.jaxrs.client.connection.timeout
- Utilice las siguientes propiedades del cliente ligero para dar soporte al proxy del cliente ligero:
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.proxy.host", "hostname"); cb.property("com.ibm.ws.jaxrs.client.proxy.port", "8888";); cb.property("com.ibm.ws.jaxrs.client.proxy.type", "HTTP"); Client c = cb.build();- com.ibm.ws.jaxrs.client.proxy.host
- com.ibm.ws.jaxrs.client.proxy.portConsejo: El tipo del valor del puerto del servidor proxy debe ser un entero. El valor predeterminado es 80. Si el tipo de valor no es válido, aparece el siguiente mensaje:
CWTRS0701E: El valor del puerto del servidor proxy {0} que ha especificado en la propiedad com.ibm.ws.jaxrs.client.proxy.port en el lado del cliente JAX-RS no es válido. El valor se establece en 80 de forma predeterminada. {3} - com.ibm.ws.jaxrs.client.proxy.typeConsejo: El valor del tipo de servidor proxy debe ser HTTP o SOCKS. El valor predeterminado es HTTP. Si el tipo del servidor proxy no es válido, aparece el siguiente mensaje:
CWTRS0702E: El valor del tipo de servidor proxy {0} que ha especificado en la propiedad property com.ibm.ws.jaxrs.client.proxy.type en el lado del cliente JAX-RS no es válido. El valor se establece en HTTP de forma predeterminada. {3}
- Configure el cliente JAX-RS 2.0 para validar la información de autenticación de señales LTPA.
- Proteger cliente ligero JAX-RS mediante SSL.
- Utilice la propiedad com.ibm.ws.jaxrs.client.disableCNCheck del cliente ligero para inhabilitar la comprobación de nombres comunes
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.disableCNCheck", true);
![[Windows]](../images/windows.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
Task topic