Escolhendo um contâiner

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

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

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

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

   A janela Projetos exibe a estrutura do novo serviço Web e o visual designer é mostrado na área do editor. Por exemplo, para aplicações Web agora você deve ver o seguinte:

   

Adicionando lógica empresarial ao serviço Web

1. Clique em Adicionar operação no visual designer.

   Aparece uma caixa de diálogo, onde você pode definir a nova operação.

2. Na parte superior da caixa de diálogo Adicionar operação, digite add em Nome e digite int na lista suspensa Tipo de retorno. Na parte inferior da caixa de diálogo Adicionar operação, clique em Adicionar e crie um parâmetro de tipo int chamado i. Em seguida, clique em Adicionar novamente e crie um parâmetro de tipo int chamado j.

   Agora você deve ver o seguinte:

   

3. Clique em OK na parte inferior da caixa de diálogo Adicionar operação.

   O visual designer agora exibe o seguinte:

   

4. Clique em Código-fonte e observe que o código-fonte que foi gerado nas etapas anteriores é o seguinte:

   

5. No editor, estenda a operação de esqueleto add para o seguinte (alterações em negrito):

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

Como você pode ver no código acima, o serviço Web simplesmente recebe dois números e retorna a soma deles. Na próxima seção, usamos o IDE para testar nosso serviço Web.

Cliente 1: Classe Java na aplicação Java SE

Nesta seção, criamos uma aplicação Java padrão. O assistente que usamos para criar a aplicação também criará uma classe Java. Em seguida, usaremos as ferramentas do IDE para consumir o serviço Web que criamos no início deste tutorial.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione Aplicação Java na categoria Geral. Nomeie o projeto CalculatorWS_Client_Application. Clique em Terminar.
2. Clique com o botão direito do mouse no nó CalculatorWS_Client_Application e escolha Novo > Cliente do serviço Web.
3. Em Projeto, clique em Navegar. Navegue até o serviço Web que você deseja consumir. Depois de selecionar o serviço Web, clique em OK.
4. Digite org.me.calculator.client em Pacote e clique em Terminar.

   A janela Projetos exibe o novo cliente de serviço Web, com um nó para o método add que você criou:

   

5. Clique duas vezes em Main.java para abri-lo no Editor de código-fonte. Exclua o comentário TODO e arraste o nó add acima para a linha vazia. Agora você deve ver o seguinte:

   public static void main(String[] args) {
   
       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 initialize WS operation arguments here
           int i = 0;
           int j = 0;
           // TODO process result here
           int result = port.add(i, j);
           System.out.println("Result = "+result);
       } catch (Exception ex) {
           // TODO handle custom exceptions here
       }
   
   }

   Observação: como alternativa, em vez de adicionar o nó add, você pode clicar com o botão direito do mouse no editor e escolher Recursos de cliente de serviço Web > Chamar operação de serviço Web.

6. Inicialize dois ints, usando números significativos, tais como 3 e 4. Apenas altere os valores dos dois ints acima de 0 para algum outro número.
7. Clique com o botão direito do mouse no nó do projeto e escolha Executar.

   A janela Saída agora deve mostrar a soma:

       compile:
       run:
       Result = 7
       BUILD SUCCESSFUL (total time: 1 second)

Cliente 2: Servlet na aplicação Web

Nesta seção, criamos uma nova aplicação Web, depois disso, criamos um servlet. Em seguida, usamos o servlet para consumir o serviço Web que criamos no início deste tutorial.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Na categoria Web, selecione Aplicação Web. Nomeie o projeto CalculatorWSServletClient. Clique em Terminar.
2. Clique com o botão direito do mouse no nó CalculatorWSServletClient e escolha Novo > Cliente de serviço Web.

   O assistente para Novo cliente de serviço Web é exibido.

3. Em Projeto, clique em Navegar. Navegue até o serviço Web que você deseja consumir. Depois de selecionar o serviço Web, clique em OK.
4. Em Pacote, digite org.me.calculator.client.

Agora você deve ver o seguinte:



Clique em Terminar.

O nó Referências do serviço Web na janela Projetos exibe a estrutura do seu cliente recém-criado, incluindo a operação add que você criou anteriormente neste tutorial:



5. Clique com o botão direito do mouse no nó do projeto CalculatorWSServletClient e escolha Novo > Servlet. Chame o servlet de ClientServlet e coloque-o em um pacote chamado org.me.calculator.client. Clique em Terminar.
6. Para tornar o servlet o ponto de entrada para a aplicação, 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.
7. No Editor de código-fonte, remova a linha que comenta o corpo do método processRequest. Esta é a linha:

       /* 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, arraste o nó que representa a operação add para o espaço que você criou.

   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.CalculatorWS port = service.getCalculatorWSPort();
               // TODO initialize WS operation arguments here
               int i = 0;
               int j = 0;
               // TODO process result here
               int result = port.add(i, j);
               out.println("Result = "+result);
           } catch (Exception ex) {
               // TODO handle custom exceptions here
           }
   
           out.println("</body>");
           out.println("</html>");
           out.close();
        }

   Altere o valor de i e j para números mais significativos, tais como 3 e 4.

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

   O servidor se inicia, caso já não estivesse sendo executado; a aplicação é construída e implantada, e o navegador se abre, exibindo o resultado do cálculo, como mostrado abaixo:

Cliente 3: Página JSP na aplicação Web

Nesta seção, criamos uma nova aplicação Web e, em seguida, consumimos nosso serviço Web na página JSP padrão que o assistente para Aplicação Web cria.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Na categoria Web, selecione Aplicação Web. Nomeie o projeto CalculatorWSJSPClient. Clique em Terminar.
2. Clique com o botão direito do mouse no nó CalculatorWSJSPClient e escolha Novo > Cliente de serviço Web.
3. Em Projeto, clique em Navegar. Navegue até o serviço Web que você deseja consumir. Depois de selecionar o serviço Web, clique em OK.
4. Em Pacote, digite org.me.calculator.client.

   Agora você deve ver o seguinte:

   

   Clique em Terminar.

   A janela Projetos exibe o novo cliente de serviço Web, como mostrado abaixo:

   

5. No nó Referências de serviços Web, expanda o nó que representa o serviço Web. A operação add, que você deseja invocar do cliente, agora está exposta.
6. Arraste a operação add para a página index.jsp do cliente, e solte-a abaixo das marcas H1. O código para chamar a operação de serviço agora é gerado na página index.jsp, como você pode ver aqui:

   <%
   try {
       org.me.calculator.client.CalculatorWSService service =
           new org.me.calculator.client.CalculatorWSService();
       org.me.calculator.client.CalculatorWS port =
           service.getCalculatorWSPort();
        // TODO initialize WS operation arguments here
       int i = 0;
       int j = 0;
       // TODO process result here
       int result = port.add(i, j);
       out.println("Result = "+result);
   } catch (Exception ex) {
       // TODO handle custom exceptions here
   }
   %>

   Altere o valor de i e j de 0 para números mais significativos, tais como 3 e 4.

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

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