Una buena funcionalidad a incluir dentro de cualquier página web es el envío de correos. El poder adjuntarla información que estamos leyendo en ese momento, vía correo a otra persona (o a sí mismo). Así que vamos a ver cómo podemos mandar emails con JavaMail.
El API de JavaMail nos permite el envío de correos. Abstrayéndonos de los protocolos de comunicación para el envío de emails (SMTP, POP3, MAIL,…).
Con muy pocas líneas de código nos permite el enviar un mensaje a una dirección de correo electrónico.
Los pasos a seguir serán:
- Propiedades del envío
- Obtener la sesión
- Configurar los campos del mensaje
- Configurar el texto del mensaje
- Enviar el mensaje
1. Propiedades de envío
Lo primero que tenemos que hacer es configurar las propiedades del envío. Es decir, cual es el servidor de correo que vamos a utilizar, si el servidor requiere autenticación, el tipo de transporte a utilizar,..
Todas las configuraciones las definimos mediante la clase Properties. Para incorporar una propiedad utilizamos el método .put(propiedad,valor)
Properties props = new Properties();
props.put("mail.smtp.host","mail.lineadecodigo.com");
props.put("mail.transport.protocol","smtp");
props.put("mail.smtp.auth", "true");
props.setProperty("mail.user", "myuser");
props.setProperty("mail.password", "mypwd");
Al menos las cuatro primeras propiedades son necesarias para realizar la conexión:
- mail.smtp.host, representa el host que hace de servidor de correo
- mail.transport.protocol, es el protocolo de comunicación que queremos utilizar para enviar el correo. En este caso es SMTP, pero podría ser mail.
- mail.smtp.auth, indica si se requiere de autenticación de SMTP.
- mail.user, es el usuario de la conexión.
- mail.password, el el password de la conexión.
2. Obtener la sesión
Una vez que tengamos definidas las propiedades, pasaremos a establecer la sesión con el servidor de correo. La sesión se establece mediante la clase Session.
Session mailSession = Session.getInstance(props,null);
3. Configurar los campos del mensaje
Sobre la sesión de correo vamos a crear un mensaje. Los mensajes se manejan mediante la clase Message. Para instanciarlo utilizaremos la siguiente línea de código:
Message msg = new MimeMessage(mailSession);
El mensaje hay que rellenarlo con datos: el usuario destino, el texto del mensaje, el «subject» del mensaje,… Para esto contamos con diferentes métodos dentro de la clase MimeMessage como .setSubject(String), setFrom(Adress),..
msg.setSubject("Mensaje de Línea de Código");
msg.setFrom(new InternetAddress("[email protected]","Línea de Código"));
msg.addRecipients(Message.RecipientType.TO, new InternetAddress[] { new InternetAddress("[email protected]") });
Entremos un poco más en detalle en estos métodos…
En el caso del .setSubject(String) no tiene mucho misterio, ya que simplemente es una línea de texto que represente el subject del correo.
Para el método .setFrom(Address) vemos que el parámetro que recibe es una clase Address. Esta clase viene a abstraer la dirección de email para los correos electrónicos.
Es por ello que tendremos que utilizar el constructor InternetAddress para crear una dirección de email. El constructor recibe dos parámetros, la dirección de email y el nombre asociado a dicha dirección (nombre que suelen usar los programas de correo como referente).
Veamos esa línea de código:
new InternetAddress("[email protected]","Línea de Código")
A la hora de especificar los destinatarios tenemos que utilizar el método .addRecipients(Message.RecipientType,Adress[]) Los parámetros de este método son dos:
- Message.RecipientType, el tipo de usuario que va a recibir el mensaje. Los valores serían TO, CC, BCC. O en español: para, en copia y en copia oculta.
- Adress[], como direcciones de email. Ya vimos anteriormente que los emails se montan con la clase InternetAddress.
4. Configurar el texto del mensaje
Para insertar el texto del mensaje utilizaremos el método .setDataHandler(DataHandler). El handler, representado por un DataHandler, tendrá el texto que se va a enviar y el tipo de codificación que le queremos aplicar. En este caso será «text/plain», ya que vamos a enviar texto plano.
DataHandler dh = new DataHandler("Texto del mensaje","text/plain");
msg.setDataHandler(dh);
5. Enviar el mensaje
El mensaje se enviará mediante la clase Transport. Esta clase tiene un método estático que se llama .send(Message). Dicho método recibirá el mensaje que hemos montado anteriormente como parámetro y lo enviará.
Solo necesitaremos la siguiente línea de código:
javax.mail.Transport.send(msg);
En el proceso de envío multiples excepciones pueden ser elevadas. Es por ello que deberemos de ejecutar todo nuestro código entre un try-catch.
Espero que os haya sido sencillo este pequeño ejemplo que paso a paso nos describe cómo mandar emails con JavaMail.
