Pular para o conteúdo principal

JavaMail: Enviando mensagem HTML com anexos

Introdução

Depois do post "JavaMail: Enviando e-mail com Java", que apresentava como enviar um e-mail com Java, resolvi complementar a assunto apresentando como enviar uma mensagem formatada, em HTML, e também como realizar o envio de anexos.

Bibliotecas

Além da biblioteca JavaMail, veja mais no post anterior, é necessário incluir o JavaBeans Activation Framework (JAF), apenas se a versão utilizada for anterior ao JSE 6.0, que já tem o JAF incluso.
O JAF está disponível em http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html, e neste download encontramos, alguns exemplos na pasta demo, documentação, incluindo javadocs, na pasta docs e a biblioteca activation.jar, que deve ser acrescentada no classpath da aplicação para versões anteriores ao JSE 6.0.

Exemplo

Primeiramente devemos realizar a configuração da javax.mail.Session e da javax.mail.internet.MimeMessage, estes passos podem ser vistos no post anterior.
Agora vamos montar uma mensagem HTML em uma String:
String htmlMessage = "< h t m l > Código HTML da mensagem </ h t m l >";
Para configurarmos a mensagem com os anexos (partes da mensagem), precisamos utilizar um objeto javax.mail.internet.MimeMultipart, que será formado por várias partes (javax.mail.internet.MimeBodyPart) e para tanto vamos instanciá-lo conforme segue:
Multipart multipart = new MimeMultipart();
A primeira parte da MimeMultipart, será a mensagem em HTML, então vamos criar e configurar um objeto javax.mail.internet.MimeBodyPart que representa uma parte da mensagem e adicioná-lo ao multipart:
MimeBodyPart attachment0 = new MimeBodyPart();
attachment0.setContent(htmlMessage,"text/html; charset=UTF-8");
multipart.addBodyPart(attachment0);
Observe que utilizamos o método setContent passando a String com a mensagem HTML e outra passando o mime type da mensagem "text/html; charset=UTF-8".

No nosso exemplo a segunda parte da MimeMultipart, será uma imagem, então criaremos um java.io.File referenciando o arquivo desejado.
String pathname = "duke.png";//pode conter o caminho
File file = new File(pathname);
Então criaremos mais um MimeBodyPart para a imagem que será anexada, para tanto faremos uso das classes javax.activation.FileDataSource e javax.activation.DataHandler do JAF, que realizarão o trabalho pesado de leitura, descoberta e configuração do tipo do arquivo, para inclusão do anexo.
MimeBodyPart attachment1 = new MimeBodyPart();
attachment1.setDataHandler(new DataHandler(new FileDataSource(file)));
attachment1.setFileName(file.getName());
multipart.addBodyPart(attachment1);
Vale observar que o nome do anexo não precisa ser necessariamente o mesmo do arquivo, visto que, conforme apresentado no código anterior, esta configuração é feita por meio do método setName, então para configurar com outro nome qualquer, bastaria utilizar o referido método da seguinte forma:
attachment1.setFileName("outroNomeQualquer.png");
Então, após adicionar todas as partes desejadas na javax.mail.internet.MimeMultipart , por meio do método addBodyPart basta adicioná-la como conteúdo da javax.mail.internet.MimeMessage e então efetivamente enviar a mensagem, como pode ser visto no trecho de código abaixo:
message.setContent(multipart);
Transport.send(message);

MailSenderPlus.java

Segue o código completo da classe que envia um e-mail com mensagem formatada e anexo.
package br.eti.castro.blog.samples.email;

//imports omitidos

public class MailSenderPlus {
 //o tratamento de excessoes foi simplificado (throws MessagingException)
 //para facilitar o entendimento do exemplo
 public static void main(String[] args) throws 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("Enviando uma mensagem formatada com anexo");
  
  // conteudo html que sera atribuido a mensagem
  String htmlMessage = "< h t m l > Código HTML da mensagem ";

  //criando a Multipart
  Multipart multipart = new MimeMultipart();

  //criando a primeira parte da mensagem
  MimeBodyPart attachment0 = new MimeBodyPart();
  //configurando o htmlMessage com o mime type
  attachment0.setContent(htmlMessage,"text/html; charset=UTF-8");
  //adicionando na multipart
  multipart.addBodyPart(attachment0);
  
  //arquivo que será anexado
  String pathname = "duke.png";//pode conter o caminho
  File file = new File(pathname);

  //criando a segunda parte da mensagem
  MimeBodyPart attachment1 = new MimeBodyPart();  
  //configurando o DataHandler para o arquivo desejado
  //a leitura dos bytes, descoberta e configuracao do tipo
  //do arquivo serão resolvidos pelo JAF (DataHandler e FileDataSource)
  attachment1.setDataHandler(new DataHandler(new FileDataSource(file)));
  //configurando o nome do arquivo que pode ser diferente do arquivo
  //original Ex: setFileName("outroNome.png")
  attachment1.setFileName(file.getName());
  //adicionando o anexo na multipart
  multipart.addBodyPart(attachment1);

  //adicionando a multipart como conteudo da mensagem 
  message.setContent(multipart);
  
  //enviando
  Transport.send(message);
  
  System.out.println("E-mail enviado com sucesso!");
 }
}

