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: É 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: 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: 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
- Configure o caminho. É possível incluir o diretórios Java bin em seu caminho, digitando:
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set PATH=<your_JDK_bin_directory>;%PATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
export PATH=<your_JDK_bin_directory>:$PATH
- Configure o caminho de classe.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set CLASSPATH=.;<your_web_services_thin_client_install_directory>\com.ibm.ws.webservices.thinclient_8.5.0.jar;
<your_application_jars>;%CLASSPATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
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]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>
\xercesImpl.jar;%CLASSPATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>
\xercesImpl.jar:$CLASSPATH
- Configure o SSL para o cliente.
- 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.
- Digite o seguinte comando para executar o aplicativo cliente:
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%JAVA_HOME%/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <seu_aplicativo_cliente>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$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: 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