Software necessário para o tutorial

Antes de começar, é necessário instalar os seguintes softwares no computador:

• NetBeans IDE 5.5 (download).
• Java Standard Development Kit (JDK), versão 5.0 ou 6.0 (download)
• Sun Java System Application Server 9.0 (se não incluído na instalação do NetBeans IDE, faça o download e o instale separadamente).

Exercícios do tutorial

• Instalando e configurando o ambiente do tutorial
• Criando um serviço da Web
• Codificando o serviço da Web
• Implantando e testando o serviço da Web
• Consumindo o serviço da Web em
  • uma classe Java em um aplicativo Java SE
  • um servlet em um aplicativo da Web
  • uma página JSP em um aplicativo da Web

Escolhendo um recipiente

Você pode implantar o serviço da Web em um recipiente da Web ou em um recipiente EJB. Isso depende das escolhas de implementação. Por exemplo, se você planejar implantar no servidor da Web Tomcat, que tem somente um recipiente da Web, escolha criar um aplicativo da Web, não um módulo EJB.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione Aplicativo da Web na categoria Web ou Módulo EJB na categoria Empresa.
2. Nomeie o projeto CalculatorWSApplication.
3. Dependendo do servidor de implantação a ser usado, faça o seguinte:
   • Para o servidor de aplicativos Sun Java System, defina a versão do J2EE como Java EE 5.
   • Para o servidor Web Tomcat, defina Nível de origem como 1.4.
4. Clique em Finalizar.

Criando um serviço da Web a partir de uma classe Java

1. Clique com o botão direito do mouse no nó CalculatorWSApplication e escolha Novo > Serviço da Web.
2. Nomeie o serviço da Web CalculatorWS, digite org.me.calculator em Pacote e clique em Finalizar.

   A janela Projetos exibe o novo serviço da Web. Por exemplo, para aplicativos da Web, a janela Projetos agora tem esta aparência:

   

   O IDE cria automaticamente os descritores de implantação necessários para o servidor, se houver um. Para o servidor de aplicativos Sun Java System, não é necessário um descritor de implantação. Para serviços da Web implantados no servidor Web Tomcat, sun-jaxws.xml e um item WSServlet em web.xml são adicionados.

Resumo

Neste exercício, você criou um projeto do NetBeans e configurou o serviço da Web.

Adicionando lógica empresarial ao serviço da Web

1. Expanda o nó Serviços da Web e clique duas vezes no nó CalculatorWS. O serviço da Web se abre no Editor de fontes. Observe que já existe uma operação no código. Ele está comentado. Aqui, criamos uma nova operação a partir do começo. Outra maneira de criar a operação seria remover as linhas que comentam o código.
2. Clique com o botão direito do mouse no corpo da classe, acima ou abaixo do código comentado, e escolha Serviço da Web > Adicionar operação.
3. Na parte superior da caixa de diálogo Adicionar operação, digite add em Nome e selecione int na lista suspensa Tipo de retorno.
4. Na parte inferior da caixa de diálogo Adicionar operação, clique em adicionar e crie um parâmetro do tipo int nomeado i. Clique em OK.
5. Clique em Adicionar novamente e crie um parâmetro do tipo int chamado j.
6. Clique em OK na parte inferior da caixa de diálogo Adicionar operação. Observe que um esqueleto para o método add foi adicionado ao Editor de fontes:

       @WebMethod
       public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
           // TODO operação de implementação
           return 0;
               }

7. Altere o método add para o seguinte (as alterações estão em negrito):

       @WebMethod
       public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
           int k = i + j;
           return k;
           }

Resumo

Neste exercício, você adicionou código ao serviço da Web.

Cliente 1: Classe Java em um aplicativo Java SE

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione Aplicativo Java na categoria Geral. Nomeie o projeto CalculatorWS_Client_Application.

   Observação: No momento da redação, o problema Problema 10 não estava resolvido; portanto, você deve criar seu cliente do serviço da Web em uma pasta de projeto que não contenha espaços no caminho. Por exemplo, o caminho não deve ser "C:\Documentos e configurações\...".

   Clique em Finalizar.
2. Clique com o botão direito do mouse no nó CalculatorWS_Client_Application e escolha Novo > Cliente do serviço da Web.
3. Em Projeto, clique em Navegar. Navegue até o serviço da Web que você deseja consumir. Depois de selecionar o serviço da Web, clique em OK.
4. Digite org.me.calculator.client em Pacote e clique em Finalizar.

   A janela Projetos exibe o novo cliente do serviço da Web:

   

5. Clique duas vezes em Main.java para abri-lo no Editor de fontes. Exclua o comentário TODO e clique nessa linha com o botão direito do mouse. Escolha Recursos do cliente de serviço da Web > Chamar operação de serviço da Web.
6. Navegue até a operação Adicionar e clique em OK.
7. Altere a linha que está sublinhada em vermelho para o seguinte:

       System.out.println("Sum: " + port.add(3,4));

8. Clique com o botão direito do mouse no nó do projeto e escolha Executar projeto.

   A janela Saída agora deve mostrar o seguinte:

       compilar:
       executar:
       Soma: 7
           CONSTRUÇÃO BEM-SUCEDIDA (tempo total: 1 segundo)

