JavaMail API: Introdução com Microsoft Exchange

A API JavaMail apresenta uma excelente oportunidade para os desenvolvedores integrarem todas as capacidades avan�adas de correio eletr�nico em suas aplica��es contando com todos os benef�cios que essa API pode proporcionar. Entre os benef�cios que teremos destaca-se: a facilidade de desenvolvimento, o suporte a m�ltiplos protocolos e a integra��o flex�vel de avan�os futuros.

Tamb�m temos como destaque o servidor de comunica��es colaborativo Microsoft Exchange que � usado em praticamente todas as empresas de m�dio e grande porte que ajuda a organizar os e-mails de toda a corpora��o. Juntando o poder de ambos podemos construir aplica��es que podem enviar e-mails fornecendo alertas, avisos de problemas ou lembretes, progresso de rotinas, status de execu��o, entre in�meras outras funcionalidades.

No restante do artigo veremos melhor o que � o Microsoft Exchange e teremos uma boa compreens�o de algumas das capacidades da JavaMail API e como integrar as duas tecnologias. Tamb�m desenvolveremos um exemplo para ficar mais claro na pr�tica como podemos fazer uso das ferramentas.

Microsoft Exchange

O Microsoft Exchange � um servidor de comunica��es colaborativo baseado em e-mail projetado para grandes empresas. As licen�as do Microsoft Exchange podem ser compradas tanto na Microsoft que tamb�m � respons�vel por fabricar o produto quanto pelos seus revendedores. Caso a organiza��o use o Microsoft Exchange, mas n�o sabemos se realmente temos uma conta nele basta contatarmos o administrador de rede da empresa ou o suporte t�cnico para obter uma assist�ncia. O Exchange � um servidor de e-mail propriet�rio da Microsoft que pode ser instalado apenas em plataformas Windows Server e pode ser acessado por diversos clientes de diferentes plataformas como toda a fam�lia Unix, Linux, Windows e Mac Os.

A diferen�a para usu�rios dom�sticos � que estes n�o costumam ter uma conta no Exchange, ao inv�s disso, usu�rios dom�sticos usam uma conta de e-mail POP3 com um provedor de servi�os de internet (ISP) ou ent�o utilizam um servidor de e-mail Web como o Windows Live Mail ou o Gmail. Aqueles que n�o possuem conta do Exchange n�o podem usar recursos do Outlook que requerem o Exchange.

O Exchange ainda oferece uma grande gama de op��es de implanta��o, prote��o contra vazamento de informa��es, recursos avan�ados de conformidade, recursos que simplificam a administra��o, acesso com seguran�a atrav�s de qualquer plataforma, navegador web ou dispositivo atrav�s de protocolos que s�o padr�es na ind�stria, al�m tamb�m de armazenamento, arquivamento, reten��o de e-mails, alta disponibilidade, recupera��o de desastres e risco reduzido de Malware e Spam atrav�s de defesas embutidas contra v�rus e lixo eletr�nico e com suporte para uma variedade de produtos de seguran�a de terceiros.

O Microsoft Exchange possui tr�s vers�es, s�o elas: Microsoft Exchange 2003, Microsoft Exchange 2007, Microsoft Exchange 2010 e a mais atual Microsoft Exchange 2013. O grande concorrente do Microsoft Exchange no mercado atualmente � o IBM Lotus Notes.

O Microsoft Exchange Server possui m�ltiplos programas utilit�rios que vem juntamente com o seu pacote de instala��o para nos ajudar a executar e customizar o servidor Exchange. Uma das aplica��es mais �teis � o Exchange Management Console (EMC). Com esse utilit�rio, podemos visualizar e administrar todos os usu�rios e as caixas de e-mail que est�o conectadas ao servidor Exchange.

Segue na Figura 1 um exemplo de uma das ferramentas administrativas do Microsoft Exchange 2013 (Exchange Management Console).

Figura 1. Ferramenta de administra��o do Microsoft Exchange.

O Exchange Management Console tamb�m permite filtrar mailboxes, contatos, pastas p�blicas e grupos com bastante flexibilidade, definir e controlar limites, gerenciar grupos din�micos, gerenciar contatos e muito mais.

JavaMail API

A API JavaMail fornece um framework independente de plataforma e independente de protocolo para construir aplica��es de correio e de mensagens. A API JavaMail est� dispon�vel como um pacote opcional para o uso com a plataforma Java SE. Na plataforma Java EE a API JavaMail � inclu�da por padr�o, portanto n�o h� a necessidade de baixar o JAR, basta importa-la diretamente no c�digo.

