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

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

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

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;

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

Inspire a mudança com a liderança ágil

A liderança ágil é essencial para que uma organização realize mudanças de negócios significativas. Ser líder é uma tarefa desafiadora, especialmente em um cenário de constantes transformações, principalmente na forma de lidar com a relação empresa e pessoal. Pesquisas sobre liderança na era digital revelam que algumas soft skills têm sido substituídas por outras, o profundo conhecimento na área de negócio, ser referência nas tecnologias utilizadas, ter foco total no prazo e nas entregas e conhecer um arsenal de técnicas e ferramentas, têm dado espaço a habilidades, como: empatia; adaptabilidade; visão e propósito; engajamento constante; senso de equipe.   A colaboração entre pessoas de todos os níveis hierárquicos são vitais, afinal, as equipes estão trabalhando para o mesmo objetivo: o encantamento e atendimento das necessidades do cliente que proporcionarão um crescimento sustentável da organização. Com propósito claro, estratégia e prioridades definidas, os times desfrutam de uma