< Anterior | Próximo >

Lição 3: Criando o cliente de serviço da web

Nesta lição, você aprenderá como criar um cliente para o serviço da web.

Antes de Iniciar

Antes de iniciar, você deve concluir a Lição 2: Criando o serviço da web .

Sobre Esta Tarefa

Clientes de serviço da web são criados a partir de um documento WSDL que descreve onde o serviço da web é implementado e quais operações este serviço fornece. É possível usar o arquivo WSDL estático gerado pelo assistente de serviço da web, ou ao criar serviços da web JAX-WS, você pode usar o arquivo WSDL dinâmico gerado pelo tempo de execução com base nas informações que ele reúne a partir das anotações incluídas nas classes Java. Para esse tutorial o arquivo WSDL dinâmico será utilizado.

Visualizar o WSDL Gerado Dinamicamente

Sobre Esta Tarefa

Se seu servidor for iniciado, você deverá ser capaz de testar rapidamente seu bean anotado para assegurar que ele seja um serviço da web e gerar o arquivo WSDL dinâmico.

Procedimento

  1. Determine a porta que seu serviço da web está usando, se você ainda não sabe. Para isso:
    1. Ative o Console Administrativo do WebSphere Application Server clicando com o botão direito em seu servidor na visualização Servidores e selecionando Administração > Executar Console Administrativo.
    2. Expanda Servidores > Tipos de Servidor e selecione WebSphere Application Servers.
    3. Selecione o nome do seu servidor na lista. Por padrão, esse é o server1.
    4. Na guia Configuração, procure o cabeçalho Comunicações e expanda Portas.
    5. A porta utilizada é WC_defaulthost. Esse tutorial utilizará o número da porta de exemplo 9081. Substitua esse número com sua própria porta em qualquer das seguintes etapas.
  2. Ative o navegador da Web clicando nesse ícone: Ícone do navegador da Web como aparece na barra de ferramentas principal
  3. Digite a seguinte URL no navegador: http://localhost:9081/jwsAddressBook/AddressBookService e pressione retornar. Uma página é exibida declarando que este é um serviço da web.
  4. Inclua ?wsdl ao final da URL na etapa 3 e pressione retornar novamente: http://localhost:9081/jwsAddressBook/AddressBookService?wsdl. O arquivo WSDL gerado dinamicamente será exibido. Esse arquivo pode ser usado da mesma maneira que você usaria o arquivo WSDL estático que o assistente de serviço da web gerou, contanto que o servidor esteja em execução.

Criar o cliente de serviço da web da lista de endereços e testar JSP

