Usando pacote javax.mail para enviar email em Java

Neste artigo aprenderemos a utilizar algumas classes do pacote javax.mail para enviar e-mail em Java. Nosso projeto consistir� na constru��o de uma aplica��o composto de apenas um formul�rio onde este formul�rio ter� os campos e m�todos respons�veis por enviar o e-mail.

Construindo o projeto

Nosso formul�rio ap�s finalizado dever� ter a apar�ncia da Figura 1.

O acionamento do bot�o enviar captura os dados dos campos assunto, e-mail destino e mensagem para enviar ao e-mail do destinat�rio.

Caso voc� esteja usando o Netbeans poder� utilizar o arquivo .form, descrito na Listagem 1, para montar seu formul�rio igualmente mostrado na Figura 1.


<?xml version="1.0" encoding="UTF-8" ?>
 
<Form version="1.3" maxVersion="1.9" 
type="org.netbeans.modules.form.forminfo.JFrameFormInfo">
  <Properties>
    <Property name="defaultCloseOperation" type="int" value="3"/>
  </Properties>
  <SyntheticProperties>
    <SyntheticProperty name="formSizePolicy" 
    type="int" value="1"/>
    <SyntheticProperty name="generateCenter" 
    type="boolean" value="false"/>
  </SyntheticProperties>
  <AuxValues>
    <AuxValue name="FormSettings_autoResourcing" 
    type="java.lang.Integer" value="0"/>
    <AuxValue name="FormSettings_autoSetComponentName" 
    type="java.lang.Boolean" value="false"/>
    <AuxValue name="FormSettings_generateFQN" 
    type="java.lang.Boolean" value="true"/>
    <AuxValue name="FormSettings_generateMnemonicsCode" 
    type="java.lang.Boolean" value="false"/>
    <AuxValue name="FormSettings_i18nAutoMode" 
    type="java.lang.Boolean" value="false"/>
    <AuxValue name="FormSettings_layoutCodeTarget" 
    type="java.lang.Integer" value="1"/>
    <AuxValue name="FormSettings_listenerGenerationStyle" 
    type="java.lang.Integer" value="0"/>
    <AuxValue name="FormSettings_variablesLocal" 
    type="java.lang.Boolean" value="false"/>
    <AuxValue name="FormSettings_variablesModifier" 
    type="java.lang.Integer" value="2"/>
  </AuxValues>
 
  <Layout>
    <DimensionLayout dim="0">
      <Group type="103" groupAlignment="0" attributes="0">
          <Group type="102" alignment="0" attributes="0">
              <EmptySpace max="-2" attributes="0"/>
              <Group type="103" groupAlignment="0" attributes="0">
                  <Component id="jScrollPane1" max="32767" attributes="0"/>
                  <Group type="102" attributes="0">
                      <Group type="103" groupAlignment="0" attributes="0">
                          <Component id="jButtonEnviar" 
                          alignment="0" min="-2" max="-2" attributes="0"/>
                          <Component id="jLabel1" 
                          alignment="0" min="-2" max="-2" attributes="0"/>
                          <Component id="jTextFieldAssunto" 
                          alignment="0" min="-2" pref="280" max="-2" attributes="0"/>
                          <Component id="jLabel2" 
                          alignment="0" min="-2" max="-2" attributes="0"/>
                          <Component id="jTextFieldEmailDestino" 
                          alignment="0" min="-2" pref="280" max="-2" attributes="0"/>
                          <Component id="jLabel3" 
                          alignment="0" min="-2" max="-2" attributes="0"/>
                      </Group>
                      <EmptySpace min="0" pref="104" max="32767" attributes="0"/>
                  </Group>
              </Group>
              <EmptySpace max="-2" attributes="0"/>
          </Group>
      </Group>
    </DimensionLayout>
    <DimensionLayout dim="1">
      <Group type="103" groupAlignment="0" attributes="0">
          <Group type="102" alignment="1" attributes="0">
              <EmptySpace min="-2" pref="21" max="-2" attributes="0"/>
              <Component id="jLabel1" min="-2" max="-2" attributes="0"/>
              <EmptySpace max="-2" attributes="0"/>
              <Component id="jTextFieldAssunto" min="-2" max="-2" attributes="0"/>
              <EmptySpace type="separate" max="-2" attributes="0"/>
              <Component id="jLabel2" min="-2" max="-2" attributes="0"/>
              <EmptySpace max="-2" attributes="0"/>
              <Component id="jTextFieldEmailDestino" min="-2" max="-2" attributes="0"/>
              <EmptySpace type="separate" max="-2" attributes="0"/>
              <Component id="jLabel3" min="-2" max="-2" attributes="0"/>
              <EmptySpace max="-2" attributes="0"/>
              <Component id="jScrollPane1" min="-2" max="-2" attributes="0"/>
              <EmptySpace pref="34" max="32767" attributes="0"/>
              <Component id="jButtonEnviar" min="-2" max="-2" attributes="0"/>
              <EmptySpace min="-2" pref="21" max="-2" attributes="0"/>
          </Group>
      </Group>
    </DimensionLayout>
  </Layout>
  <SubComponents>
    <Component class="javax.swing.JButton" name="jButtonEnviar">
      <Properties>
        <Property name="text" type="java.lang.String" value="Enviar"/>
      </Properties>
      <Events>
        <EventHandler event="actionPerformed" listener="java.awt.event.ActionListener" 
        parameters="java.awt.event.ActionEvent" handler="jButtonEnviarActionPerformed"/>
      </Events>
    </Component>
    <Component class="javax.swing.JLabel" name="jLabel1">
      <Properties>
        <Property name="text" type="java.lang.String" value="Assunto"/>
      </Properties>
    </Component>
    <Component class="javax.swing.JTextField" name="jTextFieldAssunto">
    </Component>
    <Component class="javax.swing.JLabel" name="jLabel2">
      <Properties>
        <Property name="text" type="java.lang.String" value="Email Destino"/>
      </Properties>
    </Component>
    <Component class="javax.swing.JTextField" name="jTextFieldEmailDestino">
    </Component>
    <Component class="javax.swing.JLabel" name="jLabel3">
      <Properties>
        <Property name="text" type="java.lang.String" value="Mensagem"/>
      </Properties>
    </Component>
    <Container class="javax.swing.JScrollPane" name="jScrollPane1">
      <AuxValues>
        <AuxValue name="autoScrollPane" type="java.lang.Boolean" value="true"/>
      </AuxValues>
 
      <Layout ass="org.netbeans.modules.form.compat2
      .layouts.support.JScrollPaneSupportLayout"/>
      <SubComponents>
        <Component class="javax.swing.JTextArea" name="jTextAreaMensagem">
          <Properties>
            <Property name="columns" type="int" value="20"/>
            <Property name="rows" type="int" value="5"/>
          </Properties>
        </Component>
      </SubComponents>
    </Container>
  </SubComponents>
