API JavaMail

Antes de profundizar en las classes de JavaMail, veremos las clases corazn que componen el API: Session, Message, Address, Authenticator, Transport, Store, y Folder. Todas estas clases se encuentran en el paquete del nivel superior del API JavaMail: javax.mail, aunque frecuentemente nos veremos utilizando clases del paquete javax.mail.internet.

.Session

La clase Session define una sesin de correo bsica. Es a travs de esta de sesin de la que todas las dems funcionan. El objeto Session se aprovecha de un objeto java.util.Properties para obtener informacin como el servidor de correo, el nombre de usuario, la password, y otra informacin que puede compartirse a lo largo de toda la aplicacin.

El constructor para las clases es privado. Podemos obtener una sola sesin por defecto que puede ser compartida con el mtodo getDefaultInstance():

Properties props = new Properties();
// fill props with any information
Session session = Session.getDefaultInstance(props, null);

O podemos crear una nica sesin con getInstance():

Properties props = new Properties();
// fill props with any information
Session session = Session.getInstance(props, null);

En ambos casos el argumento null es un objeto Authenticator que no se utiliza en este momento, lo veremos ms adelante en Authenticator.

En la mayora de los casos, es suficiente usar la sesin compartida, incluso si se trabaja con una sesin de correo para mltiples mailboxes de usuario. Podemos aadir una combinacin de nombre de usuario y passsword en un paso posterior en el proceso de comunicacin, manteniendolo todo separado.

.Message

Una vez que tenemos nuestro objeto Session, es hora de empezar a crear un mensaje para enviar. Esto se hace con un objeto Message.

Siendo una clase abstracta, debemos trabajar con una subcalse, en la mayora de los casos ser javax.mail.internet.MimeMessage.

Un MimeMessage es un mensaje de e-mail que entiende los tipos MIME, definidos en las distintas RFCs. Las cabeceras de mensajes estn restringidas a caracteres US-ASCII, aunque en ciertos campos de cabecera se pueden codificar caracteres no ASCII.

Para crear un Message, le pasamos el objeto Session al constructor de MimeMessage:

MimeMessage message = new MimeMessage(session);
Nota: Hay otros constructores, como para crear mensajes desde streams de entrada formateados RFC822.

Una vez que tenemos nuestro mensaje, podemos configurar sus diferentes partes, como Message implementa el interface Part (con MimeMessage implementando MimePart).

El mecanismo bsico para configurar el contenidos es el mtodo setContent(), con los argumentos para el contenido y tipo mime:

message.setContent("Hello", "text/plain");

Sin embargo, si sabemos que estmos trabajando con un MimeMessage y nuestro mensaje es texto plano, podemos usar su mtodo setText() que slo requiere el contenido real, dejando por defecto el tipo MIME a text/plain:

message.setText("Hello");

Para mensajes de texto plano la ltima forma es el mecanismo preferido para seleccionar el contenido. Para enviar otros tipos de mensajes, como HTML, usaremos el formador, que veremos ms adelante.

Para seleccionar el subject, usamos el mtodo setSubject():

message.setSubject("First");

.Address

Una vez que hemos creado la Session y el Message, y tambin hemos rellenado el mensaje con contenido, es hora de poner direccin a nuestra carta con un objeto Address.

Como Message, Address es una clase abstracta. Usaremos la clase javax.mail.internet.InternetAddress.

Para crear una direccin con slo la direccin e-mail, se la pasamos al constructor:

Address address = new InternetAddress("president@whitehouse.gov");

Si queremos que aparezca el nombre junto a la direccin e-mail, tambin podemos pasrselo al constructor:

Address address = new InternetAddress("president@whitehouse.gov", "George Bush");

Necesitaremos crear objetos address para los campos from y to del mensaje. A menos que el servidor lo evite, no hay nada que nos impida enviar un mensaje que parezca que viene de otra persona.

Una vez que hemos creado las direcciones, las conectamos al mensaje de una de estas dos formas. Para identificar al que lo enva, usamos los mtodos setFrom() y setReplyTo().

message.setFrom(address)

Si nuestro mensane necesita varias direcciones "from", usamos el mtodo addFrom():

Address address[] = ...;
message.addFrom(address);

Para identificar a los receptores del mensaje, usamos el mtodo addRecipient(). Este mtodo requiere un Message.RecipientType junto a la direccin.

message.addRecipient(type, address)

Los tres tipos predefinidos de direcciones son:

  • Message.RecipientType.TO
  • Message.RecipientType.CC
  • Message.RecipientType.BCC

Por eso, si el mensaeje fuera dirigido al vice-presidete, enviando copia a la primera dama, esto sera lo apropiado:

Address toAddress = new InternetAddress("vice.president@whitehouse.gov");
Address ccAddress = new InternetAddress("first.lady@whitehouse.gov");
message.addRecipient(Message.RecipientType.TO, toAddress);
message.addRecipient(Message.RecipientType.CC, ccAddress);

