Pular para o conteúdo principal

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

Comentários

Flavio Horita disse…
Implementei da forma com que voce explicou

Entretanto o segunte erro apareceu:
"java.lang.NoClassDefFoundError : javax/mail/Address"

Meu manifest, classpath esta tudo certo!

ja teve esse erro?
Jackson Emmerich disse…
Deve estar faltando uma biblioteca.
Só que eu também não sei qual é?
Alguém sabe qual é?
Flavio,
Apesar de você dizer que seu classpath está correto, mas devido ao erro apresentado, acredito que você compilou com o classpath configurado corretamente, porém na execução a biblioteca mail.jar (onde encontramos a classe javax.mail.Address e outras utilizadas) não está devidamente configurada no classpath.
Exemplos:
Compilando
javac -cp caminhoDoJar/mail.jar;. br/eti/castro/blog/samples/email/MailSender.java
Executando
java -cp caminhoDoJar/mail.jar;. br.eti.castro.blog.samples.email.MailSender

Espero que ajude

Qualquer dúvida estou a disposição
Marcelo de Castro
Jack,

É isso mesmo, na hora da execução a classe javax.mail.Adress não foi encontrada por não estar no classpath. Esta classe e outras que utilizamos estão na biblioteca mail.jar.

Abraços
Renan Rodrigues disse…
Este comentário foi removido pelo autor.
Unknown disse…
Muito bom! pena que excluíram este item da ACADEMIA JAVA WEB; em 2h no máximo daria pra explicar e exemplificar, muito útil envio de e-mail
Anônimo disse…
Recebo esse erro ao enviar o email:

DEBUG: setDebug: JavaMail version 1.5.3
DEBUG: getProvider() returning javax.mail.Provider[TRANSPORT,smtp,com.sun.mail.smtp.SMTPTransport,Oracle]
DEBUG SMTP: need username and password for authentication
DEBUG SMTP: useEhlo true, useAuth true
DEBUG SMTP: trying to connect to host "smtp.gmail.com", port 587, isSSL false
Exception in thread "main" java.lang.RuntimeException: com.sun.mail.util.MailConnectException: Couldn't connect to host, port: smtp.gmail.com, 587; timeout -1;
nested exception is:
java.net.SocketException: Permission denied: connect
at projekt.JavaMail.main(JavaMail.java:55)
Caused by: com.sun.mail.util.MailConnectException: Couldn't connect to host, port: smtp.gmail.com, 587; timeout -1;
nested exception is:
java.net.SocketException: Permission denied: connect
at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:2054)
at com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:697)
at javax.mail.Service.connect(Service.java:386)
at javax.mail.Service.connect(Service.java:245)
at javax.mail.Service.connect(Service.java:194)
at javax.mail.Transport.send0(Transport.java:253)
at javax.mail.Transport.send(Transport.java:124)
at projekt.JavaMail.main(JavaMail.java:50)
Caused by: java.net.SocketException: Permission denied: connect
at java.net.DualStackPlainSocketImpl.connect0(Native Method)
at java.net.DualStackPlainSocketImpl.socketConnect(DualStackPlainSocketImpl.java:79)
at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:345)
at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)
at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)
at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:172)
at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
at java.net.Socket.connect(Socket.java:589)
at java.net.Socket.connect(Socket.java:538)
at com.sun.mail.util.SocketFetcher.createSocket(SocketFetcher.java:329)
at com.sun.mail.util.SocketFetcher.getSocket(SocketFetcher.java:236)
at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:2020)
... 7 more
Java Result: 1


Peguei um código de outra página e as informações batem com aqui.
Por estar dentro da rede da minha empresa, eu add o endereço de proxy(não o ip, o endereço) e a porta mas não conecta.
Penso que seja devido ao firewall correto???

Este comentário foi removido pelo autor.
Bruno

O problema está na autenticação com o servidor smtp do Gmail:
java.net.SocketException: Permission denied: connect

Segue um trecho com o uso de Authenticator:

private Session getGmailSession() {
Authenticator authenticator = new Authenticator();

Properties properties = new Properties();
properties.setProperty("mail.smtp.submitter", authenticator
.getPasswordAuthentication().getUserName());
properties.setProperty("mail.smtp.auth", "true");
properties.setProperty("mail.smtp.host", type.mailHost);
properties.setProperty("mail.smtp.port", type.port);
properties.put("mail.smtp.socketFactory.port", type.port);
properties.put("mail.smtp.socketFactory.class", SSL_FACTORY);
properties.put("mail.smtp.socketFactory.fallback", "false");

return Session.getInstance(properties, authenticator);
}

private class Authenticator extends javax.mail.Authenticator {
private PasswordAuthentication authentication;

public Authenticator() {
authentication = new PasswordAuthentication(type.username, type.password);
}

protected PasswordAuthentication getPasswordAuthentication() {
return authentication;
}
}

Postagens mais visitadas deste blog

Entendendo como funciona a programação de computadores: linguagens de programação, lógica, banco de dados

Nesse post, diferente dos últimos que foram mais enfáticos nas experiências com tecnologias, vou focar um pouco mais nos profissionais que estão começando, ou pretendem ingressar na área de desenvolvimento de software, falando sobre conceitos fundamentais relacionados a programação em geral . Mercado de trabalho para programação Conforme já sabemos, o mercado de desenvolvimento de software, especialmente no Brasil, continua em franca expansão, sendo que cada vez mais as empresas buscam desenvolver seus próprios sistemas usando as mais diferentes e novas tecnologias. Algumas matérias interessantes: As seis profissões mais valorizadas em 2010 no IDG Now! Muitas vagas e sensação de reaquecimento da economia Por isso, a área de desenvolvimento de software tem despertado interesse em muitos profissionais de outras áreas que desejam mudar de profissão, já que as oportunidades de trabalho tendem a ser maiores. Esse é um perfil presente em muitos dos clientes da Globalcode que acabou m