</Form>

Listagem 1. FmainMail.form

Antes de come�armos a construir o c�digo do nosso formul�rio vamos primeiro construir os m�todos respons�veis pelo envio do e-mail e explicar o funcionamento de cada um. Primeiramente o m�todo mais interno, o criarSessionMail(), visto na Listagem 2.


private Session criarSessionMail() {
     Properties props = new Properties();

     props.put("mail.smtp.host", "smtp.gmail.com");
     props.put("mail.smtp.socketFactory.port", 465);
     props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
     props.put("mail.smtp.auth", true);
     props.put("mail.smtp.port", 465);

     Session session = Session.getDefaultInstance(props, new javax.mail.Authenticator() {

            protected PasswordAuthentication getPasswordAuthentication() {
                   return new PasswordAuthentication("seuemail@gmail.com", "suasenha");
            }
     });

     session.setDebug(true);

     return session;
}

Listagem 2. criarSessionMail()

O m�todo getDefaultInstance() da classe Session recebe dois par�metros: um objeto Properties e um Authenticator. O Properties define as propriedades necess�rias para conex�o do servidor e-mail. Sendo assim, definimos o servidor SMPT com as configura��es da Listagem 3.


Properties props = new Properties();

   props.put("mail.smtp.host", "smtp.gmail.com");
   props.put("mail.smtp.socketFactory.port", 465);
   props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
   props.put("mail.smtp.auth", true);
   props.put("mail.smtp.port", 465);

Listagem 3. Configura��es do servidor SMPT

Estas configura��es s�o espec�ficas do GMAIL, mas voc� pode utilizar qualquer outro servidor de e-mail que

voc� tenha acesso aos dados do SMTP. A classe Authenticator � abstrata, ent�o fazemos uma

instancia��o an�nima para n�o precisar armazenar a refer�ncia do objeto:


Session session = Session.getDefaultInstance(props, new javax.mail.Authenticator() {

    protected PasswordAuthentication getPasswordAuthentication() {
           return new PasswordAuthentication("seuemail@gmail.com", "suasenha");
    }
});

Perceba que no c�digo passamos dois par�metros de extrema import�ncia: o e-mail de autentica��o e a senha.

Por fim, configuramos o objeto Session em modo �debug� para que ele mostre o que est� acontecendo ao enviar o e-mail. O mesmo � retornado para a fun��o que fez a chamada. Esse m�todo � o respons�vel por realizar toda a conex�o com o servidor SMTP: � apenas neste ponto que configuraremos os dados de autentica��o, portas e endere�os de conex�o. Veremos na Listagem 3 a configura��o para envio do e-mail propriamente dito, tais como assunto, mensagem, destinat�rio e etc.


