PDF de programación - API JavaMail

Java en castellano recomienda...

No se puede mostrar la página

La página Web solicitada no está disponible en este momento.

API JavaMail
Autor: Juan Antonio Palos (Ozito)

Indice de contenidos

l API JavaMail

¡ Introducción al API JavaMail
¡ Revisión de los Protocolos Relacionados

n SMTP
n POP
n IMAP
n MIME
n NNTP y Otros

l Instalar el API JavaMail

¡ Instalación

n Instalar JavaMail 1.2
n Instalar JavaMail 1.1.3
n Instalar el Marco de Trabajo de Activación de JavaBeans
n Usarlo con Java 2 Enterprise Edition

¡ Configurar Nuestro Entorno JavaMail

n Paso 1
n Paso 2
n Paso 3
n Paso 4
n Paso 5
n Paso 6
n Paso 7
l Las clases Corazón

¡ Revisar las Clases Corazón

n Session
n Message
n Address
n Authenticator
n Transport
n Store y Folder
n Más allá

l Utilización del API JavaMail

¡ Enviar Mensajes
¡ Leer Mensajes
¡ Borrar Mensajes y Banderas
¡ Autentificación
¡ Responder a Mensajes
¡ Re-Enviar Mensajes
¡ Trabajar con Attachments
¡ Enviar Attachments
¡ Obtener Attachments
¡ Procesar Mensajes HTML
¡ Enviar Mensajes HTML
¡ Includir Imágenes en Nuestos Mensajes

l Buscar Con SearchTerm

¡ Búsquedas con SearchTerm
¡ Recursos

Java en castellano recomienda...

No se puede mostrar la página

La página Web solicitada no está disponible en este momento.

API JavaMail

En esta página:

l API JavaMail

¡ Introducción al API JavaMail
¡ Revisión de los Protocolos Relacionados

n SMTP
n POP
n IMAP
n MIME
n NNTP y Otros



API JavaMail
Introducción al API JavaMail
El API JavaMail es un paquete opcional (extensión estándard) para leer, componer, y enviar
mensajes electrónicos.

Usamos este paquete para crear programas del tipo MUA (Mail User Agent), similares a Eudora,
Pine, y Microsoft Outlook. Su propósito principal no es transportar, enviar, o re-enviar mensajes
como sendmail u otros programas del tipo MTA (Mail Transfer Agent). En otras palabras, los
usuarios interactúan con los programas para leer y escribir e-mails. Los programas MUA tratan
con los programas MTA para el envío real.

El API JavaMail está diseñado para proporcionar acceso independiente del protocolo para enviar
y recibir mensajes dividiendose en dos partes:

l La primera parte del API es el foco de este tutor. Basicamente, cómo enviar y recibir

mensajes independientemente del proveedor/protocolo.

l La segunda parte habla de lenguajes especificos del protocolo como SMTP, POP, IMAP, y

NNTP. Con el API, JavaMail para poder comunicar con un servidor, necesitamos un
proveedor para un protocolo.

Revisión de los Protocolos Relacionados
Antes de mirar dentro de las especificaciones del API JavaMail, echemos un vistazo a los
protocolos usados con el API. Básicamente son cuatro:

l SMTP
l POP
l IMAP
l MIME

También ejecutaremos sobre NNTP y algunos otros. Entender lo básico de cada protocolo nos
ayudará a entender mejor cómo usar el API JavaMail. Aunque el API sea independiente del
protocolo, no podemos evitar las limitaciones de los protocolos subyacentes. Si una capacidad
no está soportada por el protocolo elegido, el API JavaMail no hará que esa capacidad aparezca

por arte de magia.

(Como veremos pronto, este es un problema normal cuando trabajamos con POP).

SMTP
El protocolo Simple Mail Transfer Protocol (SMTP) está definido por la RFC 821. Define el
mecanismo para enviar e-mail. En el contexto del API JavaMail, nuestro programa basado en
JavaMail comunicará con el servidor SMTP de nuestro proveedor de servicios (ISP). Este servidor
SMTP dejará el mensaje en el servidor SMTP del recipiente(s) para que sea recogido por los
usuarios a través de POP o IMAP. Esto no requiere que nuestro servidor SMTP sea un rele
abierto, pues se utiliza la autentificación, pero es nuestra responsabilidad asegurarnos de que
el servidor SMTP se configure correctamente. No hay nada en el API JavaMail sobre tareas como
el configuración de un servidor para retransmitir mensajes o para agregar y para quitar cuentas
del e-mail.