E para finalizar me repito, afinal nunca é demais alertar, não use para 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.

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

O Cotidiano disse…
Bom dia, estou usando esse exemplo que você disponibilizou e implementei para enviar 2 anexos. O problema é que vai os dois anexos, porém um é sempre 0 byte...

Teria algum exemplo que nãoocorre isso?
Ana Abrantes disse…
Como você fez?
Para incluir outro anexo, basta repetir o trecho que cria um novo MimeBodyPart e adiciona ao objeto multipart.
[]s
Ana
Unknown disse…
Muito bom ... Parabéns e obrigado!!!
Felipe disse…
Ola fiz um formulário simples de texto e quero criar apenas um anexo mas dá erro poderia me ajudar? Código está todo pronto, só não consigo implementar bendito do anexo.
Unknown disse…
estou tendo esse erro e sim, adicionei as bibliotecas

java.lang.NoClassDefFoundError: com/sun/mail/util/PropUtil

Postagens mais visitadas deste blog

TDC BUSINESS, chega a São Paulo com novas trilhas de Inteligência Artificial e Inovação

Maior conferência de profissionais de tecnologia do Brasil abordará temas em alta no momento como, por exemplo, Inteligência Artificial, Segurança, Ciência de Dados e Inovação O TDC BUSINESS, a 17° edição do The Developer's Conference na cidade de São Paulo, que acontece entre os dias 19 e 21 de Setembro, reunirá profissionais e especialistas da área para troca de experiência, compartilhamento de conteúdos e networking. Com o tema central: “Tecnologia para negócios transformadores”, o evento será totalmente híbrido, ocorrendo presencialmente no espaço Pro Magno, e com transmissão simultânea e atividades de network pela internet. A expectativa é reunir mais de 14.000 pessoas, somando a participação presencial e online.   Segundo Yara Mascarenhas, Fundadora e Host do Evento, “nosso objetivo com o TDC é inspirar a colaboração entre os profissionais e empresas para construir uma nova realidade para o mercado de TI.  Vamos juntar tecnologia e negócios com as trilhas técnicas...

Site da Globalcode: Design e integração com JSF, Facelets, RichFaces e JBossSeam

O site da Globalcode foi criado por uma agência e depois desenvolvido internamente, utilizando algumas das nossas tecnologias preferidas: - JavaServer Faces - Facelets - RichFaces - JPA - JBoss Seam (que não poderia faltar na nossa arquitetura). O site é abastecido com informações do sistema de gestão educacional, o GES ( Global Education System ). Na prática isto quer dizer que as turmas, o conteúdo dos cursos, o Orçamento Eletrônico , matrícula eletrônica em minicursos gratuitos, páginas Unidades Globalcode , tudo vem do GES. Ou seja, estes dados são alterados automaticamente quando alteramos os dados no GES e não precisa passar nas mãos de ninguém da área de TI. E o pessoal de vendas e negócios adora ficar livre do pessoal da TI. A utilização de Facelets gerou muitos benefícios e facilidades, e agora até o André Frota , que era mais designer que programador fica aflito para eliminar uma ou outra página 100% HTML, que não usa Facelets. Além dos muitos novos requisitos ...

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...

12 ESQUENTAS TDC ESPERANDO POR VOCÊ

O TDC nasceu do sonho de profissionais que valorizam o compartilhamento de conhecimento, experiências e oportunidades entre as comunidades de desenvolvedores.  Por isso, o crescimento do TDC nunca poderia ficar longe do crescimento das comunidades! Pensando nessa união, criamos um projeto quente: O ESQUENTA TDC ! Visando divulgar os meetups de comunidades que querem transformar e inspirar carreiras, foi co-criado este projeto lindo e cheio de apoio, onde o TDC abraça meetups de diversas comunidades espalhadas pelo Brasil e elas contribuem com a divulgação da edição regente.  O TDC Innovation vai rolar de 14 a 16 de JUNHO, mas até lá vão acontecer muitos encontros incríveis!  Fique por dentro das comunidades que vão participar, quais temas irão abordar e claro as datas e locais para você participar. 💥Esquentas TDC Innovation 2023: 24/05 - Esquenta TDC: Carreira e Desenvolvimento Presencial em Floripa das 19:00 as 21:30 com inscrição AQUI Comunidade: Google Developer...

Dando o primeiro passo para se tornar um jEDI

Muitos anos atrás um grande mestre nos disse que para se tornar um mestre JEDI era necessário conhecer como funciona o Garbage Collector e como escrever o seu próprio ClassLoader . Como um Padawan dedicado que não media esforços para se tornar um mestre e sem medo de misturar Star Trek com Star Wars, comecei a estudar como fazer tuning em aplicações Java controlando a alocação de memória realizada pela JVM. Recentemente participei de duas consultorias onde foi necessário resolver problemas de performance fazendo uma análise da distribuição de memória entre as áreas geracionais dentro de uma JVM da Sun em execução e avaliar como a atuação do Garbage Collector influenciava a aplicação. Como parte dos estudos e dos trabalhos de consultoria realizados, consegui dar um pequeno passo em direção à força! Agora compartilho um pouquinho do que aprendi. Para ter uma ideia de como uma configuração errada da alocação de memória dedicada à JVM (normalmente via parâmetros de linhas de comando -...

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...