Gerando um cliente de serviço Web JAX-WS
Consulte também
Um serviço Web pode ser consumido em uma aplicação Web, uma aplicação Java ou um cliente MIDP (MIDlet). Para obter informações sobre o consumo de serviços Web em um MIDlet, consulte a documentação do ME Mobility.
Para clientes JAX-WS, todos os esquemas e arquivos WSDL importados são determinados automaticamente pelo IDE. Para clientes JAX-RPC, antes de iniciar, observe que, se o arquivo WSDL que você deseja usar importar esquemas, outros arquivos WSDL ou ambos a partir do sistema de arquivos local, o cliente de serviços Web funcionará somente se os esquemas e arquivos WSDL importados forem copiados antes na pasta WEB-INF/wsdl (ou META-INF/wsdl). Caso essa restrição não seja atendida, a ferramenta wscompile não conseguirá localizar esses arquivos importados no final do procedimento abaixo.
Para criar um cliente de serviços Web:
- Crie o projeto que conterá o cliente de serviços Web. Dependendo de como você deseja consumir o serviço Web, crie um projeto de aplicação Web ou um projeto de aplicação Java.
- Nas janelas Projetos ou Arquivos, clique com o botão direito do mouse em um nó no projeto e selecione Novo > Outro.
O assistente para Novo arquivo se abre. Em Categorias, selecione serviços Web. Em Tipos de arquivos, selecione Cliente de serviços Web. Clique em Próximo.
- Acesse o arquivo WSDL do serviço Web a ser consumido pelo cliente de serviços Web. Dependendo do que o provedor tiver distribuído, adote o seguinte procedumento:
- Para gerar um cliente a partir de um projeto no sistema de arquivos local, clique em Projeto e navegue até o ícone da porta do serviço Web do projeto.
- Para gerar um cliente a partir de um arquivo WSDL no sistema de arquivos local, clique em Arquivo local e procure o arquivo WSDL.
- Para gerar um cliente a partir de um serviço Web em execução, clique em URL WSDL e, em seguida, digite ou cole a URL do serviço Web. Se a conexão estiver protegida por firewall corporativo, clique em Configurações de proxy e configure o número da porta e o host do proxy.
- O arquivo WSDL será descarregado quando o assistente for finalizado.
- Especifique um pacote onde os arquivos do cliente deverão ser gerados. Após concluir o assistente, você poderá localizar os arquivos gerados do cliente na janela Arquivos, na pasta build. Consulte Exibindo o cliente de serviços Web na janela Projetos.
- Para clientes JAX-RPC (J2EE 1.4), para os quais o suporte está disponível por meio do plug-in "Serviços Web JAX-RPC " no gerenciador Plug-ins, selecione o tipo de cliente do serviço Web na lista suspnsa Tipo de cliente:
- Stub estático gerado pelo contêiner J2EE. Este tipo está baseado no JSR-109, melhor que o JSR-101 por definir o empacotamento dos serviços Web nos módulos J-2EE padrão, que inclui um novo descritor de deployment e define os serviços Web que serão implementados como servlets ou beans de sessão.
Esse é o tipo recomendado e portável (através da especificação J2EE 1.4). Ao escolher esse tipo, o IDE adiciona informações de deployment nos respectivos descritores e o recipiente gera o stub e outros artefatos.
- Stup estático gerado pelo IDE.
Disponível somene para serviços Web JAX-WS (J2EE 1.4).
Esse tipo está baseado no JAX-RPC, que define o mapeamento de WSDL para Java e vice-versa. Também define uma API de cliente para chamar um serviço Web remoto e um ambiente do tempo de execução no servidor para hospedar um serviço Web. Esse tipo não é portátil. Ao escolher esse tipo, o IDE gera o stub e outros artefatos, empacota-os no arquivo e os implanta.
- Se um serviço Web for consumido em uma aplicação Java, nenhum servidor da aplicação J2EE será usado. a aplicação será executado como um processo JVM independente e seus parâmetros JVM serão configurados por projeto. Portanto, o stub estático gerado por recipiente J2EE não se aplica às aplicações Java e não estará disponível no menu Tipo de cliente.
Para clientes Java SE, use a lista suspensa Versão do JAX para especificar se deseja criar um cliente JAX-WS ou um cliente JAX-RPC.
- Se você quiser usar mensagens XML puras ao chamar o serviço Web, selecione Gerar código de emissão. O código do cliente é gerado por meio da interface java.xml.ws.Dispatch em vez da interface de ponto final de serviço usual. Esse á um recurso avançado e sua seleção é cancelada por padrão.
- Clique em Finalizar.
- Consulte também
- Sobre clientes de serviços Web
- Sobre serviços Web
Notificações legais