Enviar correo Java. JavaMail.

Tutorial para enviar correo desde Java. JavaMail.

---

Enviar correos desde Java es necesario en la mayoría de los sistemas, ya sea para utilizar la funcionalidad para notificar algún suceso, enviar alguna información, enviar correos masivos con promociones a tus clientes, enviar reportes adjuntos a quien sea necesario, puedes utilizar esto para hacer grandes cosas, en este Tutorial para enviar correos con JavaMail vamos hacer varios ejemplos básicos y así tu podrás utilizar la funcionalidad para el propósito que necesites. Para llevar a cabo este tutorial necesitas tener una cuenta de Gmail, desde la cual vamos a enviar los correos.

Tabla De Contenidos

      1. Descargar la API JavaMail.
      2. Creación del proyecto Java para enviar correos.
      3. Enviar correo con mensaje básico (Varios Destinatarios).
      4. Enviar correo con mensaje básico y un archivo adjunto.
      5. Enviar correo con formato HTML (Tipo Notificación).

1. Descargar la API JavaMail.

Para enviar correo desde java tenemos que descargar la API JavaMail desde su pagina oficial, para añadirla a nuestro proyecto, vamos hacer este tutorial con la versión javax.mail-1.5.4.jar de JavaMail.

2. Creación del proyecto Java para enviar correos.

Para comenzar vamos a crear un proyecto nuevo en nuestro IDE (En este caso utilizo JBoss Developer Studio, eclipse) y le pondremos el nombre de CorreosDatoJava, creamos un paquete nuevo llamado correosDJ, y vamos a importar a el build path del proyecto la librería que descargamos javax.mail-1.5.4.jar. Hasta ahora la estructura del proyecto debería verse así:

Estructura del Proyecto.

3. Enviar correo con mensaje básico (Varios Destinatarios).

En este primer ejemplo vamos a crear una clase en el paquete correosDJ en la cual vamos a implementar la funcionalidad para enviar un correo basico, al decir basico, me refiero a que tendrá como contenido un texto simple y será enviado a varios destinatarios. La clase lleva por nombre DJCorreoTexto y tiene su metodo static void main(String[] args). Este es el código:

DJCorreoTexto.java

package correosDJ;

import java.util.Properties;

import javax.mail.Message;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;

/**
 * @author datojava.blogspot.com
 */
public class DJCorreoTexto {

 public void mandarCorreo() {
  // El correo gmail de envío
  String correoEnvia = "tuCorreo@gmail.com";
  String claveCorreo = "tu clave";

  // La configuración para enviar correo
  Properties properties = new Properties();
  properties.put("mail.smtp.host", "smtp.gmail.com");
  properties.put("mail.smtp.starttls.enable", "true");
  properties.put("mail.smtp.port", "587");
  properties.put("mail.smtp.auth", "true");
  properties.put("mail.user", correoEnvia);
  properties.put("mail.password", claveCorreo);

  // Obtener la sesion
  Session session = Session.getInstance(properties, null);

  try {
   // Crear el cuerpo del mensaje
   MimeMessage mimeMessage = new MimeMessage(session);

   // Agregar quien envía el correo
   mimeMessage.setFrom(new InternetAddress(correoEnvia, "Dato Java"));
   
   // Los destinatarios
   InternetAddress[] internetAddresses = {
     new InternetAddress("correo1@gmail.com"),
     new InternetAddress("correo2@gmail.com"),
     new InternetAddress("correo3@gmail.com") };

   // Agregar los destinatarios al mensaje
   mimeMessage.setRecipients(Message.RecipientType.TO,
     internetAddresses);

   // Agregar el asunto al correo
   mimeMessage.setSubject("Dato Java Enviando Correo.");

   // Creo la parte del mensaje
   MimeBodyPart mimeBodyPart = new MimeBodyPart();
   mimeBodyPart.setText("Siguiendo el Tutorial de datojava.blogspot.com envío el correo.");

   // Crear el multipart para agregar la parte del mensaje anterior
   Multipart multipart = new MimeMultipart();
   multipart.addBodyPart(mimeBodyPart);

   // Agregar el multipart al cuerpo del mensaje
   mimeMessage.setContent(multipart);

   // Enviar el mensaje
   Transport transport = session.getTransport("smtp");
   transport.connect(correoEnvia, claveCorreo);
   transport.sendMessage(mimeMessage, mimeMessage.getAllRecipients());
   transport.close();

  } catch (Exception ex) {
   ex.printStackTrace();
  }
  System.out.println("Correo enviado");
 }

 public static void main(String[] args) {
  DJCorreoTexto correoTexto = new DJCorreoTexto();
  correoTexto.mandarCorreo();
  
 }
}
 

