Criando o servlet ListNews

Neste exercício, você criará o servlet ListNews que será utilizado para exibir uma lista de mensagens enviadas. As anotações serão utilizadas para introduzir a fachada de sessão, acessar o método findAll e recuperar as mensagens enviadas.

1. Clique com o botão direito do mouse em um projeto de módulo e selecione Novo > Servlet.
2. Digite ListNews para o nome da classe.
3. Digite web para o Nome do pacote. Clique em Terminar.

   Ao clicar em Terminar, a classe persistence.xml irá se abrir no Editor de código-fonte.

4. Clique com o botão direito do mouse no Editor de código-fonte entre a definição de classes e selecione Inserir código (Alt-Insert; Ctrl-I no Mac) e selecione Chamar bean corporativo.
5. Na caixa de diálogo Chamar bean corporativo, expanda o nó MavenEnterpriseApp-ejb e selecione NewEntityFacade. Clique em OK.
   

   Ao clicar em OK, o recurso EJB é introduzido no servlet utilizando a anotação @EJB.

   @WebServlet(name = "ListNews", urlPatterns = {"/ListNews"})
   public class ListNews extends HttpServlet {
       @EJB
       private NewsEntityFacade newsEntityFacade;

6. No método processRequest, modifique o método adicionando o seguinte código (em negrito) ao corpo do método:

   out.println("<h1>Servlet ListNews at " + request.getContextPath () + "</h1>");
   
   List news = newsEntityFacade.findAll();
   for (Iterator it = news.iterator(); it.hasNext();) {
     NewsEntity elem = (NewsEntity) it.next();
     out.println(" <b>"+elem.getTitle()+" </b><br />");
     out.println(elem.getBody()+"<br /> ");
   }
   out.println("<a href='PostMessage'>Add new message</a>");
   
   out.println("</body>");
      

   Nota. Pode ser preciso retirar o comentário do código se você estiver usando uma versão anterior do IDE.

7. Corrija as importações (Ctrl-Shift-I; ⌘-Shift-I no Mac) e salve as alterações.

   Ao gerar as instruções de importação, você deseja importar as bibliotecas java.util.

Criação do servlet PostMessage

Neste exercício, será criado o servlet PostMessage que será utilizado para enviar mensagens. Utilizaremos anotações para injetar os recursos JMS que criamos diretamente no servlet, especificando o nome variável e o nome para o qual é mapeado. Em seguida, adicionaremos o código para enviar a mensagem JMS e o código para o formulário HTML para adicionar uma mensagem.

1. Clique com o botão direito do mouse em um projeto de módulo e selecione Novo > Servlet.
2. Digite PostMessage para nome da classe.
3. Selecione web em nome do pacote. Clique em Terminar.

   Ao clicar em Terminar, a classe PostMessage.java se abrirá no Editor de código-fonte.

4. No Editor de código-fonte, utilize anotações para introduzir os recursos ConnectionFactory e Queue, adicionando as seguintes declarações de campo.

   @WebServlet(name="PostMessage", urlPatterns={"/PostMessage"})
   public class PostMessage extends HttpServlet {                
       @Resource(mappedName="jms/NewMessageFactory")
       private  ConnectionFactory connectionFactory;
   
       @Resource(mappedName="jms/NewMessage")
       private  Queue queue;

5. Corrija as importações para importar as bibliotecas javax.jms.
   

   Nota. Se o IDE não oferecer o javax.jms como opção, é possível pesquisar os repositórios em busca do artefato correto clicando no ícone de sugestão da margem ao lado de private ConnectionFactory connectionFactory; e selecionando Pesquisar dependência nos repositórios Maven.

   

   É possível utilizar a caixa de diálogo Pesquisar nos repositórios Maven para localizar o artefato javaee-api-6.0 que contém ConnectionFactory.

   
6. Adicione o código a seguir para enviar as mensagens JMS ao método processRequest.

   response.setContentType("text/html;charset=UTF-8");
   
   // Adicione o código a seguir para enviar a mensagem JMS
   String title=request.getParameter("title");
   String body=request.getParameter("body");
   if ((title!=null) && (body!=null)) {
       try {
           Connection connection = connectionFactory.createConnection();
           Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
           MessageProducer messageProducer = session.createProducer(queue);
   
           ObjectMessage message = session.createObjectMessage();
           // aqui criamos a NewsEntity, que será enviada em mensagem JMS
           NewsEntity e = new NewsEntity();
           e.setTitle(title);
           e.setBody(body);
   
           message.setObject(e);
           messageProducer.send(message);
           messageProducer.close();
           connection.close();
           response.sendRedirect("ListNews");
   
       } catch (JMSException ex) {
           ex.printStackTrace();
       }
   }

7. Adicione as linhas a seguir (em negrito) ao formulário web para adicionar uma mensagem.

   out.println("Servlet PostMessage at " + request.getContextPath() + "</h1>");
   
   // O código a seguir adiciona o formulário para a página da web
   out.println("<form>");
   out.println("Title: <input type='text' name='title'><br/>");
   out.println("Message: <textarea name='body'></textarea><br/>");
   out.println("<input type='submit'><br/>");
   out.println("</form>");
   
   out.println("</body>");
       

   Nota. Pode ser preciso retirar o comentário do código se você estiver usando uma versão anterior do IDE.

8. Corrija as importações e salve as alterações.
   

   Nota. Você quer importar as bibliotecas javax.jms de Connection, ConnectionFactory, Session e Queue.

Trabalhando com dependências do projeto

Neste exercício, você examinará o POM pom.xml do projeto Web e modificar o POM para impedir que sejam incluídos artefatos desnecessários no WAR durante o empacotamento. Cada projeto Maven contém um arquivo pom.xml que contém os detalhes sobre o conteúdo dos arquivos. Todas as bibliotecas externas que sejam necessárias para o projeto estão listadas como dependências no POM. É possível modificar o POM para especificar as dependências que precisam estar incluídas durante o empacotamento do arquivo.

Neste aplicativo, os arquivos JAR EJB e WAR serão empacotados em um arquivo EAR. Se observar o pom.xml do projeto MavenEnterpriseApp-ear, poderá notar que o EJB e o WAR estão declarados como dependências.

Se observar o pom.xml do projeto Web, poderá notar que o arquivo EJB está declarado como uma dependência e o escopo está especificado como fornecido. Quando o valor do elemento do escopo de um artefato é fornecido, o artefato não será incluso durante a embalagem. O projeto web precisa do arquivo EJB como uma dependência, mas neste aplicativo não se deseja incluir o arquivo EJB no WAR durante o empacotamento porque o arquivo EJB estará disponível e fornecido como parte do arquivo EAR.

É possível clicar com o botão direito do mouse no pom.xml e selecionar Mostrar gráfico de dependência para ver uma representação visual das dependências do projeto. É possível colocar o cursor sobre um artefato para exibir uma dica de ferramenta com os detalhes do artefato.

Execute as etapas a seguir para modificar o POM do projeto web para adicionar um elemento escopo à dependência no artefato javaee-api.

1. Expanda o nó Arquivos do projeto no projeto web.
2. Clique duas vezes em pom.xml para abrir o arquivo no editor.
3. Modifique a dependência no artefato javaee-api editando o POM a fim de adicionar o seguinte elemento <scope>provided</scope>.

   <dependency>
       <groupId>javax</groupId>
       <artifactId>javaee-api</artifactId>
       <version>6.0</version>
       <type>jar</type>
       <scope>provided</scope>
   </dependency>

   É possível utilizar o autocompletar de código no editor POM para ajudá-lo a editar o arquivo.

   

   Ao declarar que a dependência é fornecida, o Maven não empacotará o artefato ao construir o arquivo WAR.

   Nota. Se você estiver usando o NetBeans IDE 6.9, é preciso modificar pom.xml para também adicionar o elemento <scope>provided</scope> à dependência no arquivo EJB.

   <dependency>
       <groupId>com.mycompany</groupId>
       <artifactId>MavenEnterpriseApp-ejb</artifactId>
       <version>1.0-SNAPSHOT</version>
       <scope>provided</scope>
   </dependency>

4. Salve as alterações.

Construindo com dependências

A estrutura de construção Maven percorre uma sequência específica de fases, e cada fase compreende uma ou mais metas e pode ser configurada para utilizar vários plug-ins Maven. O item de menu Construir com dependências é mapeado para a fase instalar do ciclo de vida de construção do Maven e é configurado para utilizar o plug-in Reactor. Ao selecionar Construir com dependências no menu pop-up, o Maven constrói o aplicativo e as dependências necessárias, bem como copia os artefatos construídos no repositório local.

É possível modificar como as fases e as metas do Maven são mapeados para as ações do menu no painel Ações da caixa de diálogo Propriedades do projeto.

Para construir o arquivo EAR, execute os passos a seguir.

• Clique com o botão direito do mouse no nó do projeto MavenEnterpriseApp-ear e selecione Construir com dependências.

Quando você constrói o projeto EAR utilizando o plug-in Reactor, os subprojetos que são dependências do projeto EAR são compilados antes da compilação do projeto Assembly. A janela Saída exibe a ordem de construção.

Os resultados da construção também são exibidos na janela Saída.

Após construir o projeto EAR, é possível ver o arquivo EAR final dentro do diretório target no nó do projeto EAR na janela Arquivos.

Se o nome de artefato padrão com.mycompany foi utilizado, é possível utilizar o Navegador do repositório Maven para visualizar os artefatos de construção expandindo com.mycompany no Repositório local.

Para obter mais detalhes sobre a construção de projetos Maven, consulte Maven: Introdução ao ciclo de vida de construção em maven.apache.org.

Implantando e executando o aplicativo a partir do IDE

Neste exercício, você usará a ação Executar para implantar o arquivo EAR no servidor GlassFish. Após a implementação do aplicativo, você abrirá a página ListNews do aplicativo no navegador e adicionará uma mensagem.

1. Clique com o botão direito do mouse no nó do projeto EAR na janela Projetos e selecione Executar.

   Quando se clica em Executar, o IDE implementará o arquivo EAR e criará os recursos JMS no servidor. O IDE abre a página padrão de índice do projeto (http://localhost:8080/MavenEnterpriseApp-web/) no navegador.

2. Abra o navegador na URL a seguir para exibir a página ListNews.

   http://localhost:8080/MavenEnterpriseApp-web/ListNews.

   Ao executar o projeto pela primeira vez, o banco de dados está vazio e não há mensagens a serem exibidas.

   
3. Clique em Adicionar nova mensagem.
4. Digite uma mensagem no formulário no servlet PostMessage. Clique em Submeter consulta.
   

Ao adicionar uma mensagem com o servlet PostMessage, a mensagem é enviada para o bean controlado por mensagem para escrita no armazenamento persistente e o servlet ListNews é chamado para exibir as mensagens no banco de dados. A lista de mensagens no banco de dados recuperada pela ListNews, em geral, ainda não contém a nova mensagem, porque o serviço de mensagem é assíncrono.

Compilar no Salvamento e Organizar no Salvamento são habilitados por padrão nos projetos Maven que especificam o servidor GlassFish como o servidor de destino. Por exemplo, caso um salvamento seja modificado como servlet, é possível recarregá-lo no navegador e visualizar as alterações sem ter que realizar deployment novamente no aplicativo.

Veja se você está usando o NetBeans IDE 7.0.
No NetBeans IDE 7.0, é necessário executar as etapas a seguir para modificar as metas do Maven que são mapeadas para a ação Executar. Após modificar a ação, é possível utilizar a ação Executar para implantar o EAR no servidor. Quando se seleciona a ação Executar, pode ser necessário selecionar servidor GlassFish na caixa de diálogo Selecionar servidor de implementação.

Implantando a partir do console de administração do GlassFish

Neste exercício, o arquivo EAR será implantado utilizando a ferramenta de implantação do console de administração do GlassFish.

1. Expanda o nó Servidores na janela Serviços.
2. Inicie o servidor GlassFish.
3. Clique com o botão direito do mouse no nó Servidor GlassFish e selecione Visualizar console Admin para abrir o console Admin do GlassFish no navegador.
4. Clique no nó Aplicativos no painel esquerdo do console Admin.
5. Clique no botão Implantar no painel principal do console Admin.
6. Clique em Procurar para localizar o arquivo EAR do aplicativo corporativo.

   O arquivo EAR está localizado no diretório target dentro do diretório do aplicativo corporativo no sistema local.

7. Clique em OK.

Ao clicar em OK, a ferramenta de implantação do GlassFish implanta o aplicativo.

Nota. Se implantar o aplicativo utilizando a ferramenta de implantação no GlassFish Admin Console, você também precisará criar manualmente os recursos necessários para o aplicativo, caso estes não existam.