private void enviarEmail() throws AddressException, MessagingException {
     
     String msg = jTextAreaMensagem.getText();
     String assunto = jTextFieldAssunto.getText();
     String email = jTextFieldEmailDestino.getText();
     
     String remetente = "remetente@gmail.com";
     System.out.println("__________________________________________________");
     System.out.println("Enviando email DE: " + remetente + " PARA: " + email);
     System.out.println("Assunto: " + assunto);

     Message message = new MimeMessage(criarSessionMail());
     message.setFrom(new InternetAddress(remetente)); // Remetente

     Address[] toUser = InternetAddress // Destinat�rio(s)
                   .parse(email.trim().toLowerCase());

     message.setRecipients(Message.RecipientType.TO, toUser);
     message.setSubject(assunto);// Assunto
     message.setContent(msg, "text/html");
     /** M�todo para enviar a mensagem criada */
     Transport.send(message);

     System.out.println("Email enviado com sucesso !");
     System.out.println("__________________________________________________");

}

Listagem 3. enviarEmail()

As tr�s primeiras vari�veis s�o din�micas, preenchidas pelo usu�rio:


String msg = jTextAreaMensagem.getText();
 String assunto = jTextFieldAssunto.getText();
       String email = jTextFieldEmailDestino.getText();

O remetente � o e-mail que o destinat�rio ver�, ou seja, voc� pode autenticar com um e-mail abc@gmail.com e colocar o remetente como outroemail@gmail.com. A classe Message � abstrata ent�o precisamos implement�-la. Para isso usamos o MimeMessage que obrigatoriamente deve receber um Session em seu construtor. Sendo assim usamos o m�todo criado anteriormente criarSessionMail() para retornar um Session e passar ao MimeMessage:


Message message = new MimeMessage(criarSessionMail());

Com uma inst�ncia de Message em m�os n�s podemos come�ar a configurar nosso e-mail, ou seja, os dados de envio.

O primeiro par�metro � o remetente e usamos o setFrom() para defini-lo:


message.setFrom(new InternetAddress(remetente)); // Remetente

O m�todo setFrom() recebe um objeto do tipo InternetAddress, sendo assim, criamos este objeto passando para o seu construtor o endere�o do remetente.

O m�todo setRecipients() recebe a forma de vincula��o dos destinat�rios ao e-mail. Por exemplo: quatro e-mails podem ser destinat�rio ocultos, sendo assim configurar�amos como RecipientType.CC, mas como em nosso caso o �nico e-mail ser� o principal usamos o RecipientType.TO:


message.setRecipients(Message.RecipientType.TO, toUser);

O objeto toUser � um array de Address que criamos anteriormente atrav�s do m�todo InternetAddress.parse():


Address[] toUser = InternetAddress // Destinat�rio(s)
 .parse(email.trim().toLowerCase());

Podemos passar v�rios e-mails ao parse() e n�o apenas um como � nosso caso.

O pr�ximo passo � configurar o assunto e o conte�do do e-mail:


message.setSubject(assunto);// Assunto
     message.setContent(msg, "text/html");

Configuramos o conte�do do e-mail como �text/html�, pois ser� apenas texto puro, sem v�deos ou outras caracter�sticas especiais. Por fim usamos a classe Transport para enviar o e-mail atrav�s do m�todo send():


Transport.send(message);

Se tudo der certo a mensagem Email Enviado com Sucesso ser� mostrada no console, caso contr�rio, uma exce��o pode ser lan�ada, sendo ela: AddressException ou MessagingException. Em nosso caso n�o estamos tratando esse tipo de exce��o, apenas lan�ando �para cima�, mas voc� pode ficar � vontade para tratar e mostrar uma mensagem espec�fica para o usu�rio, tal como: Imposs�vel enviar este e-mail, tente novamente mais tarde ou verifique as configura��es de envio.

Agora vejamos a cria��o dos nossos componentes dentro do formul�rio, como mostra a Listagem 4.


private javax.swing.JButton jButtonEnviar;
private javax.swing.JLabel jLabel1;
private javax.swing.JLabel jLabel2;
private javax.swing.JLabel jLabel3;
private javax.swing.JScrollPane jScrollPane1;
private javax.swing.JTextArea jTextAreaMensagem;
private javax.swing.JTextField jTextFieldAssunto;
private javax.swing.JTextField jTextFieldEmailDestino;


