Executando um Cliente JAX-RPC de Serviços da Web Não Gerenciado

O WebSphere Application Server Versão 9.0 e o Aplicativo Cliente para WebSphere Application Server Versão 9.0 fornecem uma implementação de tempo de execução de cliente de serviços da Web Java Platform, Standard Edition 6 (Java SE 6) que se baseia na especificaçãoJava™ API for XML-based RPC (JAX-RPC) 1.1. O Thin Client para JAX-RPC com WebSphere Application Server é um ambiente de cliente Java SE 6 independente que possibilita a execução de aplicativos de cliente de serviços da Web JAX-WS não gerenciados em um ambiente não WebSphere para chamar serviços da Web 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-RPC com WebSphere Application Server como um tempo de execução de cliente independente em um ambiente Java SE puro, ou dentro de um ambiente OSGi. O Thin Client para JAX-RPC não é suportado executando dentro dos ambientes WebSphere Application Server ou WebSphere Application Client. Nesta versão do servidor de aplicativos, com a exceção do Administration Thin Client, outros tempos de execução do Thin Client fornecidos com o servidor de aplicativos também podem residir no CLASSPATH e coexistir com o Thin Client para JAX-RPC. sptcfg

Para que seja possível configurar um ambiente de cliente não gerenciado do JAX-RPC, você precisará obter o arquivo JAR (Java Archive) do Thin Client para JAX-RPC. Para obter o Thin Client para JAX-RPC, você deve instalar o servidor de aplicativos ou o aplicativo cliente.

O arquivo JAR do Thin Client para JAX-RPC, com.ibm.ws.webservices.thinclient_8.5.0.jar, está localizado no diretório app_server_root\runtimes. Consulte os contratos de licença para assegurar o uso correto e para limitações sobre as cópias do Thin Client para JAX-RPC fora do ambiente WebSphere.

O Thin Client para JAX-RPC é suportado nos seguintes ambientes:
  • IBM® Software Development Kits (SDKs) Versão 6.0
  • Sun Java Development Kit (JDK) Versão 6.0 fornecido pela IBM
  • SDKs não IBM Versão 6.0 com esta limitação:
    • Limitação de Xerces em SDKs não-IBM

      Se você estiver utilizando um SDK não IBM, devido a dependências na implementação Xerces, será necessário fazer download do Xerces-J versão 2.6.2 e configurá-lo no caminho de classe antes de tentar executar o Thin Client para JAX-RPC.

    • Ambientes de tempo de execução Equinox 3.6 OSGi

Sobre Esta Tarefa

Configurações suportadas Configurações suportadas: A execução de clientes de serviços da web que chamam serviços da web antes que o servidor de aplicativos no qual o cliente esteja em execução tenha concluído a inicialização, não é um cenário suportado.sptcfg
Configurações suportadas Configurações suportadas: O WS-Addressing não é suportado para serviços da Web JAX-RPC em um ambiente de cliente não gerenciado. Se precisar usar o WS-Addressing, ou um padrão de serviço da Web que conte com o WS-Addressing, como o WS-Notification, você deve usar o Thin Client para Java API for XML-based Web Services (JAX-WS) no lugar. Para saber como configurar e executar o Thin Client para JAX-WS, consulte a documentação do Thin Client para JAX-WS.sptcfg

Procedimento

  1. Configure o caminho. É possível incluir o diretórios Java bin em seu caminho, digitando:
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. Configure o caminho de classe.
    [Windows][z/OS]
    set CLASSPATH=.;<your_web_services_thin_client_install_directory>\com.ibm.ws.webservices.thinclient_8.5.0.jar;
    <your_application_jars>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<your_web_services_thin_client_install_directory>/com.ibm.ws.webservices.thinclient_8.5.0.jar:
    <your_application_jars>;$CLASSPATH
    • Se estiver usando um SDK não IBM, obtenha um arquivo xml-apis.jar e arquivo xercesImpl.jar do Xerces a partir do Web site do Xerces e configure a definição de caminho de classe.
      [Windows][z/OS]
      set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>
      \xercesImpl.jar;%CLASSPATH%
      [AIX][HP-UX][Solaris][Linux][IBM i]
      export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>
      \xercesImpl.jar:$CLASSPATH
  3. Configure o SSL para o cliente.
    1. Inclua as seguintes propriedades do sistema no comando Java:
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props

      É possível obter o arquivo ssl.client.props da instalação do WebSphere Application Server e modificar o arquivo para ajustar-se ao seu ambiente. Você deverá, no mínimo, atualizar o local dos arquivos de chave com.ibm.ssl.keyStore e com.ibm.ssl.trustStore no arquivo ssl.client.props para o local de correspondência de seu ambiente de destino.

      Por exemplo, utilize estas definições de configuração de SSL ao executar o aplicativo com um Sun JRE:
      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

      O arquivo de armazenamento de chaves e armazenamento de confiança deve ser criado usando o utilitário Java keytool antes da execução do aplicativo. A geração de arquivo de chaves automática não é suportada com um JRE de produto não IBM.

  4. Digite o seguinte comando para executar o aplicativo cliente:
    [Windows][z/OS]
    %JAVA_HOME%/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <seu_aplicativo_cliente>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>

Resultados

Você configurou um ambiente de tempo de execução de cliente JAX-RPC não gerenciado que pode ser usado para chamar os serviços da web hospedados em um WebSphere Application Server.
Evitar Problemas Evitar Problemas: O comando a seguir ilustra como exibir a versão do thin client que está sendo executado:
java -cp (wasHome)/runtimes/com.ibm.ws.webservices.thinclient_8.5.0.jar com.ibm.ws.webservices.Version
O exemplo a seguir ilustra a saída do comando:
IBM Web services build: cf021412.02
IBM Web services release: 8.5.5
Time stamp: 5/14/14 21:11:46
gotcha

Í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_wbsthinclient
Nome do arquivo: twbs_wbsthinclient.html