JavaMail: Enviando e-mail com Java

Introdução

Além da necessidade de envio de e-mail ser comum a várias aplicações, foi a pergunta de um aluno da Academia Java, “Como enviar um e-mail com Java?”, que me motivou a escrever este post sobre JavaMail.

JavaMail

Para realizar o envio de e-mail por meio de uma aplicação Java, precisamos da biblioteca JavaMail, pois ela não é incluída no Java SE. A biblioteca está disponível em http://www.oracle.com/technetwork/java/index-138643.html.

Neste download, além da biblioteca mail.jar que inclui a implementação completa da API e providers, também é disponibilizada a documentação da biblioteca (javadoc) na pasta docs, alguns exemplos na pasta demo e partes da implementação em lib.

A forma mais simples de utilizar a JavaMail e incluir o mail.jar, porém para uma aplicação que só envia e-mail como o nosso exemplo, necessitamos apenas dos arquivos mailapi.jar e smtp.jar, economizando 177KB. Como a economia é pouca e as aplicações evoluem, vamos adicionar o mail.jar no classpath da aplicação.

Exemplo

Como o objetivo é realizar o envio de e-mail, precisamos configurar o servidor de envio (SMTP), para tanto vamos criar um objeto java.util.Properties , e adicionar a propriedade "mail.host" com o servidor que será utilizado para envio:

//o valor "smtp.host.com.br" deve ser alterado para o seu servidor SMTP
props.put("mail.host","smtp.host.com.br"); 

Para ter acesso ao provider de envio de email, vamos obter um objeto javax.mail.Session, por meio do método estático getDefaultInstance passando o objeto props com a configuração do servidor SMTP:

Session session = Session.getDefaultInstance(props);

Agora vamos criar uma mensagem javax.mail.internet.MimeMessage vazia, com o construtor que recebe um objeto do tipo javax.mail.Session:

MimeMessage message = new MimeMessage(session);

Para configurar os endereços de remetente (from) e de destinatário (to) da mensagem, vamos criar dois objetos javax.mail.internet.InternetAddress e configurar o objeto message, conforme segue:

Address from = new InternetAddress("remetente@host.com");
Address to = new InternetAddress("destinatario@host.com");
message.setFrom(from);
message.addRecipient(RecipientType.TO, to);

Para configurar o endereço do remetente da mensagem, utilizamos o método setFrom e para configurar o destinatário utilizamos o método addRecipient, que pode ser chamado diversas vezes para encaminhar a mensagem para vários destinatários, este método recebe, além do endereço (segundo parâmetro), o primeiro parâmetro com um RecipientType, para configurar o destinatário “para” utilizamos o RecipientType.TO, “com cópia” e “com cópia oculta” utilizamos RecipientType.CC e RecipientType.BCC respectivamente.

Então realizar a configuração da data de envio, por meio do método setSentDate, do assunto, por meio do método setSubject e do texto da mensagem, setText conforme segue:

message.setSentDate(new Date());
message.setSubject("Assunto da mensagem");
message.setText("Texto da mensagem"); 

O método setSentDate configura o cabeçalho “Date” da mensagem, se a data não for configurada, o referido cabeçalho não será enviado.

Agora que a mensagem esta pronta, vamos utilizar enviar utilizando o método estático send da classe javax.mail.Transport:

Transport.send(message);

MailSender.java

Segue o código completo da classe que envia um e-mail.

package br.eti.castro.blog.samples.email;
//imports omitidos
public class MailSender {
 //o tratamento de excessoes foi simplificado (throws AddressException, MessagingException)
 //para facilitar o entendimento do exemplo
 public static void main(String[] args) throws AddressException, MessagingException {
  //objeto para definicao das propriedades de configuracao do provider
  Properties props = new Properties();
  //o valor "smtp.host.com.br" deve ser alterado para o seu servidor SMTP
  props.put("mail.host","smtp.host.com.br"); 
  //obtendo um Session com a configuração 
  //do servidor SMTP definida em props
  Session session = Session.getDefaultInstance(props);
  //criando a mensagem
  MimeMessage message = new MimeMessage(session);
  //substituir pelos e-mails desejados
  Address from = new InternetAddress("remetente@host.com");
  Address to = new InternetAddress("destinatario@host.com");
  //configurando o remetente e o destinatario
  message.setFrom(from);
  message.addRecipient(RecipientType.TO, to);
  //configurando a data de envio,  o assunto e o texto da mensagem
  message.setSentDate(new Date());
  message.setSubject("Assunto da mensagem");
  message.setText("Texto da mensagem!");
  //enviando
  Transport.send(message);
 }
}

Isso é o que você precisa para enviar uma mensagem com Java, porém é necessário cuidado com a utilização deste código em laços de repetição, ou seja, enviar uma grande quantidade de mensagens em um curto de período de tempo, pois seu endereço, domínio ou IP podem cair em uma balcklist, e seus e-mails serem classificados como SPAM.

Afinal, você gosta de SPAM? ... nem EU! J

Até mais!
Marcelo de Castro
http://blog.castro.eti.br
http://twitter.com/mcastroinfo
http://www.globalcode.com.br/instrutores/MarceloCastro
Outros posts: http://blog.globalcode.com.br/search/label/MarceloCastro