Suponemos que ya te has bajado JavaMail y JAF. Vamos a ver cómo enviar un correo simple, un simple texto, usando JavaMail. Para el ejemplo, usaremos una cuenta de gmail como servidor de correo.
La configuración de esta cuenta (de cualquier cuenta de gmail) para el envío de correos es
Para este ejemplo sencillo, hay tres clases de JavaMail implicadas:
La clase Session representa nuestra conexión con el servidor de correo -gmail en nuestro caso-. Se obtiene con el método Session.getDefaultInstance() pasándole un parámetro:
Properties es una clase de java estándar java.util.Properties. Esta clase admite que guardemos en ella parejas "clave-valor", es decir, guardamos datos -de tipo String- dándoles un nombre a cada uno para luego poder recuperarlos. Esto se hace por medio del método setProperty(), de esta manera
Properties p = new Properties();
p.setProperty("un nombre", "un valor");
p.setProperty("PI", "3.1416");
Las Properties que necesita Session son específicas, es decir, tienen que tener unos nombres concretos y unos posibles valores concretos. En la API una lista de algunas de ellas y también en la API tienes una lista más completa.
Veremos aquí sólo las estrictamente necesarias para conectarnos con gmail y poder enviar mensajes. El código sería este
Properties props = new Properties();
// Nombre del host de correo, es smtp.gmail.com
props.setProperty("mail.smtp.host", "smtp.gmail.com");
// TLS si está disponible
props.setProperty("mail.smtp.starttls.enable", "true");
// Puerto de gmail para envio de correos
props.setProperty("mail.smtp.port","587");
// Nombre del usuario
props.setProperty("mail.smtp.user", "ejemplo@gmail.com");
// Si requiere o no usuario y password para
conectarse.
props.setProperty("mail.smtp.auth", "true");
Con esto estamos en disposición de obtener nuestra instancia de Session.
Session session = Session.getDefaultInstance(props);
session.setDebug(true);
Hemos puesto setDebug(true) para obtener más información por pantalla de lo que está sucediendo. Una vez que el programa nos funcione, podemos quitar esa línea sin problemas.
Ya tenemos nuestro objeto Session.
Vamos ahora a construir un mensaje simple de texto. Para ellos instanciamos la clase MimeMessage y le ponemos varios datos.
En el constructor debemos pasarle el objeto Session que obtuvimos anteriormente
MimeMessage message = new MimeMessage(session);
Ponemos luego el FROM y el TO del mensaje, es decir, quién lo envía y a quién va dirigido. Para meter estos datos usaremos los métodos setFrom() y addRecipient() de MimeMesage. Los parámetros que admiten estos métodos son instancias de javax.mail.internet.InternetAddress. En el constructor de esta clase InternetAddress símplemente ponemos la dirección de correo -ver código más abajo-.
Para los destinatarios usaremos el método addRecipient() de MimeMessage. Esta método admite dos parámetros, una constante para indicar el tipo de destinatario y otro que es el InternetAdress mencionado. El tipo de destinatario puede ser
En nuestro caso, sólo pondremos el TO y la dirección de correo.
// Quien envia el correo
message.setFrom(new InternetAddress("ejemplo@gmail.com"));
// A quien va dirigido
message.addRecipient(Message.RecipientType.TO, new InternetAddress("destinatario@dominio.com"));
Ahora sólo queda llenar el asunto -subject que dirían los ingleses- del mensaje y el texto. Como tenemos métodos para ello, setSubject() y setText(), no hay ningún problema.
message.setSubject("Hola");
message.setText("Mensajito con Java Mail" +
"de los buenos." +
"poque si");
Ya tenemos construido el mensaje.
Un pequeño detalle nada más. Este mensaje es de texto y el formato que se está usando es texto "plano", es decir, texto normalito, tal cual, sin más. Hay muchas formas de enviar texto. Se puede enviar, por ejemplo, en formato html, con lo que podríamos poner negritas, cursivas, etc.
Para enviar texto con otros formatos, debemos usar el mismo método setText(), pero con más parámetros. En concreto, podemos usar la versión de setText() que admite tres parámetros
El siguiente código crearía el mismo mensaje, pero con texto html y algún adorno de negrita y cursiva
message.setText(
"Mensajito con Java Mail<br>" + "<b>de</b>
los <i>buenos</i>." + "poque si",
"ISO-8859-1",
"html");
Para enviar el mensaje usamos la clase Transport, que se obtiene de Session. El método getTransport() requiere un parámetro String con el nombre del protocolo a usar. Como el de gmail es smtp, pues ponemos smtp.
Transport t = session.getTransport("smtp");
Ahora debemos establecer la conexión, dando el nombre de usuario y password.
t.connect("ejemplo@gmail.com","la password");
y ahora simplemente enviamos el mensaje
t.sendMessage(message,message.getAllRecipients());
El método de enviar mensaje es sendMessage() y NO sólo send(). El método send() es estático y no tiene en cuenta la conexión, ni el usuario ni la password. Es una forma rápida de envio de mensaje para un servidor smtp que no requiera autentificación. Como no es el caso, debemos usar sendMessage().
El método sendMessage(), además del mensaje, necesita la lista de receptores del mensaje, es decir, el array de direcciones a los que va el mensaje. La forma rápida de obtener este array es llamar al método getAllRecipients() de la clase MimeMessage, justo como lo hemos hecho en el código.
Con esto se envía el mensaje. Ahora solo queda cerrar la conexión
t.close();
Finalmente, aquí tienes el programa completo que he hecho con mi cuenta de gmail para probar: EnviarMail.java.
Vamos ahora a ver cómo recibir correos con JavaMail.