POP
POP viene de Post Office Protocol. Actualmante en la versión 3, también conocido como POP3,
la RFC 1939 define este protocolo.

POP es el mecanismo que la mayoría de la gente usa en Internet para conseguir su correo.
Define el soporte de un sólo mailbox por cada usuario. Ésto es todo lo que lo hace, y ésta
también es la fuente de la mayoría de la confusión. Muchas de las cosas con que gente se
familiariza cuando usa POP, como la capacidad de ver cuántos mensajes de correo nuevos
tienen, no lo soporta POP en absoluto. Estas capacidades se construyen en programas como
Eudora o Microsoft Outlook, que recuerdan cosas como los últimos correos recibidos y calculan
cuántos tenemos nuevos. Así pues, al usar el API JavaMail, si queremos este tipo de información
tendremos que calcularla nosotros mismos.

IMAP
IMAP es un protocolo más avanzado para recibir mensajes. Definido en la RFC 2060, IMAP viene
de Internet Message Access Protocol, y está actualmente en la versión 4, también conocida
como IMAP4. Para usar el IMAP, nuestro servidor de correo debe soportar este protocolo. No
podemos simplemente cambiar nuestro programa para usar IMAP en vez de POP y que se
soporte todo IMAP. Si asumimos que nuestro servidor de correo soporta IAMP, nuestro
programa basado en JavaMail puede aprovecharse de los usuario que tienen carpetas múltiples
en el servidor y estas carpetas se pueden compartir por varios usuarios.

Debido a las capacidades más avanzadas, podríamos pensar que IMAP sería utilizado por todos.
Pero no es así. Sobrecarga mucho el servidor de correo, requiriendo que el servidor reciba los
nuevos mensajes, los entrege a los usuarios cuando sean solicitados, y los mantiene en las
distintas carpetas de cada usuario. Aunque que esto centraliza las copias de seguridad,
también hace que las carpetas de correo a largo plazo de los usuarios se hagan cada vez más
grandes, y todo el mundo sufre cuando se agota el espacio en el disco. Con POP, los mensajes
recuperados son eliminados del servidor de correo.

MIME
MIME viene de Multipurpose Internet Mail Extensions. No es un protocolo de transferencia de
e-mail. En su lugar, define el contenido de lo que se está transfiriendo: el formato de los
mensajes, los attachments, etc. Hay muchos documentos que tienen efecto sobre esto: las RFC
822, RFC 2045, RFC 2046, y RFC 2047. Como usuario del API JavaMail, normalmente no
tendremos que preocuparnos sobre estos formatos. Sin embargo, estos formatos existen y son
utilizados por nuestros programas.

NNTP y Otros
A causa de la división del API JavaMail entre proveedor y cualquier otra cosa, podemos
fácilmente soportar protocolos adicionales. Sun Mantiene una lista de proveedores de terceras
partes que se aprovechan de los protocolos para los que Sun no proporciona soporte. Allí
encontraremos soporte para NNTP Network News Transport Protocol [newsgroups], S/MIME
Secure Multipurpose Internet Mail Extensions, y más.



Java en castellano recomienda...

No se puede mostrar la página

La página Web solicitada no está disponible en este momento.



API JavaMail

En esta página:

l Instalar el API JavaMail

¡ Instalación

n Instalar JavaMail 1.2
n Instalar JavaMail 1.1.3
n Instalar el Marco de Trabajo de Activación de JavaBeans
n Usarlo con Java 2 Enterprise Edition

¡ Configurar Nuestro Entorno JavaMail

n Paso 1
n Paso 2
n Paso 3
n Paso 4
n Paso 5
n Paso 6
n Paso 7

Instalar el API JavaMail
Instalación
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.

Nota: después de instalar la implementación de JavaMail de Sun, podrás encontrar
muchos programas de ejemplo en el directorio: demo.

Instalar JavaMail 1.2

Para usar el API JavaMail 1.2,
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.

descargamos la implementación, JavaMail 1.2, descomprimimos

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,
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.

descargamos la implementación JavaMail 1.1.3,

Si queremos acceder a un servidor POP con JavaMail 1.1.3,
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.

descargamos e instalamos un

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