private void initComponents() {


     jButtonEnviar = new javax.swing.JButton();
     jLabel1 = new javax.swing.JLabel();
     jTextFieldAssunto = new javax.swing.JTextField();
     jLabel2 = new javax.swing.JLabel();
     jTextFieldEmailDestino = new javax.swing.JTextField();
     jLabel3 = new javax.swing.JLabel();
     jScrollPane1 = new javax.swing.JScrollPane();
     jTextAreaMensagem = new javax.swing.JTextArea();


     setDefaultCloseOperation(javax.swing.WindowConstants.EXIT_ON_CLOSE);


     jButtonEnviar.setText("Enviar");
     jButtonEnviar.addActionListener(new java.awt.event.ActionListener() {
            public void actionPerformed(java.awt.event.ActionEvent evt) {
                   jButtonEnviarActionPerformed(evt);
            }
     });


     jLabel1.setText("Assunto");


     jLabel2.setText("Email Destino");


     jLabel3.setText("Mensagem");


     jTextAreaMensagem.setColumns(20);
     jTextAreaMensagem.setRows(5);
     jScrollPane1.setViewportView(jTextAreaMensagem);


     javax.swing.GroupLayout layout = 
     new javax.swing.GroupLayout(getContentPane());
     getContentPane().setLayout(layout);
layout.setHorizontalGroup(layout.createParallelGroup(
javax.swing.GroupLayout.Alignment.LEADING).addGroup(
 layout.createSequentialGroup()
    .addContainerGap()
    .addGroup(
        layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
           .addComponent(jScrollPane1)
           .addGroup(
               layout.createSequentialGroup()
                  .addGroup(
                      layout.createParallelGroup(
                      javax.swing.GroupLayout.Alignment.LEADING).addComponent(
                      jButtonEnviar).addComponent(jLabel1);
layout.setVerticalGroup(layout.createParallelGroup(
javax.swing.GroupLayout.Alignment.LEADING).addGroup(
 javax.swing.GroupLayout.Alignment.TRAILING,
 layout.createSequentialGroup().addGap(21, 21, 21).addComponent(jLabel1)
 .addPreferredGap(
 javax.swing.LayoutStyle.ComponentPlacement.RELATED)
    .addComponent(jTextFieldAssunto, javax.swing.GroupLayout.PREFERRED_SIZE, 
    javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
    .addGap(18, 18, 
    18)
     .addComponent(jLabel2).addPreferredGap(javax.swing.LayoutStyle
     .ComponentPlacement.RELATED)
    .addComponent(jTextFieldEmailDestino, javax.swing.GroupLayout.PREFERRED_SIZE, 
    javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
    .addGap(18, 18, 
    18)
     .addComponent(jLabel3).addPreferredGap(javax.swing.LayoutStyle
     .ComponentPlacement.RELATED)
    .addComponent(jScrollPane1, javax.swing.GroupLayout.PREFERRED_SIZE, 
    javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout
    .PREFERRED_SIZE)
     .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED, 34, 
     Short.MAX_VALUE).addComponent(jButtonEnviar).addGap(21, 21, 21)));


     pack();
}

Listagem 4. Inicializando componentes do formul�rio

O c�digo apresentado, pertencente ao m�todo initcomponents(), � respons�vel por inicializar todo layout e componentes gr�ficos no formul�rio. Voc� pode colocar ele dentro do construtor da classe. O que nos importa neste caso � o bot�o jButtonEnviar, que possui um listener que � disparado quando o click do bot�o � efetuado, o m�todo jButtonEnviarActionPerformed() � chamado, como mostra a Listagem 5.


private void jButtonEnviarActionPerformed(java.awt.event.ActionEvent evt) {
// GEN-FIRST:event_jButtonEnviarActionPerformed
     try {
            enviarEmail();
     } catch (AddressException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
     } catch (MessagingException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
     }
}// GEN-LAST:event_jButtonEnviarActionPerformed

Listagem 5. jButtonEnviarActionPerformed

A �nica fun��o deste m�todo � chamar o m�todo enviarEmail() que j� explicamos anteriormente em detalhes. Lembre-se que falamos que nossas exce��es (AddressException e MessagingException) foram lan�adas para cima, e � neste m�todo que tratamos ela.

Neste artigo demonstramos como realizar a configura��o necess�ria para enviar e-mail em Java. Trabalhamos coma configura��es SMTP para o gmail mas voc� poder� usar outro servidor se achar conveniente.

Todo nosso projeto foi baseado no pacote javax.mail principalmente com as classes Session, Transport e Message. Aplicamos este a um formul�rio para demonstrar como utiliz�-lo, mas voc� pode ir muito al�m e acoplar t�o funcionalidade a um Helper que pode ser usado em qualquer ponto do sistema, abstraindo a complexidade necess�ria para envio de e-mail. Outra quest�o importante s�o as configura��es do servidor SMTP, pois neste artigo configuramos manualmente via c�digo, mas o ideal � fazer isso de forma din�mica, seja atrav�s do banco de dados ou atrav�s de um arquivo.

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 Ronaldo Em 2015

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