HtmlEmail. Envío de emails en HTML con imágenes embebidas
En este pequeño tutorial vamos a ver un ejemplo de como enviar correos electrónicos en formato HTML y texto plano a través del API Commons Email. Cabe destacar que esto no es más que un sencillo tutorial de referencia rápida, para más información deberéis dirigiros a la página oficial.
Cabe resaltar que la técnica que utilizo en el siguiente ejemplo es fácilmente adaptable a cualquier proyecto, así que espero os sea de utilidad en algún momento.
Manos a la obra….
El ejemplo
Contenido del email en texto plano: (archivo mail.txt)
|
1 2 3 4 5 6 7 8 9 10 11 |
Estimado usuario. Bla bla bla Nombre: ${nombre} Apellidos: ${apellidos} Bla bla bla bla Un saludo. Autentia Real Business Solutions. |
Contenido del email en HTML: (archivo mail.html)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
<html> <head> <title>Vive y deja vivir ;-)</title> </head> <body> <img src="cid:${autentia.gif}" height="47" width="170" /> <p>Bla bla bla bla bla bla bla</p> <ul style="list-style-type:none"> <li>Nombre: ${nombre}</li> <li>Apellidos: ${apellidos}</li> </ul> <p>Bla bla bla bla bla bla bla</p> <p>Un saludo.</p> <img src="cid:${emailFoot}" /> </body> </html> |
Parámetros de configuración necesarios para enviar el email: (archivo mail.properties)
|
1 2 3 4 |
mail.server=smtp.miservidor_de_correo.com from.name=Carlos García Pérez from.email=mi_correito@autentia.com mail.subject=Vive y deja vivir ;-) |
A continuación mostramos una sencilla aplicación (autoexplicativa) de consola en donde se ven los pasos para configurar y enviar el correo.
Gracias al uso del paquete Commons Email la aplicación se simplifica bastante, obviando ciertos detalles y conocimientos que serían necesarios usando otros paquetes como el javax.mail.
De todas formas no está de más conocérselo, pues commons email se apoya y depende de él para su funcionamiento.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
package com.autentia.tutoriales.htmlmail; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.io.StringWriter; import java.net.URL; import java.util.Properties; import org.apache.commons.lang.text.StrSubstitutor; import org.apache.commons.mail.HtmlEmail; /** * Envio de correos electrónicos en formato HTML con imágenes embebidas * @author Carlos García. Autentia Real Business Solutions. * Creador de http://www.mobiletest.es */ public class SendHtmlEmail { /** * Punto de entrada al ejemplo * (Para este tutorial no hacemos un buen tratamiento de excepciones para tener el código sea más * fácil de comprender.) */ public static void main(String[] args) throws Exception { HtmlEmail email = new HtmlEmail(); String html = null; String plain = null; StrSubstitutor strSub = null; // Para no usar beans u objetos que compliquen el código de este tutorial vamos a poner los valores // de las propiedades que serán más adelante reemplazadas usando la clase java.util.Properties Properties usuario = new Properties(); usuario.put("nombre", "Carlos"); usuario.put("apellidos", "García Pérez"); usuario.put("email", "tuemail@pepito.com"); // Leemos el contenido del correo en formato texto plano y reemplazamos las expresiones por su valor // Usamos la clase StrSubstitutor del paquete "Commons Lang" para reemplazar las expresiones por su valor // http://commons.apache.org/lang/apidocs/index.html?org/apache/commons/lang/text/StrSubstitutor.html plain = SendHtmlEmail.fileToString(SendHtmlEmail.class.getResourceAsStream("/mail.txt"), "utf-8"); strSub = new StrSubstitutor(usuario); plain = strSub.replace(plain); // Leemos el contenido del correo en formato HTML html = SendHtmlEmail.fileToString(SendHtmlEmail.class.getResourceAsStream("/mail.html"), "utf-8"); // Embebemos las imágenes que contendrá el correo (Para simplificar, el nombre de la variable // que posteriormente será reemplazada, es igual al nombre de cada imagen real a embeber). String[] images = {"autentia.gif"}; URL url = null; String cid = null; for (int i = 0; i < images.length; i++){ // Obtenemos la URL de la imagen desde el CLASSPATH url = SendHtmlEmail.class.getResource("/" + images[i]); cid = email.embed(url, images[i]); usuario.put(images[i], cid); } // Ahora vamos a embeber una imagen pública de Internet. cid = email.embed(new URL("http://www.adictosaltrabajo.com/images/logos/logo_adictos_3.jpg"), "pie"); usuario.put("emailFoot", cid); // Le damos el nombre "emailFoot" // Usamos la clase StrSubstitutor del paquete "Commons Lang" para reemplazar las expresiones por su valor // http://commons.apache.org/lang/apidocs/index.html?org/apache/commons/lang/text/StrSubstitutor.html strSub = new StrSubstitutor(usuario); html = strSub.replace(html); // Cargamos la configuración del correo desde un archivo localizable via CLASSPATH Properties mailSetup = new Properties(); mailSetup.load(SendHtmlEmail.class.getResourceAsStream("/mail.properties")); // Establecemos la configuracion del correo electrónico email.setHostName(mailSetup.getProperty("mail.server")); email.setCharset("UTF-8"); email.addTo(usuario.getProperty("email"), usuario.getProperty("nombre")); email.setFrom(mailSetup.getProperty("from.email"), mailSetup.getProperty("from.name")); email.setSubject(mailSetup.getProperty("mail.subject")); email.setHtmlMsg(html); email.setTextMsg(plain); // Enviamos el correo electrónico email.send(); } /** * Lee el contenido textual desde un stream de entrada * @param input Stream de entrada * @param encoding Codificación * @return El contenido del stream de entrada * @throws IOException Cualquier excepción de Entrada/Salida */ private static String fileToString(InputStream input, String encoding) throws IOException { StringWriter sw = new StringWriter(); InputStreamReader in = new InputStreamReader(input, encoding); char[] buffer = new char[1024 * 2]; int n = 0; while (-1 != (n = in.read(buffer))) { sw.write(buffer, 0, n); } return sw.toString(); } } |
Captura a escala reducida del correo electrónico enviado:
Algunas Consideraciones:
Cuidado con el tipo de html que elegís pues para que se vea bien en el mayor número de visores de
correo electrónic deberéis usar un HTML «primitivo» evitando hojas de estilo
que no sean «inline» (hasta la fecha, sólo funcionan usando en el atributo style) y nada de lenguajes de scripting.
Un saludo.
Carlos García. Autentia.
Me parece muy interesante el tutorial que enviaste pero tengo una duda. Si yo tengo en mi outlook el nivel de seguridad estandar, es decir, que no descargue imagenes automaticamente en formato html o en elemenots RSS por defecto, cuando le llega un mail con imagenes embebidas (decodificadas a base 64) como el que nos adjuntas, las voy a ver? O tengo que cambiar algo en la política de seguridad de mi outlook?
SendHtmlEmail.fileToString de doned es esta clase no la encuentro
Es la clase principal, si haces una copia de todo el código sin cambiar algo, no tendrás problemas.
public class SendHtmlEmail {
Saludos