Cliente 2: Servlet em aplicativo da Web

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Na categoria Web, selecione Aplicativo da Web. Nomeie o projeto CalculatorWSServletClient.

   Observação: No momento da redação, o problema Problema 10 não estava resolvido; portanto, você deve criar seu cliente do serviço da Web em uma pasta de projeto que não contenha espaços no caminho. Por exemplo, o caminho não deve ser "C:\Documentos e configurações\...".

   Clique em Finalizar.

2. Clique com o botão direito do mouse no nó CalculatorWSServletClient e escolha Novo > Cliente de serviço da Web.
3. Em Projeto, clique em Navegar. Navegue até o serviço da Web que você deseja consumir. Depois de selecionar o serviço da Web, clique em OK.
4. Digite org.me.calculator.client em Pacote e clique em Finalizar.

   A janela Projetos exibe o novo cliente do serviço da Web:

   

5. Clique com o botão direito do mouse no nó do projeto e escolha Novo > Servlet. Nomeie o servlet ClientServlet e o hospede em um pacote chamado org.me.calculator.client. Clique em Finalizar. Para tornar o servlet o ponto de entrada para o aplicativo, clique com o botão direito do mouse no nó do projeto, escolha Propriedades, selecione Executar e digite /ClientServlet em URL relativo. Clique em OK.
6. No Editor de fontes, remova a linha que comenta o corpo do método processRequest. Esta é a linha que inicia a seção que comenta o código:

       /* TODO saída da página aqui

   Em seguida, exclua a linha que encerra a seção do código comentado:

       */

   Adicione algumas linhas vazias depois desta linha:

       out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");

   Agora clique com o botão direito do mouse em uma das linhas vazias que você adicionou. Escolha Recursos do cliente de serviço da Web > Chamar operação de serviço da Web. A caixa de diálogo Selecionar operação para chamada será exibida.

7. Navegue até a operação add e clique em OK.

   O método processRequest agora tem a seguinte aparência (o código adicionado está em negrito abaixo):

       protected void processRequest(HttpServletRequest request, HttpServletResponse response)
       throws ServletException, IOException {
           response.setContentType("text/html;charset=UTF-8");
           PrintWriter out = response.getWriter();
           out.println("<html>");
           out.println("<head>");
           out.println("<title>Servlet ClientServlet</title>");
           out.println("</head>");
           out.println("<body>");
           out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");
   
           try { // Call Web Service Operation
               org.me.calculator.client.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
               org.me.calculator.client.CalculatorWS port = service.getCalculatorWSPort();
               // TODO inicializar argumentos da operação SW aqui
               int arg0 = 0;
               int arg1 = 0;
               // TODO processar resultado aqui
               int result = port.add(arg0, arg1);
               System.out.println("Result = "+result);
           } catch (Exception ex) {
               // TODO manipular exceções personalizadas aqui
           }
   
           out.println("</body>");
           out.println("</html>");
           out.close();
               }

   Altere o valor de arg0 e arg1 para outros números, como 3 e 4.

   Altere a instrução System.out.println para out.println.

   Adicione uma linha que imprima uma exceção, se uma exceção for lançada.

   O bloco try/catch deve ter a seguinte aparência (linhas novas e alteradas estão realçadas):

       try { // Call Web Service Operation
           org.me.calculator.client.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
           org.me.calculator.client.CalculatorWSApplication port = service.getCalculatorWSApplicationPort();
           // TODO inicializar argumentos da operação SW aqui
           int arg0 = 3;
           int arg1 = 4;
           // TODO processar resultado aqui
           int result = port.add(arg0, arg1);
           out.println("<p>Result: " + result);
       } catch (Exception ex) {
           out.println("<p>Exception: " + ex);
               }

8. Clique com o botão direito do mouse no nó do projeto e escolha Executar projeto.

   O servidor é iniciado, se já não estava em execução, o aplicativo é construído e implantado, e o navegador se abre, exibindo o resultado do cálculo.

Cliente 3: Página JSP em aplicativo da Web

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Na categoria Web, selecione Aplicativo da Web. Nomeie o projeto CalculatorWSJSPClient.

   Observação: No momento da redação, o problema Problema 10 não estava resolvido; portanto, você deve criar seu cliente do serviço da Web em uma pasta de projeto que não contenha espaços no caminho. Por exemplo, o caminho não deve ser "C:\Documentos e configurações\...".

   Clique em Finalizar.

2. Clique com o botão direito do mouse no nó CalculatorWSJSPClient e escolha Novo > Cliente de serviço da Web.
3. Em Projeto, clique em Navegar. Navegue até o serviço da Web que você deseja consumir. Depois de selecionar o serviço da Web, clique em OK.
4. Digite org.me.calculator.client em Pacote e clique em Finalizar.

   A janela Projetos exibe o novo cliente do serviço da Web.

5. Na pasta Páginas da Web, clique duas vezes em index.jsp para que seja aberto no Editor de fontes.
6. No nó Referências de serviços da Web, expanda o nó que representa o serviço da Web. A operação add, que você deseja invocar do cliente, agora está exposta.
7. Arraste a operação add para a página index.jsp do cliente e solte-a abaixo das marcas H1. O código para a invocação da operação do serviço agora é gerado na página index.jsp.

   Altere o valor de arg0 e arg1 para outros números, como 3 e 4.

8. Clique com o botão direito do mouse no nó do projeto e escolha Executar projeto.

   O servidor é iniciado, se já não estava em execução, o aplicativo é construído e implantado, e o navegador se abre, exibindo o resultado do cálculo: