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

10 reasons why we love JSF

1. One-slide technology: it's so simple that I can explain basic JSF with one slide. 2. Easy to extend: components, listeners, render kit, Events, Controller, etc. 3. Real-world adoption: JBoss, Exadel, Oracle, IBM, ... 4. Architecture model: you can choose between more than 100 different architecture. 5. Open-mind community: using JSF you are going to meet very interesting people. 6. We are using JSF the last 5 years and we found very good market for JSF in Brazil 7. Progress: look to JSf 1.1 to JSF 1.2, JSF 1.2 to JSF 2.0. People are working really hard! 8. Many professionals now available 9. It's a standard. It's JCP. Before complain, report and help! 10. Ed Burns, spec leader, is an old Globalcode community friend! EXTRA: My wife is specialist in JSF. She's my F1 for JSF :) Nice job JSF community! -Vinicius Senger

O que é Lógica de programação?

Este é o segundo de uma série de posts voltados aos leitores do blog que estão dando início à carreira de desenvolvimento de software. O assunto de hoje é a lógica de programação. Para ler antes: Entendendo como funciona a programação de computadores: linguagens de programação, lógica, banco de dados A lógica de programação é um pré-requisito para quem quer se tornar um desenvolvedor de software, independente da linguagem de programação que se pretende utilizar. Mas o que é de fato a Lógica de Programação e como saber se eu tenho esse pré-requisito? A lógica de programação nada mais é do que a organização coerente das instruções do programa para que seu objetivo seja alcançado. Para criar essa organização, instruções simples do programa, como mudar o valor de uma variável ou desenhar uma imagem na tela do computador, são interconectadas a estruturas lógicas que guiam o fluxo da execução do programa. Isso é muito próximo ao que usamos em nosso cotidiano para realizar atividad...

Alguma certificação Java nos seus planos em 2010 ?

A discussão sobre certificações é super polêmica, alguns acham muito importante, outros acham totalmente insignificante. Eu particularmente acho que é uma meta de aprendizado, que nos força a aprender bem detalhadamente uma tecnologia. É claro que é "burlável" quero dizer, todo mundo conhece alguém que é certificado e "não sabe nada". Mas, evidentemente quando você se prepara, estuda, vai aprender muitas coisas novas e solidificar ainda mais seu conhecimento. Eu sempre fui muito "orientada" por deadlines... estas metas nos obrigam a encaixar algumas horas de estudo nesta vida tão corrida. E o inicio do ano é muito bom para estas iniciativas, porque estamos um pouco mais descansados, com aquele espírito de inicio de ano. Imagine chegar em março e já ter cumprido uma das metas de final de ano, e estar com a certificação "tirada" ? Não acho que precisa ser um caçador de certificações, e tentar tirar todas as certificações possíveis, mas acho ...

Seja palestrante no TDC!

Os interessados em palestrar na maior plataforma de Inovação Aberta para desenvolvimento do ecossistema de teologia, tem até 25 de setembro para se inscrever A última edição do ano do TDC (The Developer's Conference), maior conferência para profissionais de tecnologia do Brasil, já tem data confirmada. O TDC Future, que acontece nos dias 6 a 8 de dezembro, em formato híbrido, ocorrerá presencialmente na UniRitter de Porto Alegre, e com transmissão simultânea pela plataforma Hopin. O evento traz como tema central: “O papel da tecnologia na construção do amanhã”, e reúne gestores, especialistas e profissionais da área para debater sobre o futuro da tecnologia, o impacto na vida das pessoas e seu papel na transformação da sociedade. A seleção de palestras nacionais e internacionais, ainda está com o Call4Papers aberto até 25 de setembro, os interessados em participar poderão submeter uma proposta por meio do site do evento . O tema deve estar vinculado a uma trilha específica, que é...

Facelets ainda mais divertido! Parte II

De volta ao Facelets , na primeira parte mantive o foco na utilização de templates e técnicas de reutilização visando maior agilidade para desenvolver telas com JSF , mas o Facelets vai bem além disso! Nesse post vou comentar e mostrar um pouco sobre a criação de componentes UI (User Interface) usando xht ml - na minha opinião esse é o grande diferencial da tecnologia. Com esse recurso é possível customizar / padronizar componentes usando xhtml + tags JSF + JavaScript + Css, sem código Java. A ideia é bem próxima ao Tag File em uma rápida comparação com JSP (JavaServer Pages), mas no caso do Facelets feito de uma forma ainda mais simples e com aderência a (infra)estrutura do JSF. Vou descrever o mesmo cenário da primeira parte, um sistema composto por vários cadastros ( C reate R ead U pdate D elete). Pensando especificamente em cada formulário, usando como exemplo um rascunho ou protótipo para o cadastro de Fornecedores, podemos assumir o seguinte formato: campos para preenchi...

JavaOne Brasil, dicas para submissão de palestras

Não quero parecer pretensiosa dando dicas para submissão de palestras para o JavaOne Brasil, mas sim repassar os tantos conselhos e sugestões recebidas pelos vetaranos do JavaOne: Bruno Souza e Leonardo Galvão que revisaram dezenas de submissões para o JavaOne e ajudaram a aprovar tantas palestras, e também misturar um pouco da minha experiência na seleção de palestras nos eventos realizados pela Globalcode e SouJava . 10 anos de JavaOne: http://www.globalcode.com.br/noticias/Globalcode10AnosNoJavaOne Os palestrantes ganham a entrada! A submissão pode ser feita em português! O passo mais importante para ser aprovado como palestrante no JavaOne é sem dúvida nenhuma submeter pelo menos uma palestra. Então, independente de qualquer coisa, participe, arrisque, divulgue.  Mas, se quiser aumentar as suas chances...   1) Leve a sério: peça para amigos fazerem uma leitura crítica do texto, e claro uma boa revisão ortográfica. 2) Submissão de várias palestras ou variações do ...