JavaMail � uma API Java usada para enviar e receber e-mail via SMTP, POP3 e IMAP. JavaMail � constru�do na plataforma Java EE, mas tamb�m oferece um pacote opcional para uso em Java SE, como dito anteriormente.

Existe ainda outra implementa��o open source do JavaMail que � a GNU JavaMail. Esta API suporta apenas a vers�o 1.3 da especifica��o do JavaMail, al�m disso, esta API fornece o �nico NNTP que � livre, o que torna poss�vel a utiliza��o desta tecnologia para ler e enviar artigos de grupo de not�cias.

A API GNU JavaMail � uma implementa��o livre da especifica��o JavaMail API, vers�o 1.3. Todo o c�digo foi escrito a partir do zero, sem qualquer tipo de refer�ncia ao c�digo da Sun. Isso permite ao GNU JavaMail ser usado em um sistema operacional completamente livre, como o GNU/Linux ou o Hurd. O c�digo � otimizado para trabalhar com implementa��es livres do Java, mas nada impede que ele seja usado com qualquer JVM compat�vel.

A GNU JavaMail fornece um framework independente de protocolo para a constru��o de aplica��es de e-mail clientes em Java. A API em si oferece uma implementa��o completa de MIME e drivers para protocolos de mensagens individuais, conhecidos como provedores ou prestadores de servi�os. Al�m disso, a API tamb�m pode ser conectada ao framework JavaMail dinamicamente. V�rios provedores de protocolos padr�o da Internet est�o inclu�dos com o GNU JavaMail. Entre esses protocolos que est�o inclu�dos destacam-se: o protocolo SMTP, IMAP, POP3, NNTP inclusive com postagem para servidores de not�cias, o formato Unix mbox, e o formato Dan Bernstein's Maildir.

Todos esses provedores possuem recursos completos, e fornecer acesso criptograficamente seguro quando relevante. No entanto, se um determinado provedor ou funcionalidade que seja necess�rio para uma necessidade espec�fica n�o for encontrada, este provedor ou funcionalidade pode desenvolvida junto com a comunidade do GNU JavaMail.

A vers�o atual est�vel do GNU JavaMail � a vers�o 1.1.2 e est� atualmente dispon�vel no reposit�rio http://ftp.gnu.org/gnu/classpathx/mail-1.1.2.tar.gz. Al�m da biblioteca pode ser encontrado documenta��o, c�digo-fonte, etc.

Diferente da GNU JavaMail a vers�o atual da API oficial JavaMail � a 1.5.1 e cont�m 16 corre��es de bugs e melhorias em rela��o a �ltima vers�o. A �ltima vers�o foi lan�ada em 13 de novembro de 2013. Entre as novidades dessa vers�o destacam-se:

Suporte simples para QRESYNC (RFC 5162) e CONDSTORE (RFC 4551);
Suporte para WITHIN (RFC 5032) e ID (RFC 2971);
Suporte para grava��o de timeouts.

O projeto open source JavaMail mudou-se recentemente para a java.net. O c�digo fonte para a Implementa��o de Refer�ncia da API JavaMail j� est� dispon�vel no reposit�rio Mercurial no projeto JavaMail em java.net.

A maior parte do c�digo fonte do JavaMail � licenciada pelas seguintes licen�as: CDDL-1.1 e GPL-2.0 com algumas exce��es. O c�digo fonte dos programas demo est�o licenciados sobre a licen�a BSD.

Para baixar o JavaMail atrav�s do maven podemos utilizar o arquivo pom.xml, conforme a Listagem 1.

Listagem 1. Arquivo pom.xml para baixar o JavaMail API.


  <project xmlns="http://maven.apache.org/POM/4.0.0" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
    http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example.common</groupId>
    <artifactId>JavaMailExample</artifactId>
    <packaging>jar</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>JavaMailExample</name>
    <url>http://maven.apache.org</url>
   
    <repositories>
      <repository>
           <id>Java.Net</id>
           <url>http://download.java.net/maven/2/</url>
      </repository>
    </repositories>
   
    <dependencies>
      <!-- JavaMail API -->
      <dependency>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
            <version>1.4.3</version>
      </dependency>
    </dependencies>
  </project>

Devemos atentar para a vers�o que estamos baixando, sempre coloque a �ltima vers�o dispon�vel. Todas as depend�ncias necess�rias tamb�m s�o baixadas quando utilizamos o maven. Assim, n�o � preciso se preocupar em procurar qualquer arquivo externo.

