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

Antes 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);