JSF 2.0 – Enviando e-mail com Commons Mail

Olá,

Há alguns dias me deparei com algumas questões sobre o envio/recebimento de e-mails utilizando jsf. Não vamos tentar reinventar a roda, existem APIs prontas para diversas coisas, inclusive o envio de mensagens de correio eletrônico. É o caso da Commons Mail da Apache Foundatio, uma excelente API que envia e-mails simples, com anexo, html formatado, etc.

Neste primeiro post iremos mostrar como enviar um e-mail simples(somente texto) por uma aplicação JSF 2.0 com primefaces.

Utilizamos neste exemplo as seguintes libs:

– primefaces-2.2.RC1-SNAPSHOT.jar

– commons-email-1.2.jar

Nossa organização de pacotes e pastas web ficou da seguinte forma:

Como viram acima iremos precisar, para este exemplo, apenas de um modelo, um controller e uma classe utils com alguns métodos estáticos.

Irei começar pelo modelo da mensagem, a classe Mensagem.java

public class Mensagem {

 private String destino;
 private String titulo;
 private String mensagem;

 public String getDestino() {
 return destino;
 }

 public void setDestino(String destino) {
 this.destino = destino;
 }

 public String getMensagem() {
 return mensagem;
 }

 public void setMensagem(String mensagem) {
 this.mensagem = mensagem;
 }

 public String getTitulo() {
 return titulo;
 }

 public void setTitulo(String titulo) {
 this.titulo = titulo;
 }
}


Acima, um simples modelo com títuo, a mensagem e o e-mail do destinatário. Explicarei agora como ficou a classe EmailUtils.java que segue abaixo:
public class EmailUtils {

 private static final String HOSTNAME = "smtp.gmail.com";
 private static final String USERNAME = "exemplo";
 private static final String PASSWORD = "*************";
 private static final String EMAILORIGEM = "exemplo@gmail.com";

 public static Email conectaEmail() throws EmailException {
 Email email = new SimpleEmail();
 email.setHostName(HOSTNAME);
 email.setSmtpPort(587);
 email.setAuthenticator(new DefaultAuthenticator(USERNAME, PASSWORD));
 email.setTLS(true);
 email.setFrom(EMAILORIGEM);
 return email;
 }

 public static void enviaEmail(Mensagem mensagem) throws EmailException {
 Email email = new SimpleEmail();
 email = conectaEmail();
 email.setSubject(mensagem.getTitulo());
 email.setMsg(mensagem.getMensagem());
 email.addTo(mensagem.getDestino());
 String resposta = email.send();
 FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(FacesMessage.SEVERITY_INFO, "E-mail enviado com sucesso para: " + mensagem.getDestino(), "Informação"));
 }
}

Como vocês observam, acima coloquei quatro constantes, uma para usuario, outra senha, outra endereço do servidor smtp, outra onde você indicará o seu e-mail.
Criamos também dois métodos estáticos, para acessarmos sem precisar instanciar a classe. O método conectaEmail() conecta-se ao servidor de e-mail e retorna um objeto do tipo Email. No método enviaEmail() preenchemos o objeto Email com os dados do objeto Mensagem, que são passados como parâmetro, e depois chamamos o método email.send() para enviar o e-mail.
Para verificar erros no envio da mensagem dizemos que o método poderá lançar uma exceção EmailException e que o método que utilizá-lo deverá trata-lo, no nosso caso trataremos no controller.
Veja abaixo a classe IndexController.java
public class IndexController {

 private Mensagem mensagem = new Mensagem();

 public Mensagem getMensagem() {
 return mensagem;
 }
 public void setMensagem(Mensagem mensagem) {
 this.mensagem = mensagem;
 }

 public void enviaEmail() {
 try {
 EmailUtils.enviaEmail(mensagem);
 } catch (EmailException ex) {
 FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(FacesMessage.SEVERITY_ERROR, "Erro! Occoreu um erro ao enviar a mensagem.", "Erro"));
 Logger.getLogger(IndexController.class.getName()).log(Level.SEVERE, null, ex);
 }
 }

 public void limpaCampos() {
 mensagem = new Mensagem();
 }

}</pre>

Através do método enviaEmail() nós chamamos o método enviaEmail(Mensagem mensagem) da classe EmailUtils.java e tratamos a Exceção lançada.
Abaixo veja a nossa view index.xhtml:
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
 xmlns:p="http://primefaces.prime.com.tr/ui"
 xmlns:f="http://java.sun.com/jsf/core"
 xmlns:h="http://java.sun.com/jsf/html">
 <h:head>
 <title>Exemplo de Envio de e-mail.</title>
 <link href="#{facesContext.externalContext.requestContextPath}/resources/css/custom-theme/skin.css" rel="stylesheet" type="text/css" />
 </h:head>
 <h:body>
 <p:outputPanel id="outputPanelMail">
 <h:form>
 <p:panel header="Envio de e-mail" style="width: 550px">
 <p:messages/>
 <h:panelGrid columns="2">
 <h:outputText value="Para: "/>
 <h:inputText value="#{indexController.mensagem.destino}" size="66"/>
 <h:outputText value="Título: "/>
 <h:inputText value="#{indexController.mensagem.titulo}" size="66"/>
 <h:outputText value="Mensagem: "/>
 <h:inputTextarea value="#{indexController.mensagem.mensagem}" cols="63" rows="10"/>
 </h:panelGrid>
 <p:commandButton value="Enviar e-mail" image="ui-icon-mail-closed" action="#{indexController.enviaEmail}" update="outputPanelMail"/>
 <p:commandButton value="Limpar campos" image="ui-icon-circle-close" action="#{indexController.limpaCampos}" update="outputPanelMail"/>
 </p:panel>
 </h:form>
 </p:outputPanel>
 </h:body>
</html>

Abaixo vejam como ficou:


É isso ai pessoal, nos próximos posts mostrarei como mandar e-mail com anexo, e-mail html e como criar validadores para o e-mail.
Valeu! E até o próximo post!