Obtendo informa��es do Exchange

Para acessar as configura��es do Microsoft Exchange podemos ir no outlook e acessar a op��o "Ferramentas" e "Contas de email...", conforme mostra a Figura 2.

Figura 2. Acessando detalhes da conta.

Na pr�xima tela selecionamos a op��o "Exibir ou alterar contas de email existentes". Ap�s isso basta clicar no bot�o "Avan�ar" (Figura 3).

Figura 3. Selecione a op��o para exibir ou alterar contas existentes.

Na tela de "Contas de Email" selecione a op��o "Microsoft Exchange Server" na caixa que cont�m acima o r�tulo "O Outlook processa emails para estas contas na seguinte ordem:". Por fim clique na op��o "Alterar..." no lado direito da tela. A Figura 4 mostra a tela.

Figura 4. Selecionando op��o alterar do Microsoft Exchange.

Na pr�xima tela podemos visualizar a URL do Microsoft Exchange Server que � o que vamos precisar no nosso c�digo para podermos enviar emails. A Figura 5 mostra como � esta tela.

Figura 5. Acessando a URL do Microsoft Exchange.

O detalhe � que para onde a fecha aponta � onde deve estar a url. Neste exemplo foi retirada a URL, mas este � o lugar onde ela est�.

Enviando e-mail com JavaMail e Microsoft Exchange

Segue na Listagem 2 o c�digo utilizado para enviar e-mail com JavaMail API e Microsoft Exchange.

Listagem 2. Enviando e-mail com JavaMail API e Microsoft Exchange.


  package util;
   
  import java.util.Properties;
  import javax.mail.Message;  
  import javax.mail.MessagingException;  
  import javax.mail.PasswordAuthentication;  
  import javax.mail.Session;  
  import javax.mail.Transport;  
  import javax.mail.internet.InternetAddress;  
  import javax.mail.internet.MimeMessage;  
    
    
  public class MailExample  
  {  
   
         public static void main(String args[]) {
                
               final String username = "username-do-outlook";
               final String password = "senha-do-outlook";
   
               Properties props = new Properties();
               props.put("mail.smtp.auth", "true");
               props.put("mail.smtp.starttls.enable", "false");
               props.put("mail.smtp.host", "endereco-do-exchange");
               props.put("mail.smtp.port", "25"); 
   
               Session session = Session.getInstance(props,
                 new javax.mail.Authenticator() {
                      protected PasswordAuthentication getPasswordAuthentication() {
                             return new PasswordAuthentication(username, password);
                      }
                 });
   
               try {
   
                      Message message = new MimeMessage(session);
                      message.setFrom(new InternetAddress("meu-email@servidor-exchange.com.br"));
                      message.setRecipients(Message.RecipientType.TO,
                             InternetAddress.parse("algum-email@servidor-exchange.com.br "));
                      message.setSubject("Titulo do Email");
                      
                      
                      String msg = "<b>Teste negrito</b>. Teste sem negrito.<br/><br/>";
                      
                      message.setContent(msg, "text/html");
                      
                      Transport.send(message);
   
                      System.out.println("Enviada!");
   
               } catch (MessagingException e) {
                      throw new RuntimeException(e);
               }
         }
         
  }

Neste c�digo devemos atentar para alguns detalhes como a vari�vel username que deve ser colocado o username da sua caixa postal ou de alguma caixa postal que foi criada no Exchange, e em password colocamos a senha da caixa postal. Nas configura��es das propriedades do JavaMail coloque em "mail.smtp.host" o endere�o do Microsoft Exchange que n�s achamos no outlook anteriormente. Na propriedade "mail.smtp.port" colocamos a porta do SMTP que como padr�o � definido na porta 25, mas para n�o termos problemas n�o custa perguntar aos administradores de rede.

Na mensagem basta configurarmos os detalhes do e-mail. Em "message.setFrom" colocamos o e-mail de origem que deve ser um e-mail existente e que foi configurado no username. Em "message.setRecipients" configuramos o e-mail de destino.

Tamb�m podemos enviar um e-mail para diversos destinat�rios. O m�todo da Listagem 3 oferece essa funcionalidade.

Listagem 3. Assinatura do m�todo addRecipients.


  void addRecipients(Message.RecipientType type, Address[] addresses) throws MessagingException