Viendo el código apreciamos que no es nada de otro mundo enviar correos utilizando la API de JavaMail, primero establecemos en variables desde donde vamos a enviar los correos (21,22), después configuramos los parámetros para el envió de correos, la misma configuración la hacemos utilizando java.util.Properties (25..31), obtenemos la sesión de JavaMail pasando como parámetro la configuración anterior (34), creamos el objeto MimeMessage, que básicamente es toda la información que comprende el mensaje enviado, quien envía el correo, el(los) destinatarios, el asunto... (38..54), después creamos el objeto MimeBodyPart, la parte que tiene el mensaje a enviar (57,58), creamos el objeto Multipart en el cual vamos agregar las partes (MimeBodyPart) del mensaje para posteriormente agregar dicho objeto al MimeMessage (61..65), enviamos el correo con el objeto Transport (68..71).

Para entender un poco más acerca del funcionamiento de JavaMail, puedes ver este grafico.

Capas del correo JavaMail.

Al momento de ejecutar este ejemplo puede que te de un error por la seguridad que al día de hoy a implementado Gmail en sus correos, el error que salta en la consola es este, javax.mail.AuthenticationFailedException: 534-5.7.14, y si seguimos leyendo el log del error vemos que mas abajo nos dice:

534-5.7.14 Learn more at
34 5.7.14 https://support.google.com/mail/answer/78754

... En fin lo que quiere decir este error es que no está permitido que las aplicaciones menos seguras (nuestra aplicación) accedan a tu cuenta, para arreglar eso tenemos que habilitar esa opción en este link y listo.
Si todo va bien en la consola debería mostrarte "Correo enviado" y los destinatarios recibirán el correo en la bandeja de entrada de esta forma.

Correo Recibido.

El contenido del mismo se vera así:

Mensaje Del Correo.

4. Enviar correo con mensaje básico y un archivo adjunto.

Básicamente es el mismo código anterior, solo que para agregar el archivo adjunto tenemos que crear otro objeto MimeBodyPart, al mismo le adjuntamos el archivo con el metodo attachFile(String File), no importa si es un archivo .pdf, .xlsx, .txt, .jpg, .docx... Es indiferente solo hay que pasarle como parámetro a ese método la url del archivo. Esta porción de código hay que añadirla al ejemplo anterior:

 MimeBodyPart mimeBodyPartAdjunto = new MimeBodyPart();
 mimeBodyPartAdjunto.attachFile("C:/Users/datojava/DatoJava.docx");
 // Resto del codigo...
 //
 //
 // Agregarlo al MultiPart
 multipart.addBodyPart(mimeBodyPartAdjunto);
 

Si no hay errores así se vería en la bandeja de entrada:

Correo con archivo adjunto recibido.

Y al abrir el correo se visualiza de esta manera:

Mensaje del correo con archivo adjunto

5. Enviar correo con formato HTML (Tipo Notificación).

Aquí si hay un poco de diferencia al código anterior, en realidad la configuración del correo siempre será la misma (por lo menos en este ejemplo), lo que cambia ahora es que queremos mandar dentro del correo, un mensaje hecho en html, no vamos a crear un simple "Hola Mundo", vamos hacer algo chévere y sencillo con imágenes para que no quede duda de cómo se implementa. Vamos a mostrar el código por partes para ir explicando poco a poco.
Primero vamos a crear un archivo en nuestro IDE, new> other> File, que llevará por nombre PlantillaDJ, en esta plantilla hacemos el código html para posteriormente pintarlo en el mensaje. Vamos hacer un mensaje de notificación para un cliente que acaba de comprar un producto en nuestra tienda, así se verá el mensaje HTML en el cuerpo del correo:

Correo HTML

Y para obtener el mensaje anterior este es el código html:

PlantillaDJ

<html>
 <body>
  

                 
  
  

        
    Estimado Cliente, le informamos que su compra
    

    se realizo con éxito. 
    

    

    Puede retirar su compra de lunes a viernes
    

    en horario corrido de 9:00am a 7:00pm.
   
  
  

   
    www.datojava.blogspot.com
    

    

      +DatoJavaBlog
    

    

    
    

    ....Tutorial JavaMail. DatoJava....
   
  
      
 </body>
</html>
 

En el código de la plantilla podemos comentar que es un código relativamente "sencillo" de HTML, en el cual agregamos algunas imágenes de esta manera:

<img src="cid:datojava.png"

para agregar la imagen al código la obtenemos del Content-ID (cid) que vamos a crear en la clase DJCorreoHTML que implementa esta plantilla.

Ahora vamos a implementar la clase que se encarga de enviar el correo con un mensaje HTML, la vamos a llamar DJCorreoHTML y seguimos con la misma configuración de Gmail, lo que tenemos que hacer ahora es leer la plantilla que hemos creado previamente e ir almacenándola en un StringBuffer para luego enviar el correo, este es el código completo de la clase:

DJCorreoHTML

package correosDJ;

import java.io.BufferedReader;
import java.io.File;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.Properties;

import javax.mail.Message;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;

/**
 * @author datojava.blogspot.com
 */
public class DJCorreoHTML {

