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 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.sptcfg

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

Configuración de un entorno de cliente ligero para JAX-RS realizando los pasos siguientes.

Procedimiento

  1. Configure la vía de acceso. Escriba el mandato siguiente para añadir los directorios Java bin a la vía de acceso:
    [Windows][z/OS]
    set
    PATH=<el_directorio_bin_JDK>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export
    PATH=<el_directorio_bin_JDK>:$PATH
  2. Configure la vía de acceso de clases. Añada el archivo JAR del cliente ligero para JAX-RS en la definición de la vía de acceso de clases; por ejemplo:
    [Windows][z/OS]
    set
    CLASSPATH=.;<el_directorio_instalación_cliente_ligero_jax-rs>\com.ibm.jaxrs2.0.thinclient_9.0.jar;
    <ars_de_aplicación>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export
    CLASSPATH=.:<el_directorio_instalación_cliente_ligero_JAX-RS>/com.ibm.jaxrs2.0.thinclient_9.0.jar:
    <jars_de_aplicación>;$CLASSPATH
  3. Especifique el mandato siguiente para ejecutar la aplicación cliente:
    [Windows][z/OS]
    %JAVA_HOME%/bin/java
    <la_aplicación_cliente>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java <la_aplicación_cliente>

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}
  • 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.port
      Consejo: 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.type
      Consejo: 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);

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_jaxrs2
File name: twbs_jaxrs2.0_imp_thinclient_runningthinc.html