Onde type deve ser setado para TO, CC ou BCC. CC representa Carbon Copy e BCC Black Carbon Copy. Para passar o TO como par�metro usamos, por exemplo, Message.RecipientType.TO. O par�metro addresses � o array de ID de e-mails, deveremos usar o InternetAddress ao especificar IDs de e-mail. Segue na Listagem 4 um c�digo de exemplo.

Listagem 4. Exemplo de utiliza��o do InternetAddress.


  String to = "abcd@gmail.com";
  message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));

A API JavaMail ainda oferece diversas outras funcionalidades como a inclus�o de anexos nos e-mails. Apenas com essas informa��es j� podemos enviar e-mails utilizando a API JavaMail e o Microsoft Exchange.

A estrutura de pacotes e classes na API JavaMail demonstra que um dos principais objetivos de seus projetistas era que o n�vel de esfor�o exigido pelo desenvolvedor para construir uma aplica��o deveria ser ditada pela complexidade da aplica��o e pelo n�vel de controle exigido pelo desenvolvedor do aplicativo. Em outras palavras, manter a API t�o simples quanto poss�vel. O aplicativo de exemplo inclu�do neste artigo e os exemplos que v�m com a API JavaMail demonstram amplamente este ponto de vista.

� primeira vista, o n�mero de classes da API JavaMail e a estrutura detalhada dessas classes podem fazer com que o desenvolvedor acredite que a curva de aprendizagem para aprender a mexer na API � relativamente pesada. Mas, na realidade, uma vez que come�amos a trabalhar com a API JavaMail, vamos descobrindo que esta API � uma ferramenta simples e acess�vel para uma implementa��o robusta de e-mails ou mensagens em nossas aplica��es.

Uma an�lise das classes prim�rias dos pacotes da API JavaMail fornecem uma vis�o sobre os mecanismos comuns no sistema de mensagens de e-mail. Uma vis�o geral de alto n�vel das classes na ordem relativa em que s�o normalmente encontrados em uma aplica��o comum revela a simplicidade da API JavaMail. Embora a API JavaMail contenha muito mais classes do que outras APIs, concentrando-se em algumas das classes principais para come�armos a desenvolver torna-se bastante f�cil de entender a ess�ncia da API. A seguir est� uma descri��o detalhada dessas classes principais, que incluem javax.mail.Session, javax.mail.Store, javax.mail.Transport, javax.mail.Folder e javax.mail.Message. Algumas dessas classes n�o foram exemplificadas no exemplo acima, mas � importante saber para que servem.

A classe javax.mail.Session � a classe de entrada de n�vel superior para a API JavaMail, e seus m�todos mais comumente usados fornecem a capacidade de controlar e carregar as classes que representam as implementa��es do provedor de servi�o (ou Service Provider Implementations - SPI) para v�rios protocolos de e-mail. Por exemplo, inst�ncias das classes javax.mail.Store e javax.mail.Session, que ser�o descritos mais abaixo, s�o obtidos atrav�s da classe Session. (Nota: Um prestador de servi�os � um desenvolvedor e/ou um fornecedor que fornece uma implementa��o para uma API; exemplos de implementa��es da API JavaMail incluem POP3, SMTP e IMAP4 - alguns est�o dispon�veis a partir da Sun, outros atrav�s de terceiros).

A classe javax.mail.Store � implementada por um prestador de servi�os, assim como um desenvolvedor de aplica��o POP Mail, e permite ler, escrever, monitorar, e procurar acesso para um protocolo de e-mail particular. A classe javax.mail.Folder � acessada atrav�s desta classe e � detalhada mais abaixo.

A classe javax.mail.Transport � outra classe implementada por fornecedor e � usada para enviar uma mensagem. Esta classe tamb�m � utilizada para o envio de uma mensagem atrav�s de um protocolo espec�fico.

A classe javax.mail.Folder � implementada por um fornecedor. Esta classe oferece uma organiza��o hier�rquica para enviar mensagens e fornece acesso a mensagens de e-mail na forma de objetos de classe javax.mail.Message.

A classe javax.mail.Message � implementada por um fornecedor e modela todos os detalhes de uma mensagem de e-mail como assunto, endere�o de e-mail do remetente ou destinat�rio, data de envio do e-mail, e assim por diante. As orienta��es para os fornecedores que implementam o javax.mail.Message � para que a busca real de componentes de mensagens de e-mail deve ser adiada o m�ximo poss�vel, a fim de tornar esta classe t�o leves quanto poss�vel. Estas e outras orienta��es encontram-se na especifica��o do JavaMail que al�m de ser simples � bastante objetivo.

