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 suas escolhas de implementação. Se estiver criando uma aplicação Java EE 6, use um contêiner Web, pois você pode colocar EJBs diretamente em uma aplicação Web. Por exemplo, se você planeja implantar no servidor Web Tomcat, que tem somente um contêiner da Web, crie uma aplicação Web, não um módulo EJB.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). Selecione aplicação Web na categoria Java Web ou Módulo EJB na categoria Java EE.

   É possível criar um serviço web JAX-WS em um projeto Maven. Selecione Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS) e o módulo Aplicativo da Web Maven ou Maven EJB na categoria Maven. Se você nunca usou Maven com NetBeans, consulte Práticas recomendadas para o Maven.

2. Nomeie o projeto CalculatorWSApplication. Selecione uma localização para o projeto. Clique em Próximo.
3. Selecione o servidor e a versão do Java EE e clique em Terminar.

   Para usar o servidor Oracle WebLogic, registre o servidor com o IDE. Além disso, se você está usando o servidor WebLogic, observe a screencast em Implantando de um aplicativo da Web para Oracle WebLogic.

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 e digite org.me.calculator no Pacote. Deixe selecionado o Criar serviço Web desde o início.
3. Se você estiver criando um projeto Java EE 6, selecione Implementar serviço Web como um Bean de sessão sem estado.
   
4. Clique em Terminar. A janela Projetos exibe a estrutura do novo serviço Web e o código-fonte é mostrado na área do editor.
   

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

Nesta seção, você cria um aplicativo Java padrão. O assistente usado para criar o aplicativo também criará uma classe Java. Em seguida, você usa as ferramentas do IDE para criar um cliente e consumir o serviço Web que criou no início deste tutorial.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). Selecione Aplicativo Java na categoria Java. Nomeie o projeto CalculatorWS_Client_Application. Deixe selecionada a opção Criar classe principal e aceite todas as outras configurações padrão. 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. O assistente para Novo cliente de serviço da Web é aberto.
3. Selecione Projeto como o código-fonte WSDL. Clique em Procurar. Procure o serviço da web CalculatorWS no projeto CalculatorWSApplication. Depois de selecionar o serviço Web, clique em OK.
   
4. Não selecione um nome de pacote. Deixe este campo vazio.
   
5. Deixe as outras configurações com o padrão 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:

   
   
6. Clique duas vezes na classe principal para abri-la no Editor de código-fonte. Arraste o nó adicionar abaixo do método main().
   

   Agora você deve ver o seguinte:

   public static void main(String[] args) {
       // TODO code application logic here
   }
   private static int add(int i, int j) {
       org.me.calculator.CalculatorWS_Service service = new org.me.calculator.CalculatorWS_Service();
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

   Observação: alternativamente, em vez de arrastar o nó adicionar , é possível clicar com o botão direito do mouse no editor e a seguir escolher Inserir código > Operação de chamada do serviço da Web.

7. No corpo do método main(), substitua o comentário TODO com o código que inicializa os valores de i e j, chama add() e mostra o resultado.

   public static void main(String[] args) {
       int i = 3;
       int j = 4;
       int result = add(i, j);
       System.out.println("Result = " + result);
   }

8. Cerque o código do método main() com um bloco tentar/obter que imprime uma exceção.

   public static void main(String[] args) {
       try {
           int i = 3;
           int j = 4;
           int result = add(i, j);
           System.out.println("Result = "+result);
       } catch (Exception ex) {
           System.out.println("Exception: " + ex);
       }
   }

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

   A janela Saída agora mostra a soma:

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

Cliente 2: Servlet na aplicação Web

Nesta seção, você cria uma nova aplicação Web e, depois disso, cria um servlet. Em seguida, usa o servlet para consumir o serviço Web que criou no início deste tutorial.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). Na categoria Java Web, selecione Aplicativo da Web. Nomeie o projeto CalculatorWSServletClient. Clique em Próximo e, em seguida, 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. Selecione Projeto como o código-fonte WSDL. Clique em Procurar. Procure o serviço da web CalculatorWS no projeto CalculatorWSApplication. Depois de selecionar o serviço Web, clique em OK.
   
4. Não selecione um nome de pacote. Deixe este campo vazio.
5. Deixe as outras configurações com o padrão e 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:

   
   
6. 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.
7. Para tornar o servlet o ponto de entrada do aplicativo, clique com o botão direito do mouse no nó do projeto CalculatorWSServletClient e escolha Propriedades. Abra as propriedades de execução e digite /ClientServlet no campo URL relativa. Clique em OK.
8. Se houver ícones de erro em ClientServlet.java, clique com o botão direito do mouse no nó do projeto e selecione Limpar e construir.
9. No Editor de código-fonte, arraste a operaçãoadicionar em qualquer lugar do corpo da classe ClientServlet. O método add() aparece ao final do código da classe.

   Observação: alternativamente, em vez de arrastar o nó adicionar , é possível clicar com o botão direito do mouse no editor e a seguir escolher Inserir código > Operação de chamada do serviço da Web.

   private int add(int i, int j) {
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

10. No método processRequest(), adicione algumas linhas vazias depois desta linha:

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

11. Adicione o código que inicializa os valores de i e j, chama add() e mostra o resultado. O código adicionado está em negrito:

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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>");
    
            int i = 3;
            int j = 4;
            int result = add(i, j);
            out.println("Result = " + result);
    
            out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

12. Cerque o código adicionado com um bloco tentar/obter que imprime uma exceção.

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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 {
                int i = 3;
                int j = 4;
                int result = add(i, j);
                out.println("Result = " + result);
            } catch (Exception ex) {
                out.println("Exception: " + ex);
            }
            out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

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

    O servidor se inicia, o aplicativo é construído e implantado 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, você cria uma nova aplicação Web e, em seguida, consome o serviço Web na página JSP padrão que o assistente para Aplicação Web cria.

Observação: se você quiser executar um cliente de aplicativo Web JSP em Oracle WebLogic, consulte Executando um aplicativo Java Server Faces 2.0 em WebLogic.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). Na categoria Java Web, selecione Aplicativo da 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. Selecione Projeto como o código-fonte WSDL. Clique em Procurar. Procure o serviço da web CalculatorWS no projeto CalculatorWSApplication. Depois de selecionar o serviço Web, clique em OK.
   
4. Não selecione um nome de pacote. Deixe este campo vazio.
5. Deixe as outras configurações com o padrão e clique em Terminar.

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

   
   
6. No nó Referências de serviços Web, expanda o nó que representa o serviço Web. A operação add, que você 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 chamar a operação de serviço agora é gerado na página index.jsp, como você pode ver aqui:

   <%
   try {
       org.me.calculator.CalculatorWSService service = 
           new org.me.calculator.CalculatorWSService();
       org.me.calculator.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 por outros inteiros, tais como 3 e 4. Substitua a linha TODO comentada no bloco catch por out.println("exception" + ex);.

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

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