Seja um Palestrante do TDC Connections 2022

A Equipe TDC está muito feliz e orgulhosa em começar mais uma jornada de eventos em 2022 e criar muitas oportunidades! Agora, chegou o momento para você que sempre quis ser palestrante mas não teve oportunidade, e também de quem já é palestrante experiente, e está ansioso para compartilhar aquela nova prática ou caso de sucesso fresquinho, submeter sua palestra para o TDC Connections e co-criar conosco o maior evento de desenvolvedores do Brasil.  Link de inscrição: https://cfp-conn.thedevconf.com.br/?_ga=2.103579840.1386204218.1643036190-1988609034.1631800014 Confira aqui o calendário do TDC 2022. Nesta edição teremos muitas novidades e você poderá palestrar de forma Online ou Presencial! Entenda como vai funcionar o TDC CONNECTIONS: Nesta edição, além de todo o conteúdo dividido em Trilhas transmitidas ao vivo (13 trilhas simultâneas) também teremos dois eventos híbridos em Recife e Belo Horizonte, que terão uma trilha por dia, ao vivo, para um público limitado, seguindo protocolo

JSON fácil em Java com GSon !

Ola pessoal ! O formato JSON ( J ava S cript O bject N otation) vem se consagrando cada vez mais na comunicação de dados, principalmente nos dispositivos móveis devido a esse formato ser mais leve que o XML e também mais legível. Uma prova disso são as inúmeras bibliotecas que existem para manipular esse formato, e no caso do Android, o suporte ao JSON é nativo. Mas apesar de ter esse suporte nativo, algumas operações devem ser feitas manualmente e o código acaba ficando um pouco verboso e repetitivo, já que para cada objeto que se deseja transmitir é necessário fazer um método que lê as propriedades do JSON e faz as devidas atribuições no seu objeto Java. Vamos supor o seguinte objeto sendo transmitido em JSON: {   user: {     id: 123456,     name: "Neto Marin",     username: "netomarin",     email: "netomarin@globalcode.com.br"   } } Se você fosse tratar um Webservice que envia esse JSON para o seu aplicativo Android, além de criar a o

PrimeFaces com JSF2 no ScrumToys

O JSF traz um grupo de componentes visuais prontos, a partir da versão 2.0 com suporte a Ajax nativo! Melhor que isso é a possibilidade de customizar ou utilizar uma suíte de componentes prontos para "turbinar" o projeto com o minimo de esforço. PrimeFaces é uma suite de componentes JSF customizados, a maioria com suporte a ajax, conta com um Kit para desenvolvimento mobile, é open source, a documentação é razoável, facíl de instalar e usar. Nesse exemplo utilizo o PrimeFaces 2.0.0, versão com suporte a JSF 2, no ScrumToys. Conheçe o ScrumToys ? ScrumToys é um Projeto Exemplo para JavaServer Faces 2.0 dentro do NetBeans 6.8, criado e mantido pelo time da Globalcode. É interessante que você tenha o NetBeans 6.8 para fazer esse exemplo, senão tiver baixe aqui . Baixe também, aqui , o PrimeFaces e o configure no NetBeans como biblioteca para o ScrumToys. Inicialmente o PrimeFaces requer a runtime JSF, mas isso pode variar dependendo de quais componentes você utilize, mai

Top 4 desafios do gestor de TI e como superá-los

  O setor de TI se apresenta como uma área essencial ao desenvolvimento e expansão da empresa, em especial, aquelas que têm a criação de soluções tecnológicas como core business. O mercado dinâmico da atualidade, com mudanças constantes e concorrência elevada, exige aperfeiçoamento do gestor de TI para se destacar em suas atividades. Pensando em te ajudar nesse processo, separamos 4 desafios do gestor de TI e como superá-los. Acompanhe! Transformação digital na atualidade A transformação digital é constante e define os caminhos futuros da nossa sociedade. Por isso, o setor de TI vem se tornando mais estratégico em empresas de todos os segmentos. O home office é um bom exemplo de como a revolução digital está se processando. Vamos falar sobre ele e outros pontos nos tópicos a seguir. Confira! Desafios do gestor de TI Para se manter atualizado sobre o tema e permanecer competitivo no mercado, é  necessário acompanhar as tendências de TI . Confira, abaixo, alguns dos principais desafios d

TDC Digital: o que você precisa saber para transformar sua carreira em 2022

O TDC Digital é o maior evento de TI do mercado e proporciona crescimento profissional a partir de palestras com especialistas e oportunidades de networking com o mundo todo, direto da sua casa. Através da escolha individual de cada participante é possível obter experiências imersivas e transformadoras conforme o tema-chave de cada trilha.  O evento também é o lugar ideal para ajudar no desenvolvimento de carreiras, permitindo que qualquer pessoa com vontade — e um tema interessante — seja palestrante e compartilhe suas experiências e conhecimentos. Para aqueles que querem  participar como ouvinte a plataforma do TDC favorece conferências dinâmicas, e o encontro de diversas comunidades e ecossistemas de TI. E, após a escolha de uma trilha, fica mais fácil acompanhar especialistas para aprender e se inspirar. Em 2021, o The Developer’s Conference (TDC) foi 100% digital e, em três dias de evento, contou com mais de 300 horas de conteúdos , incluindo: Agile; Testes; Design; Web e Mobile;