Se estivermos utilizando uma vers�o anterior ao Java SE 1.6 precisaremos tamb�m da extens�o JavaBeans Activation Framework (JAF) que � respons�vel por fornecer o pacote javax.activation. Na vers�es Java SE 1.6 e superiores esse pacote j� vem inclu�do. O JAF tem como objetivo unificar a forma de trabalhar com a multiplicidade de formatos de dados que est�o dispon�veis, sejam eles texto simples ou documentos extremamente complexos compostos de imagens, �udio, v�deo, etc. O JavaBeans Activation Framework trata-se portanto de uma extens�o para o Java que os desenvolvedores podem utiliza-lo para usufruir de alguns servi�os.

Bibliografia

[1] Microsoft Exchange Server 2010. Dispon�vel em www.microsoft.com/exchange/2010/pt/br/

[2] The JavaMail Home Page. Dispon�vel emhttp://java.sun.com/products/javamail/

Tecnologias:

Confira outros conte�dos:

Introdu��o ao JDBC

Novidades do Java

Teste unit�rio com JUnit

Assista grátis a nossa aula inaugural

Perguntas frequentes

Quem somos?

Por que a programação se tornou a profissão mais promissora da atualidade?

Como faço para começar a estudar?

Em quanto tempo de estudo vou me tornar um programador?

Sim, você pode se tornar um programador e não precisa ter diploma de curso superior!

O que eu irei aprender estudando pela DevMedia?

Principais diferenciais da DevMedia

Qual o investimento financeiro que preciso fazer para me tornar um programador?

Como funciona a forma de pagamento da DevMedia?

Por Higor Em 2014

Nossos casos de sucesso

Leonardo Carlos

Eu sabia pouqu�ssimas coisas de programa��o antes de come�ar a estudar com voc�s, fui me especializando em v�rias �reas e ferramentas que tinham na plataforma, e com essa bagagem consegui um est�gio logo no in�cio do meu primeiro per�odo na faculdade.

Lucas Rodrigues

Estudo aqui na Dev desde o meio do ano passado! Nesse per�odo a Dev me ajudou a crescer muito aqui no trampo.
Fui o primeiro desenvolvedor contratado pela minha empresa. Hoje eu lidero um time de desenvolvimento!
Minha meta � continuar estudando e praticando para ser um Full-Stack Dev!

Her�clito J�nior

Economizei 3 meses para assinar a plataforma e sendo sincero valeu muito a pena, pois a plataforma � bem intuitiva e muuuuito did�tica a metodologia de ensino. Sinto que estou EVOLUINDO a cada dia. Muito obrigado!

Julio Cablen

Nossa! Plataforma maravilhosa. To amando o curso de desenvolvimento front-end, tinha coisas que eu ainda n�o tinha visto. A did�tica � do jeito que qualquer pessoa consegue aprender. S�rio, to apaixonado, adorando demais.

Joelberth Sena

Adquiri o curso de voc�s e logo percebi que s�o os melhores do Brasil. � um passo a passo incr�vel. S� n�o aprende quem n�o quer. Foi o melhor investimento da minha vida!

Felipe Nunes

Foi um dos melhores investimentos que j� fiz na vida e tenho aprendido bastante com a plataforma. Voc�s est�o fazendo parte da minha jornada nesse mundo da programa��o, irei assinar meu contrato como programador gra�as a plataforma.

Wanderson Oliveira

Comprei a assinatura tem uma semana, aprendi mais do que 4 meses estudando outros cursos. Exerc�cios pr�ticos que n�o tem como n�o aprender, est�o de parab�ns!

Jos� Lucas

Obrigado DevMedia, nunca presenciei uma plataforma de ensino t�o presente na vida acad�mica de seus alunos, parab�ns!

Eduardo Dorneles

Aprendi React na plataforma da DevMedia h� cerca de 1 ano e meio... Hoje estou h� 1 ano empregado trabalhando 100% com React!

Adauto Junior

J� fiz alguns cursos na �rea e nenhum � t�o bom quanto o de voc�s. Estou aprendendo muito, muito obrigado por existirem. Est�o de parab�ns... Espero um dia conseguir um emprego na �rea.

Ver todos os casos de sucesso

JavaMail API: Introdu��o com Microsoft Exchange

Veja neste artigo o que � a JavaMail API, algumas capacidades como: desenvolvimento facilitado, suporte a m�ltiplos protocolos e saiba como usar a API JavaMail.