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.

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.

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.

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:

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.

As três primeiras variáveis são dinâmicas, preenchidas pelo usuário:

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:

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:

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:

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

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:

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():

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.

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.

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.