Serviços da Web do JAX-WS |
Ping e Echo -
Configurar
|
 |
As amostras de Ping e Echo são dois serviços da Web simples do JAX-WS.
A amostra de Ping demonstra uma operação unidirecional. Um valor de cadeia simples é transmitido ao serviço. A operação do cliente é concluída depois que o serviço é contactado. Há dois terminais na
Amostra. Um terminal usa SOAP 1.1 e outro terminal usado SOAP 1.2.
A amostra de Echo demonstra uma operação bidirecional. Um valor de cadeia simples é transmitido ao serviço. O serviço acrescenta um valor de cadeia identificadora e retorna esse valor novamente ao cliente. Há dois terminais na amostra. Um terminal usa SOAP 1.1 e outro terminal usado SOAP 1.2. A amostra de Echo também demonstra os modelos de programação síncrono e assíncrono, bem como o comportamento da rede síncrona e assíncrona:
- Síncrono: O cliente aguarda a resposta do
serviço.
- Assíncrono com comunicação síncrona: O cliente de serviço não aguarda a resposta do serviço. Um método de retorno de chamada é fornecido. Quando o serviço responde, o método de retorno de chamada é chamado para manipular a cadeia de resposta. No entanto, a comunicação na rede ainda é síncrona.
- Assíncrono com comunicação assíncrona: O cliente de serviço não aguarda a resposta do serviço. Um método de retorno de chamada é fornecido. Quando o serviço responde, o método de retorno de chamada é chamado para manipular a cadeia de resposta. O serviço contata o cliente em um canal diferente do canal usado pelo cliente para contatar o serviço.
Terminais de Serviço de Amostra
URI |
Descrição |
http://localhost:9080/WSSampleSei/PingService
|
Amostra de serviço ping usando SOAP 1.1
|
http://localhost:9080/WSSampleSei/PingService12
|
Amostra de serviço ping usando SOAP 1.2 |
http://localhost:9080/WSSampleSei/EchoService
|
Amostra de serviço echo usando SOAP 1.1 |
http://localhost:9080/WSSampleSei/EchoService12
|
Amostra de serviço echo usando SOAP 1.2 |
A porta 9080 é o valor padrão, mas o número da porta será
diferente se você instalar em um perfil diferente do perfil
AppSrv01.
Para concluir a configuração da amostra de Ping e Echo, implemente o aplicativo de amostra dos serviços da Web do Jax-WS no servidor. Se o
aplicativo de amostra ainda não estiver implementado, consulte as
instruções em .
Antes de começar, você deve verificar se o servidor de aplicativos está em execução antes de executar os clientes.
A amostra de Ping e Echo inclui dois serviços, Ping e Echo.
A amostra de Ping demonstra uma transação de serviço bidirecional. A origem
dessa amostra está localizada no diretório
raiz_do_perfil/samples/src/JaxWSServicesSamples/SampleClientSei.
A amostra de Echo demonstra uma transação de serviço bidirecional. A origem
dessa amostra está localizada no diretório
raiz_do_perfil/samples/src/JaxWSServicesSamples/SampleClientSei.
Para executar o servlet de cliente do Ping e Echo de um WebSphere Application Server, execute as seguintes etapas:
- Inicie o servidor.
- Clique em Executar.
A amostra de thin client de Ping e Echo é semelhante ao servlet do cliente de Ping
e Echo. Esta amostra acessa os mesmos beans de serviços da Web do Ping e Echo,
mas utiliza um arquivo JAR (arquivo de Java) que requer
o Thin Client para JAX-WS com arquivo JAR do WebSphere Application
no caminho de classe.
Você pode pode encontrar o arquivo WSSampleClientSei.jar
no diretório samples/lib/JaxWSServicesSamples.
A amostra de thin client de Ping e Echo cria um proxy JAX-WS para o serviço da Web do Ping ou
Echo com base nos parâmetros fornecidos. O proxy então contata o terminal de serviço com a mensagem. A Amostra de Echo
aguarda a resposta.
Nas seguintes etapas, a variável, raiz_do_servidor_de_aplicativos,
refere-se à raiz da instalação do servidor de aplicativos.
Para executar o thin client de Ping e Echo a partir do WebSphere
Application Server, execute as seguintes etapas, com base em seu
sistema operacional:
- Inicie o servidor.
- Abra um prompt de comandos.
- Vá para o diretório JaxWSServicesSamples.
Em sistemas operacionais Windows:
cd
raiz_do_servidor_de_aplicativos\samples\bin\JaxWSServicesSamples
Em sistemas operacionais como AIX, Linux e z/OS:
cd
raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples
Em sistemas operacionais iSeries:
cd
raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples
- Execute a amostra de thin client de Ping e Echo.
Em sistemas operacionais Windows:
runSampleSei.bat -h nome_do_host -p
porta -f urlSuffix -m mensagem_de_teste -s
serviço -t tempo_limite -w asyncwire -c
contagem -1 -2
Em sistemas operacionais como AIX, Linux e z/OS:
./runSampleSei.sh -h nome_do_host -p
porta -f urlSuffix -m mensagem_de_teste -s
serviço -t tempo_limite -w asyncwire -c
contagem -1 -2
Em sistemas operacionais iSeries:
./runSampleSei -h nome_do_host -p porta
-f urlsuffix -m mensagem_de_teste -s serviço
-t tempo_limite -w asyncwire -c contagem -1
-2
Os parâmetros são:
-h <nome_do_host> é o nome do host. O padrão
é localhost.
-p <porta> é o número da porta. O valor padrão
é 9080.
-f <sufixo_da_URL> o contexto do terminal em serviço.
O padrão é /WSSampleSei/EchoService.
-m <message> o texto da mensagem.
O padrão é hello. Se a mensagem contiver caracteres em branco, use aspas entre a mensagem.
-c contagem especifica o número de transações para executar. O padrão é 1.
-1 especifica o uso de SOAP 1.1. O padrão é SOAP 1.1.
-2 especifica o uso de SOAP 1.2.
O seguinte exemplo ilustra uma execução bem-sucedida do cliente Ping
e Echo no sistema operacional Windows:
runSampleSei.bat -p 9081 Aug 8, 2007 7:01:00 PM com.ibm.ws.ssl.config.SSLConfigManager INFO: ssl.disable.url.hostname.verification.CWPKI0027I >> CLIENT: SEI Async to http://localhost:9081/WSSampleSei/EchoService [WAShttpAsyncResponseListener] listening on port 4733 >> CLIENT: SEI Async invocation complete. >> CLIENT: SEI Async response is: JAX-WS==>>HELLO
|
Para saber mais sobre como o cliente de amostra e o aplicativo trabalham, consulte as notas técnicas do Ping e Echo ou visualize o código-fonte Java.
Para obter mais informações sobre os clientes de serviços da Web, consulte a documentação sobre como desenvolver e implementar clientes de serviços da Web na
Biblioteca Centro de Informações do WebSphere Application Server.
Os conjuntos de políticas são
utilizados para ativar a QoS (Quality of Service) como ReliableMessaging e
SecureConversation. Os conjuntos de políticas que são anexados a um aplicativo definem a qualidade de serviço daquele aplicativo. Um conjunto de scripts é fornecido para ativar os conjuntos de políticas para WS-ReliableMessaging (WS-RM), WS-SecureConversation (WS-SC) e WS-I Reliable Secure Profile (RSP). RSP é uma composição de WS-RM e WS-SC. Esses scripts são fornecidos como exemplos. Também é possível ativar os conjuntos de Políticas utilizando o
console de administração. Esses scripts são criados para trabalhar apenas com aplicativos de amostra. As seguintes tabelas descrevem os scripts de amostra do conjunto de políticas.
Scripts para o sistema operacional Windows
Nome do Arquivo |
Descrição |
enableRMQoS.bat |
Ativa WS-ReliableMessaging Versão 1.1 |
enableRM1QoS.bat |
Ativa WS-ReliableMessaging Versão 1.0 |
enableSCQoS.bat |
Ativa WS-SecureConversation |
enableRSPQoS.bat |
Ativa WS-ReliableMessaging e WS-SecureConversation |
enableWSAQoS.bat |
Ativa WS-Addressing |
disableRMQoS.bat |
Desativa WS-ReliableMessaging Versão 1.1 |
disableRM1QoS.bat |
Desativa WS-ReliableMessaging Versão 1.0 |
disableSCQoS.bat |
Desativa WS-SecureConversation |
disableRSPQoS.bat |
Desativa WS-ReliableMessaging e WS-SecureConversation |
disableWSAQoS.bat |
Desativa WS-Addressing |
Scripts para sistemas operacionais como AIX, Linux e z/OS
Nome do Arquivo |
Descrição |
enableRMQoS.sh |
Ativa WS-ReliableMessaging Versão 1.1 |
enableRM1QoS.sh |
Ativa WS-ReliableMessaging Versão 1.0 |
enableSCQoS.sh |
Ativa WS-SecureConversation |
enableRSPQoS.sh |
Ativa WS-ReliableMessaging e WS-SecureConversation |
enableWSAQoS.sh |
Ativa WS-Addressing |
disableRMQoS.sh |
Desativa WS-ReliableMessaging Versão 1.1 |
disableRM1QoS.sh |
Desativa WS-ReliableMessaging Versão 1.0 |
disableSCQoS.sh |
Desativa WS-SecureConversation |
disableRSPQoS.sh |
Desativa WS-ReliableMessaging e WS-SecureConversation |
disableWSAQoS.sh |
Desativa WS-Addressing |
Scripts para o sistema operacional i5/OS
Nome do Arquivo |
Descrição |
enableRMQoS |
Ativa WS-ReliableMessaging Versão 1.1 |
enableRM1QoS |
Ativa WS-ReliableMessaging Versão 1.0 |
enableSCQoS |
Ativa WS-SecureConversation |
enableRSPQoS |
Ativa WS-ReliableMessaging e WS-SecureConversation |
enableWSAQoS |
Ativa WS-Addressing |
disableRMQoS |
Desativa WS-ReliableMessaging Versão 1.1 |
disableRM1QoS |
Desativa WS-ReliableMessaging Versão 1.0 |
disableSCQoS |
Desativa WS-SecureConversation |
disableRSPQoS |
Desativa WS-ReliableMessaging e WS-SecureConversation |
disableWSAQoS |
Desativa WS-Addressing |
Utilize as seguintes etapas para executar os scripts do sistema de mensagens confiáveis
no sistema operacional Windows. Você pode executar todos os scripts de forma semelhante, com base em seu sistema operacional.
- Abra um prompt de comandos utilizando o Menu Iniciar:
Clique em Iniciar-> Executar. Digite cmd.
- Vá para o diretório
raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples. Por exemplo: cd C:/Program
Files/IBM/WebSphere/AppServer/samples/bin/JaxWSServiceSamples
- Execute os scripts de mensagens confiáveis.
- Para executar a ativação dos scripts de mensagens confiáveis, digite o comando: enableRMQos.bat
- Para executar a desativação dos scripts de mensagens confiáveis, digite o comando: disableRMQos.bat
- (Opcional) Especifique seu perfil, célula, nó ou nome de servidor quando executar scripts de segurança e mensagens confiáveis. A ativação ou desativação de scripts para mensagens e segurança confiáveis tem quatro parâmetros opcionais:
- perfil: perfil do servidor de aplicativos
- célula: célula do servidor de aplicativos
- nó: nó do servidor de aplicativos
- servidor: nome do servidor de aplicativos
O seguinte exemplo demonstra como executar a ativação do script WS-ReliableMessaging com os parâmetros profile, cell e node opcionais especificados:
enableRMQoS.bat AppSrv02 MyServerNode01Cell MyServerNode01
O seguinte exemplo demonstra como executar a desativação do script WS-ReliableMessaging com os parâmetros profile, cell e node opcionais especificados:
disableRMQoS.bat AppSrv02
MyServerNode01Cell MyServerNode01
- Configure parâmetros adicionais na linha de comandos, conforme necessário. Se
o servidor tiver segurança administrativa ativada, você deve fornecer o
ID do usuário e a senha ou o script falhará. Por
exemplo:
./enableRMQoS.sh -user myuserid -password
mypassword
- Verifique se os aplicativos de amostra foram iniciados corretamente. Se você receber uma mensagem de aviso, os aplicativos de amostra poderão ter sido iniciados incorretamente. Utilize o console
administrativo para parar e reiniciar os aplicativos de Amostra.
Para testar a Amostra de Ping e Echo do cliente thin com os conjuntos de políticas do QoS, siga essas orientações.
- Aplique a QoS (Quality of Service) que deseja testar nos aplicativos de Amostra,
como indicado na seção Scripts do Conjunto de Políticas.
- Edite o script runSampleSei para seu sistema operacional.
- Para incluir as políticas WS-I RSP e SecureConversation, inclua a seguinte instrução para incluir o caminho ao arquivo de login do JAAS (Java Authentication and Authorization):
Em sistemas operacionais Windows:
set
JAASLOGIN=-Djava.security.auth.login.config=<raiz_do_perfil>/properties/wsjaas_client.conf
Em sistemas operacionais como AIX, Linux e z/OS:
export
JAASLOGIN=-Djava.security.auth.login.config=<raiz_do_perfil>/properties/wsjaas_client.conf
raiz_do_perfil indica o diretório
do servidor no qual o perfil está localizado, por exemplo:
set
JAASLOGIN=-Djava.security.auth.login.config=C:/IBM/WebSphere/profiles/AppSrv02/properties/wsjaas_client.conf
- Altere a instrução de caminho da classe.
Em sistemas operacionais Windows:
set
CLASSPATH=%THIN_JAR%;./WSSampleClientSei.jar;.
Em sistemas operacionais como AIX, Linux e z/OS:
export
CLASSPATH=${THIN_JAR}:./WSSampleClientSei.jar:.
Nota: O ponto final (.) está incluído no fim da instrução do caminho de classe.
O ponto é incluído para que o código de carregamento do conjunto de políticas localize o diretório META-INF. Não omita o ponto.
- Inclua <JAASLOGIN> e
-DUSER_INSTALL_ROOT="<raiz_do_perfil>" no comando Java.
Em sistemas operacionais Windows:
java %JAASLOGIN%
-DUSER_INSTALL_ROOT= "<raiz_do_perfil>" -cp
"%CLASSPATH%" com.ibm.was.wssample.sei.cli.SampleClient %*
Em sistemas operacionais como AIX, Linux e z/OS:
java ${JAASLOGIN}
-DUSER_INSTALL_ROOT="<raiz_do_perfil>" -cp
"${CLASSPATH} " com.ibm.was.wssample.sei.cli.SampleClient
$@
- Crie um diretório chamado META-INF a partir do diretório
raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples.
- Copie o diretório PolicySets do diretório
raiz_do_perfil/config/cells/CELL_NAME/ para o diretório
raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples/META-INF.
- Copie o subdiretório de ligações e o arquivo
clientPolicyAttachment.xml do diretório
raiz_do_perfil/config/cells/ CELL_NAME/applications/JaxWSServicesSamples.ear/deployments/JaxWSServicesSamples/META-INF para o
diretório raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples/META-INF.
Copie o subdiretório de ligações inteiro e seu conteúdo, por
exemplo, SecureConversationClientBinding ou
RAMP_client_default_bindings.
- Altere o diretório atual para raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples e execute a Amostra.