Procedimento

  1. Clique em Arquivo > Novo > Outro. Selecione Serviços da Web para exibir os diversos assistentes de serviço da web. Selecione o assistente do Cliente de Serviço da Web. Clique em Avançar.
  2. Página de Serviços da Web: Digite a URL do arquivo WSDL gerado dinamicamente que você descobriu na seção anterior no campo Definição de Serviço: http://localhost:9081/jwsAddressBook/AddressBookService?wsdl.
    1. Selecione os estágios de desenvolvimento de cliente de serviço da web que você deseja concluir usando a régua de controle. Para esse tutorial, selecione Testar Cliente. Isso gerará todos os códigos do cliente necessários e fornecerá várias opções de teste para o cliente.
    2. Servidor: Certifique-se de que o WebSphere v7.0 e o servidor estejam selecionados.
    3. Tempo de Execução do Serviço da Web: Assegure que o tempo de execução do JAX-WS esteja selecionado.
    4. Projeto do Cliente: Selecione o projeto do cliente criado na lição 1: jwsAddressBookClient.
    5. Projeto do EAR do Cliente: Selecione o jwsAddressBookEAR. Para serviços da web JAX-WS, o servidor e projetos do cliente podem compartilhar o mesmo EAR.
    6. Monitore o serviço da Web: Isto enviará o tráfego do serviço da web por meio do Monitor TCP/IP, o que permite observar o tráfego SOAP gerado pelo serviço da web e testar esse tráfego para conformidade com WS-I. O Monitor TCP/IP não é capaz de monitorar os serviços da web protegidos com o conjunto de políticas RSP, portanto, não selecione esta opção.
    Clique em Avançar.
  3. Página de Configuração do Cliente de Serviço da Web do WebSphere JAX-WS:
    • Pasta de Saída: Aceite o local padrão onde as classes Java do cliente serão geradas.
    • Pacote de destino: O assistente de cliente de serviços da web gera um número de arquivos Java a partir do WSDL especificado. Por padrão, ele criará um nome de pacote baseado no espaço de nomes especificado no arquivo WSDL. Para substituir esse comportamento padrão, você pode especificar seu próprio nome de pacote para o espaço de nomes no arquivo WSDL. Aceite os padrões para esse tutorial.
    • Gerar cliente móvel: Selecionar essa caixa de seleção permitirá que você mova seu código do cliente de serviço da web de uma máquina para outra ou de uma instância do WebSphere Application Server para outra. Isso não é necessário para esse tutorial.
    • Ativar chamada assíncrona para cliente gerado: Se você selecionar para ativar um cliente assíncrono, para cada método no serviço da web, dois métodos adicionais serão criados. Esses são os métodos de sondagem e retorno de chamada que permitem que o cliente funcione assincronamente. Selecione-a.
    • Especificar arquivos de ligação do JAX-WS ou JAXB: Se você tiver criado arquivos de ligação customizada JAX-WS ou JAXB, selecione essa caixa de seleção para usá-los para criar este serviço da web. Não selecione isso para o tutorial.
    • Customizar nome da classe do proxy cliente: Você pode aceitar o nome de proxy padrão ou digitar seu próprio nome. Não selecione isso para o tutorial.
    • Gerar biblioteca de esquema: Selecionar isso executará o Esquema JAX-WS para o compilador Java para gerar um esquema. Não selecione essa opção para o tutorial.
    • Gerar descritor de implementação do serviço da web: Para a implementação de serviços da web JAX-WS, informações são geradas dinamicamente pelo tempo de execução; descritores de implementação estáticos não são mais necessários. Selecionar essa opção irá gerá-los. Esse tutorial não requer descritores de implementação.
    • Versão do código JAX-WS a ser gerada: Iniciando com o WebSphere Application Server v7.0, você pode gerar o código de conformidade com o JAX-WS 2.1. Selecione 2.1 para esse tutorial.
    Clique em Next.
  4. Página de Teste do Cliente de Serviços da Web:
    • Testar o proxy gerado: Selecione isso para testar a funcionalidade do cliente.
    • Selecione o recurso de teste. Você pode testar o proxy gerado no Universal Test Client ou no Web Service Explorer ou pode gerar JSPs de amostra do JAX-WS 2.0. Para esse tutorial, selecione as JSPs do JAX-WS.
    • Pasta: Você pode selecionar a pasta onde a JSP estará localizada. Aceite o padrão.
    • Métodos: Selecionar os métodos a serem expostos. Os métodos assíncronos devem ser listados também. Assegure que todos os métodos estejam selecionados.
    • Executar Teste no Servidor: isso iniciará o servidor para você automaticamente.
    Clique em Finish (Concluir). A JSP de amostra será aberta em uma janela do navegador.

Testar o cliente de serviço da web usando JSPs de amostra

Sobre Esta Tarefa

As etapas a seguir testarão o serviço da web de forma síncrona.

Procedimento

  1. O TestClient.jsp deve ser ativado automaticamente se você selecionou as opções corretas. Se ele não for exibido, selecione jwsAddressBookClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp, clique com o botão direito do mouse e selecione Executar Como > Executar no Servidor
  2. Para testar o serviço sincronicamente, selecione o método saveAddress e digite as informações no campo de nome. Todos os outros campos são opcionais. Clique em Chamar.
  3. Selecione o método findAddress, digite o nome utilizado durante o método saveAddress e clique em Chamar. A informação salva pelo método saveAddress deve ser exibida na área de janela de resultados.
  4. Para testar o serviço de maneira assíncrona, na área de janela de Qualidade de Serviço selecione a caixa de opção Ativar Chamada Assíncrona.
  5. Selecione o método findAddress, digite o nome utilizado durante o método saveAddress e clique em Chamar.
  6. Um novo link será exibido indicando que o método está em andamento. Clique no link para exibir a resposta do método na área de janela de Resultados.

Resultados

Depois de ter testado o serviço da web, deixe a JSP aberta para que você possa testar o serviço novamente depois que o serviço da web e o cliente tiverem sido protegidos.

Ponto de Verificação da Lição

< Anterior | Próximo >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: jaxwstd_exercise13.html