Utilisation de l'API JavaMail [40 mn de lecture - paru le 9/4/2003 - Public : Débutant]

Auteur

Julie MUESSER Elève-Ingénieur Supinfo Paris Promotion SUPINFO 2005    Lui écrire    Tous les projets de cet auteur    Le mini-CV de cet auteur

1. Découverte de L'API JavaMail

1.1 Ce que fait JavaMail

JavaMail est une API qui fournit un ensemble de classes afin de développer des clients mails en java ou bien des applications communiquant par mail.
JavaMail offre différents services comme :

Lire un message
Recherche d’un message dans un répertoire
Envoi d’un message
Lister les répertoires
Gestion d'une messagerie

1.2 Les packages

JavaMail est utilisé avec plusieurs packages :

javax.mail
javax.mail.event
javax.mail.internet
javax.mail.search

Vous pouvez trouver la documentation nécessaire à propos de ces différentes packages sur le lien suivant :

http://java.sun.com/products/javamail/javadocs/index.html

1.3 Architecture JavaMail

1.4 Les différents protocoles

1.4.1 SMTP

Simple Mail Transport Protocol.

Ce protocole défini permet l'envoie de mail vers un serveur de mail qui supporte ce protocole.

1.4.2 IMAP

Internet Message Acces Procol.

Ce protocole permet la réception de mail à partir d'un serveur de mail qui supporte ce protocole. Il est plus complexe car il apporte des fonctionnalités supplémentaires : plusieurs répertoires par utilisateur, partage de répertoire entre plusieurs utilisateurs, maintient des messages sur le serveur ...

1.4.3 POP

Post Office Protocol.

Ce protocole permet la réception de mail à partir d'un serveur de mail qui supporte ce protocole. Il est très populaire sur Internet. Il définit une boite au lettre unique pour chaque utilisateur. Une fois que le message est reçu par le client, il est effacé du serveur.

1.4.4 MIME

Multipurpose Internet Mail Extension.

C'est un protocole de transfert de fichier, où celui-ci est organisé en octets pour être transmis sous forme de fichiers caractères.
Il permet aussi permettant de faire correspondre au fichier transmis, le logiciel de consultation approprié.
MIME fixe une liste de types et de sous-types pour chaque fichier.

Voici la liste des Types et sous-Types les plus rencontrés.

1.4.5 MNTP

News Transport Protocol.

Ce protocole est utilisé pour la gestion des forums de discussion (news).

Le schéma ci-dessous montre un client utilisant le protocole IMAP4 pour lire les messages et le protocole SMTP pour envoyer un mail :

1.5 La manipulation de message

La manipulation des messages grâce à l’API JavaMail peut être représenté par les schémas suivants :

1.6 Téléchargement et installation

JavaMail est une extension au JDK, elle n'est donc pas fournie en standard, par contre elle est intégrée au J2EE.
Il existe deux versions de l'API, 1.2 et 1.1.3. C'est à vous de choisir la version que vous utiliserez
La version 1.1.3 est cependant la plus utilisée car elle contient la version 1.2.1 de la plateforme Java 2 et J2EE.

L'installation sera différente suivant la version de JavaMail que vous utiliserez.
Pour utiliser la version 1.1.3 il est nécessaire de télécharger les fichiers utiles et de les installer
Vous trouvez ces fichiers sur le site de SUN:
http://java.sun.com/products/javamail

Une fois les fichiers téléchargés, il faut dezipper le fichier dans un répertoire et ajouter le fichier mail.jar dans le CLASSPATH.

Cette version contient les protocoles SMTP et IMAP, cependant si vous souhaiter accéder à un serveur POP, vous devrez télécharger le protocole POP3, ensuite le dézipper et ajouter le fichier pop3.jar dans le CLASSPATH.

Pour la version 1.2, il faut télécharger les fichiers,dezipper le fichier dans un répertoire et ajouter le fichier mail.jar dans le CLASSPATH.

Cette version contient les protocoles SMTP, IMAP et POP3.

Ensuite, quelque soit la version installée il est nécessaire d'installer le framework JAF (Java Activation Framework) : télécharger le fichier, dezipper et ajouter le fichier activation.jar dans le CLASSPATH.

Pour ceux qui utilisent JEE, l'API est déjà fournie, donc il n'y a rien à faire. Seulement pour JEE 1.2.1, il faut quand même télécharger le protocole POP