Implementando um cliente usando o cliente JAX-RS 2.0 de serviços da web RESTful não gerenciados

O WebSphere Application Server fornece um tempo de execução de cliente de serviços da web thin Java™ Platform, Standard Edition 8 (Java SE 8) RESTful para permitir que os desenvolvedores de aplicativos criem de maneira rápida e fácil aplicativos clientes JAX-RS. O Thin Client para JAX-RS com WebSphere Application Server é um ambiente de cliente Java SE 8 independente que possibilita a execução de aplicativos de clientes de serviços da web JAX-RS RESTful não gerenciados em um ambiente não WebSphere a chamar serviços da web JAX-RS RESTful que são hospedados pelo servidor de aplicativos.

Antes de Iniciar

Configurações suportadas Configurações suportadas: É possível usar o Thin Client para JAX-RS com WebSphere Application Server como um ambiente de tempo de execução de cliente independente em um ambiente Java SE. O Thin Client for JAX-RS em execução dentro de ambientes WebSphere Application Server ou WebSphere Application Client não é suportado. Nesta versão do servidor de aplicativos, outros tempos de execução do Thin Client fornecidos com o servidor de aplicativos também podem residir no CLASSPATH e coexistir no Thin Client para JAX-RS.sptcfg

Antes que você configure um ambiente de execução do cliente não gerenciado JAX-RS, obtenha o arquivo Java archive (JAR) do Thin Client para JAX-RS. Para obter o Thin Client for JAX-RS, instale WebSphere Application Server Versão 9.0 ou o Aplicativo Cliente para WebSphere Application Server Versão 9.0. O arquivo JAR do Thin Client para JAX-RS, com.ibm.jaxrs2.0.jar, está localizado no diretório app_server_root\runtimes.

Copie o arquivo com.ibm.jaxrs2.0.thinclient_9.0.jar do Thin Client for JAX-RS para outras máquinas, para criar um ambiente do cliente leve que permita a comunicação com o produto. As cópias do Thin Client para JAX-RS estão sujeitas aos mesmos termos e condições do contrato de licença do produto WebSphere em que você obteve o Thin Client para JAX-RS. Consulte os contratos de licença para o uso correto e outras limitações.

O Thin Client para JAX-RS funciona com o IBM® Software Development Kits (SDKs) Versão 8.0 e superior. O Thin Client for JAX-RS também é suportado em kits de desenvolvimento de software não IBM com a V8.0 e posterior.

Sobre Esta Tarefa

Configure um ambiente Thin Client para JAX-RS, concluindo as seguintes etapas.

Procedimento

  1. Configure o caminho. Insira o seguinte comando para incluir os diretórios Java bin mo seu caminho:
    [Windows][z/OS]
    set PATH=<seu_diretório_bin_JDK>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. Configure o caminho da classe. Inclua o arquivo JAR Thin Client para JAX-RS na definição do caminho de classe; por exemplo:
    [Windows][z/OS]
    set CLASSPATH=.;<your_jax-rs_thin_client_install_directory>\com.ibm.jaxrs2.0.thinclient_9.0.jar;
    <your_application_jars>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<your_JAX-RS_thin_client_install_directory>/com.ibm.jaxrs2.0.thinclient_9.0.jar:
    <your_application_jars>;$CLASSPATH
  3. Digite o seguinte comando para executar o aplicativo cliente:
    [Windows][z/OS]
    %JAVA_HOME%/bin/java <your_client_application>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java <your_client_application>

O que Fazer Depois

  • Use as propriedades do cliente com.ibm.ws.jaxrs.client.connection.timeout e com.ibm.ws.jaxrs.client.receive.timeout para configurar os valores de tempo de execução.
    • 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();
    Dica: O valor da propriedade de tempo limite é em milissegundos, e o tipo deve ser longo ou integral. Se o tipo do valor for inválido, a seguinte mensagem será exibida:
    CWTRS0700E: O valor de tempo limite {0} que você especificou na propriedade com.ibm.ws.jaxrs.client.receive.timeout no lado do Cliente JAX-RS é inválido. O valor está configurado como o padrão 30000. {3}
  • Use as propriedades do cliente thin a seguir para obter o suporte proxy de cliente thin:
    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
      Dica: O tipo do valor de porta do servidor proxy deve ser integral. O valor padrão é 80. Se o tipo de valor for inválido, a mensagem a seguir será exibida:
      CWTRS0701E: O valor de porta do servidor proxy {0} que você especificou na propriedade com.ibm.ws.jaxrs.client.proxy.port no lado do Cliente JAX-RS é inválido. O valor está configurado como o padrão 80. {3}
    • com.ibm.ws.jaxrs.client.proxy.type
      Dica: O valor do tipo do servidor proxy deve ser HTTP ou SOCKS. O valor padrão é HTTP . Se o tipo do servidor proxy for inválido, a seguinte mensagem será exibida:
      CWTRS0702E: O valor de tipo do servidor proxy {0} que você especificou na propriedade com.ibm.ws.jaxrs.client.proxy.type no lado do Cliente JAX-RS é inválido. O valor está configurado como o padrão HTTP. {3}
  • Configure o cliente JAX-RS 2.0 para validar as informações de autenticação do token LTPA.
  • Thin client JAX-RS seguro usando SSL.
  • Use a propriedade do cliente thin com.ibm.ws.jaxrs.client.disableCNCheck para desativar a verificação de nome comum.
    ClientBuilder cb = ClientBuilder.newBuilder();
    cb.property("com.ibm.ws.jaxrs.client.disableCNCheck", true);

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs2
Nome do arquivo: twbs_jaxrs2.0_imp_thinclient_runningthinc.html