El API JavaMail no proporciona mecanismo para chequear la validez de una direccin e-mail. Pero si podemos hacer que nuestro programa soporte un scan de caracteres vlidos (segn lo definido en la RFC 822) o verificar nosotros mismos el registro MX (Mai Exchange), esto va ms all del mbito del API JavaMail.

.Authenticator

Como las clases java.net, el API JavaMail peude aprovecharse de un Authenticator para proteger accesos a recursos mediante un nombre de usuario y una password. Para el API JavaMail, el recursos es el servidor de correo. El Authenticator JavaMail se encuentra en el paquete javax.mail y es diferente de la clase de java.net con el mismo nombre. Las dos no comparten el mismo Authenticator ya que el API JavaMail funciona con Java 1.1, que no tena la veriedad java.net.

Para usar el Authenticator, subclasificamos la clase abstracta y devolvemos un ejemplar PasswordAuthentication del mtodo getPasswordAuthentication(). Debemos registrar el Authenticator con la sesin cuando se crea. Luego, nuestro Authenticator ser notificado cuando sea necesaria una autentificacin. Podramos mostrar una ventana o leer el nombre de usuario y la password desde un fichero de configuracin (aunque si no est encriptado no es seguro), devolviendolo al llamador como un objeto PasswordAuthentication.

Properties props = new Properties();
// fill props with any information
Authenticator auth = new MyAuthenticator();
Session session = Session.getDefaultInstance(props, auth);

.Transport

La parte final del envo de un mensaje es usar la clase Transport. Estas clase habla el lenguaje especfico del protocolo para enviar mensajes (normalmente SMTP). Es una clase abstracta y funciona como Session.

Podemos usar la versin por defecto de la clase slo llamando al mtodo esttico send():

Transport.send(message);

O, podemos obtener un ejemplar especfico desde la sesin para nuestro protocolo, pasndole el nombre de usuario y la password (en blanco si no son necesarias), enviar el mensaje, y cerrar la conexin:

message.saveChanges(); // implicit with send()
Transport transport = session.getTransport("smtp");
transport.connect(host, username, password);
transport.sendMessage(message, message.getAllRecipients());
transport.close();

Esta ltima forma es mejor cuando necesitamos enviar varios mensajes, porque mantendr activa la conexin entre mensajes. El mecanismo bsico send() hace un conexin separada al servidor para cada llamada a mtodo.

Nota: Para ver los comandos enviados al servidor de correo activaremos la bandera debug con session.setDebug(true).

.Store y Folder

Obtener los mensajes empieza de forma similar a enviar mensajes, con una Session.

Sin embargo, despus de obtener la sesin, conectamos a un Store, probablemente con un nombre de usuario y una password o Authenticator. Como con Transport, le decimos al Store qu protocolo utilizar:

// Store store = session.getStore("imap");
Store store = session.getStore("pop3");
store.connect(host, username, password);

Despus de conectar al Store, podemos obtener un Folder, que debe estar abierto antes de poder leer los mensajes que hay en su interior:

Folder folder = store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
Message message[] = folder.getMessages();

Para POP3, la nica carpeta disponible es INBOX. Si estamos usando IMAP, podremos disponer de otras carpetas.

Nota: Los proveedores de Sun se han pensado para ser inteligentes. Mientras que Message message[] = folder.getMessages(); podra parecer una operacin lenta que lee todos los mensajes del servidor, slo cuando realmente necesitamos obtener una parte del mensaje es cuando el contenido es recuperado.

Una vez que tenemos un Message para leer, podemos obtener sus contenidos con getContent() o escribir sus contenidos en un stream con writeTo(). El mtodo getContent() slo obtiene el contenido del mensaje, mientras que la salida de writeTo() incluye las cabeceras.

System.out.println(((MimeMessage)message).getContent());

Despus de haber ledo el e-mail, cerramos la conexin al folder y al store.

folder.close(aBoolean);
store.close();

El valor boolenao pasado al mtodo close() del folder significa si actualizamos o no la carpeta eliminando los mensajes borrados.

.Ms all

Esencialmente, entender cmo usar las siete clases es todo lo que necesitamos para manejar el API JavaMail. La mayora de las otras capacidades del API JavaMail construidas desde estas siete clases hacen algo un poco diferente o de una forma particular, como si el contenido es un attachment. Ciertas tareas, como las bsquedas, estn aisladas y se describen en la seccin Busquedas por SearchItem.

COMPARTE ESTE ARTÍCULO

ENVIAR A UN AMIGO
COMPARTIR EN FACEBOOK
COMPARTIR EN TWITTER
COMPARTIR EN GOOGLE +
ARTÍCULO ANTERIOR

SIGUIENTE ARTÍCULO

HAY 1 COMENTARIOS
  • Sin Nombre dijo:

    NO SE VEN LAS IMAGENES

Conéctate o Regístrate para dejar tu comentario.