Consumindo serviços Web do StrikeIron em aplicações Web

Este tutorial destaca as etapas para consumir serviços Web do StrikeIron pré-empacotados com o NetBeans IDE 6.1 ou 6.0, usando o Visual Web designer. Especificamente, ele demonstrará como construir uma aplicação Web que chama o serviço de verificação de endereço dos EUA para verificar o endereço indicado pelo usuário.

Conteúdo

• Criando um projeto da Web
• Criando a página da Web
• Implementando a página da Web
• Testando a página Web
• Procurando por mais serviços StrikeIron

Para seguir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou recurso	Versão necessária
NetBeans IDE	Web e Java EE versão 6.0 ou 6.1
Java Development Kit (JDK)	versão 6 ou versão 5
Servidor da aplicação ou Web compatível com Java EE	Servidor Web Tomcat 6.0 e/ou Servidor da aplicação GlassFish v2

O Tomcat e o GlassFish podem ser instalados, opcionalmente, com a distribuição Web e Java EE do NetBeans IDE. Como alternativa, você pode visitar a página de download do GlassFish ou a página de download do Apache Tomcat.

Você também precisa de uma conta do StrikeIron a fim de acessar os serviços Web do StrikeIron. Como um usuário do NetBeans, você obtém acessos do StrikeIron quando registra uma conta do StrikeIron. Para obter mais detalhes, visite http://developer.strikeiron.com/netbeans/freetrial/.

O NetBeans IDE 6.0 e 6.1 vem pré-empacotado com um conjunto popular de serviços Web do StrikeIron. Você pode acessá-los, alternando para a janela Serviços, expandindo o nó Serviços Web, e abrindo o modo Serviços do StrikeIron. Aí, após um momento, enquanto o serviço é carregado, você deve ver os serviços seguintes (no 6.0—6.1 há muito mais):

Mais tarde no tutorial, demonstraremos como consumir esses serviços Web, arrastando-os e soltando-os no Visual Web designer.

Criando um projeto da Web

Primeiro, você precisa criar um projeto da Web que seja aceito pelo Visual Web designer.

1. Escolha Arquivo > Novo projeto. Em Categorias, selecione Web. Em Projetos, selecione Aplicação Web e clique em Próximo.
2. Em Nome do projeto, indique USAddressVerificationDemo.
3. Em Servidor, selecione o servidor e clique em Próximo.
4. Selecione JavaServer Faces Visual Web em Frameworks, como mostrado abaixo:
   
5. Clique em Terminar.

Criando a página da Web

Depois que você cria o projeto USAddressVerificationDemo, o IDE abre automaticamente a Page1.jsp padrão na aba Design, que contém uma tela vazia. No lado direito da tela, você verá a Paleta (disponível no menu Janela). Implementaremos a página como mostrado abaixo:

Eis aqui como criar a página mostrada acima:

1. Arraste e solte o componente Rótulo da paleta para a tela. Depois que o rótulo é criado na tela, você pode modificar o texto do rótulo. Repita a mesma etapa para criar 4 rótulos no total. Você pode arrastar os rótulos com o mouse para organizá-los da forma desejada.
2. Arraste e solte um componente Campo de texto para cada componente Rótulo. Crie 4 campos de texto no total.
3. Altere a propriedade id de cada campo de texto, selecionando o campo de texto com o mouse e alterando o id na janela Propriedades do campo de texto. Do início ao fim, defina as propriedades id dos campos de texto para o seguinte: addressLine1TF, addressLine2TF, cityStateZipTF e resultTF.
4. Clique com o botão direito do mouse em todos os 4 campos de texto e selecione Adicionar atributo de vinculação a partir de cada menu de contexto.
5. Arraste e solte o componente Botão para o local desejado e altere o texto para Validar e o id para validateButton.
6. Alterne para a janela Serviços Na janela Serviços, expanda o nó Serviços Web, em seguida, o nó Serviços do StrikeIron, em seguida, o nó USAddressVerification e finalmente o nó USAddressVerificationSoap.
7. Arraste e solte o nó da operação verifyAddressUSA para a tela. Como mostrado na captura de tela acima, agora você deve ver dois novos nós, USAddressVerificationSOAPVerifyAddressUSA1 e USAddressVerificationSoapClient1, aparecer sobe o nó Page1 no Navegador.

Implementando a página da Web

Esta seção mostra o código para chamar o serviço de verificação de endereços dos EUA. Este código usa a página da Web feitas em Criando a página da Web para coletar dados e exibir o resultado.

1. Na tela Page1.jsp, clique duas vezes no botão Validar. O IDE alterna para a visualização Código-fonte Java e coloca o cursor em validateButton_action().
2. Digite ou cole o código seguinte. Substitua os valores do parâmetro de bean.setUserID e bean.setPassword por suas credenciais do StrikeIron.

   public String validateButton_action() {
       USAddressVerificationSoapVerifyAddressUSA bean =
               this.getUSAddressVerificationSoapVerifyAddressUSA1();
       //bean.setUnregisteredUserEmail("your_email_address_here");
       bean.setUserID("your_strikeiron_userid_here");
       bean.setPassword("your_strikeiron_password_here");
       bean.setAddressLine1((String) getAddressLine1TF().getText());
       bean.setAddressLine2((String) getAddressLine2TF().getText());
       bean.setCityStateZip((String) getCityStateZipTF().getText());
   
       getResultTF().setText(bean.invokeMethod().getAddressStatus());
   
       return null;
   }

   Observação: Para acessar os serviços Web do StrikeIron, você precisa de uma id de usuário e senha do StrikeIron. Você pode obter acessos gratuitos do StrikeIron, registrando uma conta do StrikeIron. Para obter mais detalhes, visite http://developer.strikeiron.com/netbeans/freetrial/.

Testando a página da Web

Para testar o aplicativo, faça o seguinte:

1. Na janela Projetos, clique com o botão direito do mouse no projeto e escolha Executar. O servidor se inicia e o navegador se abre.
2. No navegador, digite um endereço nos campos de texto Linha de endereço 1, Linha de endereço 2 e CEP e Estado da cidade e clique em Validar. Você deve ver o resultado no campo Resultado como mostrado abaixo:
   

Procurando por mais serviços StrikeIron

Na janela Serviços, clique com o botão direito do mouse no nó Serviços do StrikeIron e escolha Localizar serviços do StrikeIron. Digite uma palavra de pesquisa, tal como "ações" e pressione Enter. Quando a pesquisa retorna, os resultados são exibidos em uma lista à esquerda da caixa de diálogo. Selecione uma linha para ver os detalhes da descrição do serviço.



Para usar um serviço, selecione-o e clique em Adicionar. O novo serviço é adicionado à pasta StrikeIron e, em seguida, estará imediatamente pronto para experimentação.



Envie-nos seus comentários



Veja também

Para obter mais informações sobre o uso do NetBeans IDE para desenvolver aplicações Java EE, consulte os seguintes recursos:

• Desenvolvendo clientes de serviço Web JAX-WS
• Introdução aos serviços Web JAX-WS
• Introdução aos serviços Web RESTful no GlassFish
• Aplicação de serviço Web passando dados binários
• Interoperabilidade avançada do serviço Web
• Trilha do aprendizado das aplicações de serviço Web e EJB

Para enviar comentários e sugestões, obter suporte e se manter informado sobre os mais recentes desenvolvimentos dos recursos de desenvolvimento de Java EE do NetBeans IDE, inscreva-se na lista de endereçamento de .