 public void mandarCorreo() {
  // El correo gmail de envío
  String correoEnvia = "tuCorreo@gmail.com";
  String claveCorreo = "tuClave";

  // La configuración para enviar correo
  Properties properties = new Properties();
  properties.put("mail.smtp.host", "smtp.gmail.com");
  properties.put("mail.smtp.starttls.enable", "true");
  properties.put("mail.smtp.port", "587");
  properties.put("mail.smtp.auth", "true");
  properties.put("mail.user", correoEnvia);
  properties.put("mail.password", claveCorreo);

  // Obtener la sesion
  Session session = Session.getInstance(properties, null);

  try {
   // Crear el cuerpo del mensaje
   MimeMessage mimeMessage = new MimeMessage(session);

   // Agregar quien envía el correo
   mimeMessage.setFrom(new InternetAddress(correoEnvia, "Dato Java"));

   // Los destinatarios
   InternetAddress[] internetAddresses = { new InternetAddress(
     "correo1@gmail.com") };

   // Agregar los destinatarios al mensaje
   mimeMessage.setRecipients(Message.RecipientType.TO,
     internetAddresses);

   // Agregar el asunto al correo
   mimeMessage.setSubject("Dato Java Enviando Correo HTML.");

   // Crear el multipart para agregar la parte del mensaje anterior
   Multipart multipart = new MimeMultipart();

   // Leer la plantilla
   InputStream inputStream = getClass().getResourceAsStream(
     "PlantillaDJ");
   BufferedReader bufferedReader = new BufferedReader(
     new InputStreamReader(inputStream));

   // Almacenar el contenido de la plantilla en un StringBuffer
   String strLine;
   StringBuffer msjHTML = new StringBuffer();
   while ((strLine = bufferedReader.readLine()) != null) {
    msjHTML.append(strLine);
   }

   // Url del directorio donde estan las imagenes
   String urlImagenes = "url del directorio donde estan las imagenes";
   File directorio = new File(urlImagenes);
   
   // Obtener los nombres de las imagenes en el directorio
   String[] imagenesDirectorio = directorio.list();

   // Creo la parte del mensaje HTML
   MimeBodyPart mimeBodyPart = new MimeBodyPart();
   mimeBodyPart.setContent(msjHTML.toString(), "text/html");

   // Validar que el directorio si tenga las imagenes
   if (imagenesDirectorio != null) {
    for (int count = 0; count < imagenesDirectorio.length; count++) {

     MimeBodyPart imagePart = new MimeBodyPart();
     imagePart.setHeader("Content-ID", "<"
       + imagenesDirectorio[count] + ">");
     imagePart.setDisposition(MimeBodyPart.INLINE);
     imagePart.attachFile(urlImagenes
       + imagenesDirectorio[count]);
     multipart.addBodyPart(imagePart);
    }
   } else {
    System.out.println("No hay imagenes en el directorio");
   }

   // Agregar la parte del mensaje HTML al multiPart
   multipart.addBodyPart(mimeBodyPart);

   // Agregar el multipart al cuerpo del mensaje
   mimeMessage.setContent(multipart);

   // Enviar el mensaje
   Transport transport = session.getTransport("smtp");
   transport.connect(correoEnvia, claveCorreo);
   transport.sendMessage(mimeMessage, mimeMessage.getAllRecipients());
   transport.close();

  } catch (Exception ex) {
   ex.printStackTrace();
  }
  System.out.println("Correo enviado");
 }

 public static void main(String[] args) {
  DJCorreoHTML correoHTML = new DJCorreoHTML();
  correoHTML.mandarCorreo();

 }

}

 

El código comienza a cambiar desde la línea 61, en la cual comenzamos a leer y almacenar el contenido de la plantilla en un StringBuffer (62..72), como el mensaje del correo posee algunas imágenes, la mejor manera es colocar las imágenes que vamos a utilizar en un mismo directorio, y así en Java indicamos el directorio donde están las imágenes y obtenemos sus nombres (74..79), después creamos el MimeBodyPart en el cual establecemos que es de tipo HTML y también agregamos el contenido de la plantilla almacenada en el StringBuffer (82,83), validamos que el directorio no este vacío, si todo va bien vamos a crear un MimeBodyPart por cada imagen encontrada, en el header establecemos el Content-ID con el nombre de cada imagen encontrada y así podemos añadirla al codigo HTML, sucesivamente cada imagen la agregamos al Multipart (86..99), el resto se mantiene igual a los ejemplos anteriores.

Si todo está bien el correo deberíamos recibirlo de esta manera

Correo HTML Recibido

Ya con este Tutorial para enviar correos desde Java utilizando JavaMail podemos implementar nuestras clases como mejor nos parezca, estos son ejemplos básicos para que ustedes se extiendan si así lo necesitan, ya queda de parte de ustedes, aquí les dejo el proyecto creado para que lo descarguen, Suerte.

Temas Relacionados:

• Como instalar dos JBoss en la misma maquina. JBoss de pruebas
• Tutorial de aplicación Java Swing.
• Pruebas unitarias con JUnit, Tutorial de JUnit.
• Tutorial de Java con HSQLDB.