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

Você já pensou em ser palestrante em algum evento ?

Você já deve ter participado de algum evento e pensado como deve ser legal ser palestrante... E para falar a verdade, é muito bom mesmo. Eu adoro, o Vinicius adora e conheço muitas pessoas que curtem cada minuto da participação no evento como palestrante. Com certeza é uma responsabilidade a mais. Você sente medo, adrenalina, tem que se preparar. Literalmente coloca a cara a tapa para qualquer pessoa te avaliar em todos os sentidos. Qual o seu tom de voz?  Seus slides são legais? Você manja mesmo ?  Seu português está ok?  E as palavras em inglês ?  Teve algum deslize técnico? E MUITO mais.  Mas é claro que a exposição tem dois lados... e os resultados podem ser ótimos. Normalmente conhecemos mais pessoas como palestrantes e podem surgir boas oportunidades de negócio. É sempre positivo ter uma nova referência positiva quando as pessoas buscam nosso nome no Google, podemos fazer a diferença para quem está assistindo a palestra e muito mais.  No The Developer's

TDC INNOVATION lança University Pass

Modalidade de ingresso tem como objetivo ajudar na capacitação dos universitários Uma pesquisa realizada em 2020 pela Associação Brasileira das Empresas de Tecnologia da Informação e Comunicação (Brasscom) diz que até o ano de 2024 o Brasil precisará de cerca de 420 mil profissionais na área de Tecnologia da Informação. Porém, por ano, a mesma pesquisa diz que o país forma apenas 46 mil profissionais capacitados no nicho. Pensando nisso, para ajudar na formação e capacitação desses jovens profissionais, o TDC INNOVATION, segunda edição do ano do The Developer's Conference, lança o University Pass, modalidade de ingresso que possibilita aceso digital gratuito a todas as palestras do evento, ou com 50% de desconto para quem preferir ir pessoalmente. Com o tema central “Desafios para a criação do futuro Digital”, o TDC INNOVATION ocorrerá entre 1 e 3 de junho, de forma híbrida: presencialmente no Centro de Convenções CentroSul, em Florianópolis, e com transmissão simultaneamente pela

Inscrever sua equipe em eventos de TI vale a pena? Entenda aqui

Os eventos de TI são importantes para o aprendizado contínuo, especialmente em uma área tão dinâmica, como a de tecnologia. A necessidade de estar sempre por dentro das tendências pode esbarrar em algumas objeções, como investir em especializações pouco práticas ou opções pulverizadas de mercado. Por isso, participar de conferências e assistir palestras de especialistas é uma excelente oportunidade para sua equipe se desenvolver. O melhor de participar de eventos de TI é expandir os conhecimentos e habilidades independentemente da experiência específica, seja um desenvolvedor web ou full stack, por exemplo, as conferências de tecnologia podem ajudar o profissional a se aperfeiçoar. Isso ocorre devido ao contato com outros especialistas e colegas da mesma área. Além disso, é possível descobrir novas soluções e fazer networking . Neste artigo, você conhecerá as vantagens da sua equipe participar em eventos de TI. Aproveite a leitura! Vantagens de participar de eventos de TI Se o seu ob

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

Segurança da informação no alvo: o que esperar do futuro?

A segurança da informação não se trata apenas de proteger os dados contra acesso não autorizado. Na prática, refere-se aos recursos que impedem: uso; registro; inspeção; divulgação; interrupção; modificação; destruição de dados. O uso de dados pode abranger desde um perfil nas redes sociais a detalhes financeiros, biometrias ou novos projetos. Por isso, a preocupação com a proteção dos dados é crescente, tanto para empresas quanto clientes. Para muitas pessoas, a coleta de dados é considerada invasão de privacidade, criando desconfiança do titular dos dados, pois o uso dos dados pode ser facilmente corrompido, utilizado para fins não declarados. Apesar de o uso dos dados terem impulsionado os avanços tecnológicos na última década, as organizações lidam com o desafio de distinguir dados de informações pessoais de modo a proteger a privacidade e as preferências dos clientes. Neste artigo, abordaremos o impacto da segurança da informação e o que esperar do futuro. Confira casos conhecido

TDC ONLINE: SUA PLATAFORMA DE PALESTRAS GRAVADAS DO TDC DISPONÍVEL

Além do conteúdo ao vivo transmitido online nas edições do TDC, agora você pode ter acesso à centenas de palestras gravadas, através da nossa nova plataforma de vídeos - o TDC Online, que reúne todas as Trilhas premium, Stadium e Salas dos Patrocinadores das edições anteriores de 2022, TDC Innovation e TDC Connections.  Para acessar, basta clicar na edição em que você participou ( TDC Innovation ou TDC Connections ); Fazer o mesmo login (com e-mail e senha) cadastrados na hora de adquirir ou resgatar o seu ingresso no TDC; E clicar na Trilha de sua opção, e de acordo com a modalidade do seu ingresso. Logo em seguida, você será direcionado para a seguinte página com a lista de todas as palestras por Trilha: Pronto! Agora você tem acesso à centenas de palestras gravadas da sua área de interesse, para assistir como e quando quiser! Caso tenha esquecido a senha, clique na opção "Esqueci a senha" , insira o e-mail que você realizou para o cadastro no evento, e aparecerá a op