API JavaMail

Hay dos versiones del API JavaMail usadas comunmente hoy en dia: la 1.2 y la 1.1.3. Todos los ejemplos de este art�culo funcionan con �mbas. Mientras 1.2 es el �ltimo, 1.1.3 es la versi�n incluida en la versi�n 1.2.1 de la Plataforma Java 2 Enterprise Edition (J2EE), por eso es tan usado. La versi�n del API que queramos usar afecta a lo que tengamos que descargar e instalar. Todo funcionar� con el JDK 1.1.6+, de la Plataforma Java 2, Standard Edition (J2SE) versi�n 1.2.x, y J2SE versi�n 1.3.x.

�Instalar JavaMail 1.2

Para usar el API JavaMail 1.2, descargamos la implementaci�n, JavaMail 1.2, descomprimimos el fichero javamail-1_2.zip, y a�adimos el fichero mail.jar a nuestro CLASSPATH. La implementaci�n 1.2 viene con proveedores para SMTP, IMAP4, y POP3 junto con las clases coraz�n.

Despu�s de instalar JavaMail 1.2, instalamos el marco de trabajo de activaci�n de JavaBeans.

�Instalar JavaMail 1.1.3

Para usar el API JavaMail 1.1.3, descargamos la implementaci�n JavaMail 1.1.3, descomprimimos el ficheros javamail1_1_3.zip, y a�adimos el fichero mail.jar a nuestro CLASSPATH. La implementaci�n 1.1.3 viene con proveedores para SMTP y IMAP4, junto con las clases coraz�n.

Si queremos acceder a un servidor POP con JavaMail 1.1.3, descargamos e instalamos un proveedor POP3. Sun tiene uno disponible separado de la implementaci�n de JavaMail. despu�s de descargar y descomprimir pop31_1_1.zip, tambi�n a�adimos pop3.jar a nuestro CLASSPATH.

Despu�s de instalar JavaMail 1.1.3, instalamos el marco de trabajo de activaci�n de JavaBeans.

�Instalar el Marco de Trabajo de Activaci�n de JavaBeans

Todas las versiones del API JavaMail requieren el Marco de Trabajo para la Activaci�n de JavaBeans.

El marco de trabajo a�ade soporte para tecleo arbitrario de bloques de datos y manejarlos correctamente. Esto no suena muy bien, pero es nuestro soporte b�sico para MIME-type encontrado en muchos navegadores y herramientas de correo, hoy en d�a. Despu�s de descargar el marco de trabajo, descomprimimos el fichero jaf1_0_1.zip, y a�adimos el fichero activation.jar a nuestro CLASSPATH.

Para usuarios de JavaMail 1.2, deber�amos tener mail.jar y activation.jar en nuestro CLASSPATH.

Para usuarios de JavaMail 1.1.3, deber�amos tener mail.jar, pop3.jar, y activation.jar en nuestro CLASSPATH. Si no tenemos planes de utilizar POP3, no necesitamos a�adirlo a nuestro CLASSPATH.

Si no queremos modificar nuestra variable de entorno CLASSPATH, copiamos los ficheros JAR a nuestro directorio lib/ext bajo el directorio del Java Runtime Environment (JRE). Por ejemplo, para la versi�n J2SE 1.3, el directorio por defecto ser�a C:\jdk1.3\jre\lib\ext en una plataforma Windows.

�Usarlo con Java 2 Enterprise Edition

Si usamos J2EE, no tenemos que hacer nada especial para usar el API b�sico de JavaMail; viene con las clases del J2EE. S�lo debemos asegurarnos de que el fichero j2ee.jar est� en nuestro CLASSPATH y que tenemos todo configurado.

Para J2EE 1.2.1, el proveedor POP3 viene separado, por eso lo descargamos y seguimos los pasos para incluir el proveedor POP3 como se mostr� en Instalar JavaMail 1.1.3. Los usuario de J2EE 1.3 obtienen el proveedor POP3 con el J2EE por eso no requieren una instalaci�n separada. Tampoco se requiere ninguna instalaci�n para el Marco de Trabajo de Activaci�n de JavaBeans.

�Configurar Nuestro Entorno JavaMail

�Paso 1

Descargar la �ltima versi�n de la implementaci�n del API JavaMail desde Sun.

�Paso 2

Descargar la �ltima versi�n del Marco de Trabajo de Activaci�n de JavaBeans desde Sun.

�Paso 3

Descomprimir los paquetes descargados. Obtendremos un fichero ZIP para todas los plataformas de los dos paquetes.

Podemos usar la herramienta jar para descomprimir los paquetes.

�Paso 4

A�adimos los ficheros mail.jar y activation.jar recien descomprimidos a nuestro CLASSPATH.

Copiamos estos ficheros a nuestro directorio de librer�as de extensi�n. Para Windows, y usando una instalaci�n por defecto, el comando se parecer�a a esto:

cd \javamail-1.2
copy mail.jar \jdk1.3\jre\lib\ext
cd \jaf-1.0.1
copy activation.jar \jdk1.3\jre\lib\ext

Si no nos gusta copiar los ficheros al directorio de librer�as de extensi�n, en Sun puedes encontrar instrucciones detalladas para configurar el CLASSPATH sobre Windows NT

�Paso 5

Vamos dentro del directorio demo que viene con la implementaci�n del API JavaMail y compilamos el programa msgsend para enviar un mensaje de prueba:

javac msgsend.java

�Paso 6

Ejecutamos el programa pasandole una direcci�n "from" en la opci�n -o, nuestro servidor SMTP con la opci�n -M, y la direcci�n "to" (sin opci�n). Luego introduciremos el subject, el texto de nuestro mensaje y el caracter de fin-de-fichero (CTRL-Z) para indicar el final de la introducci�n del mensaje.

Debemos asegurarnos de reemplazar las direcciones correctas:

java msgsend -o from@address -M SMTP.Server to@address

Si no estas seguro de tu servidor SMTP, contacta con el administrador de tu sistema o pregunta a tu proveedor de Internet.

�Paso 7

Para asegurarnos de que hemos recibido el mensaje, debemos chequearlo con nuestro lector de correo habitual (Eudora, Outlook Express, pine, ...).