Ping e Echo - Configurar


Executando a Amostra
Executando a Amostra de Thin Client
Ativando a Mensagem e Segurança Confiável

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:


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.



Configurando a Amostra

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 Reconstruindo e Implementando o arquivo JaxWSServicesSamples.ear.

Executando a Amostra

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.

Executando a Amostra de 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:

  1. Inicie o servidor.
  2. Clique em Executar.

Executando a Amostra de Thin Cliente de Ping e Echo

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:

  1. Inicie o servidor.
  2. Abra um prompt de comandos.
  3. 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

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

Ativando Mensagem e Segurança Confiáveis

Scripts do Conjunto de Políticas
Aplicando QoS na Amostra de Thin Client de Ping e Echo

Scripts do Conjunto de Políticas

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.

  1. Abra um prompt de comandos utilizando o Menu Iniciar: Clique em Iniciar-> Executar. Digite cmd.
  2. 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
  3. Execute os scripts de mensagens confiáveis.
  4. (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:

    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

  5. 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
  6. 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.  

Aplicando QoS na Amostra de Thin Client de Ping e Echo

Para testar a Amostra de Ping e Echo do cliente thin com os conjuntos de políticas do QoS, siga essas orientações.
  1. Aplique a QoS (Quality of Service) que deseja testar nos aplicativos de Amostra, como indicado na seção Scripts do Conjunto de Políticas.
  2. Edite o script runSampleSei para seu sistema operacional.
  3. 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

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

  5. 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 $@

  6. Crie um diretório chamado META-INF a partir do diretório raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples.
  7. 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.
  8. 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.
  9. Altere o diretório atual para raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples e execute a Amostra.