Posts tagged ‘javamail’

HOWTO: configure Tomcat to send mails, using javamail

This article shows step by step a way to configure Apache Tomcat J2EE server to send emails.

You will need first a working Tomcat server of course, and a mail server. You can have it on your own machine, just like me, so the smtp server would be « localhost », or on another machine from which you can use smtp, for instance your Internet Service Provider smtp (generally smtp.nameofyourISP.com)

Step 1 : Install the right libraries:

Sending mails with tomcat require 2 librairie: the javamail API, and the Java Activation Framework (jaf).
Depending on your JDK /JRE version, you will need to place 1 or 2 files in your /catalina_home/commons/libs/ folder.
If you have a 1.6 java version (check with java -version) you will need only the mail.jar otherwise, you will need both mail.jar and activation.jar.

Important: you must not include these two files into your webapp, or you will get an almost wired error:
java.lang.ClassCastException: javax.mail.Session cannot be cast to javax.mail.Session

Let’s download the files:

javamail-1_4_1.zip

With JDK / JRE 1.6 it’s the only one you will need. With other versions, take also this file: java activation framework

Unzip these file (if needed, on a Debian system for instance, download the zip package: apt-get unzip), and move it to the appropriate catalina folder (don’t forget to stop tomat service before).

mv /home/your_username/javamail-1.4.1/mail.jar /your_tomcat_home/common/lib/

The same applies to the activaction.jar if needed.

2. Configure your webapp:

2 step to configure your webapp. First, edit the conext.xml, and declare you mail ressource to make it available:

<Resource auth="Container" mail.smtp.host="localhost" name="mail/NomDeLaRessource" type="javax.mail.Session"/>

Next, edit your web.xml file and declare your webapp using your mail resource:

<resource-ref>
<description>Votre description </description>
<res-ref-name>mail/NomDeLaRessource</res-ref-name>
<res-type>javax.mail.Session</res-type>
<res-auth>Container</res-auth>
<res-sharing-scope>Shareable</res-sharing-scope>
</resource-ref>

3. Write the code

To test your configuration, here is a working sample code:

Session session = null;
try {
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup(« java:comp/env »);
session = (Session) envCtx.lookup(« mail/NomDeLaRessource »);

} catch (Exception ex) {
System.out.println(« lookup error »);
System.out.println( ex.getMessage());
}

Here is the code which actually send the mail:


Message message = new MimeMessage(session);
try {
message.setFrom(new InternetAddress(expediteur);
InternetAddress to[] = new InternetAddress[1];
to[0] = new InternetAddress(destinataire);
message.setRecipients(Message.RecipientType.TO, to);
message.setSubject(sujet);
message.setContent(corps, "text/html;charset=UTF-8");
Transport.send(message);
} catch (AddressException ex) {
System.out.println( ex.getMessage());
} catch (MessagingException ex) {
System.out.println( ex.getMessage());
}

The most convenient is to create a hepler method, with receiver adress, subject, body, etc…but that’s your work 🙂

Thanks goes to tomcat mailing list people, especially Chuck and Martin.

Références : tomcat.apache.org/

Publicités

26 septembre 2008 at 9 h 27 min 10 commentaires

Configurer Tomcat pour envoyer des mails

Cet article présente pas à pas une méthode pour configurer le serveur J2EE Tomcat afin de pouvoir envoyer des mails.

Vous aurez besoin au préalable d’un Tomcat installé, et d’un serveur de mail sortant (installé sur votre serveur, comme dans le cas de cet article, ou bien acceptant de relayer vos mail – par exemple le serveur SMTP de votre FAI mail.free.fr, mail.wanadoo.fr, etc…).

1 Installer les librairies de l’API JavaMail:

Il faut placer les fichiers mail.jar et activation.jar dans le dossier /catalina_home/commons/libs/.

J’insiste sur ce point: il est important de ne pas inclure ces 2 librairies dans votre webapp, sous peine d’avoir cette erreur assez peu explicite:

java.lang.ClassCastException: javax.mail.Session cannot be cast to javax.mail.Session

Nous allons donc télécharger ces deux librairies:

javamail-1_4_1.zip

Si vous utiliser le JDK 1.6 ou le JRE, vous n’auraez besoin que de javamail.

On dézippe l’archive fraichement utilisée (j’ai du télécharger le paquet unzip avec apt-get unzip, car gunzip ne prend en charge que les archives .gz), puis on place la librairie (n’oubliez pas de stopper le serveur avant).

mv /home/votre_username/javamail-1.4.1/mail.jar /opt/tomcat/common/lib/

Faire la même chose avec le fichier activation.jar si vous n’utiliser pas le JRE en version 6.

Si vous utilisez une version antérieure, vous aurez besoin également du Java Activation Framework:

2. Configurer la webapp:

La configuration s’effectue en deux étapes. Dans le fichier context.xml, on va déclarer la ressource avec cette ligne:

<Resource auth="Container" mail.smtp.host="localhost" name="mail/NomDeLaRessource" type="javax.mail.Session"/>

Ensuite, dans le fichier web.xml on va déclarer l’utilisation de la ressource afin qu’elle soit accessible par la webapp:

<resource-ref>
<description>Votre description </description>
<res-ref-name>mail/NomDeLaRessource</res-ref-name>
<res-type>javax.mail.Session</res-type>
<res-auth>Container</res-auth>
<res-sharing-scope>Shareable</res-sharing-scope>
</resource-ref>

3. Ecrire le code

Pour accéder à la ressource qu’on vient de définir, il faut utiliser le code java suivant :

Session session = null;
try {
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
session = (Session) envCtx.lookup("mail/NomDeLaRessource");

} catch (Exception ex) {
System.out.println("erreur au lookup");
System.out.println( ex.getMessage());
}

Ensuite, voici un exemple qui permet d’envoyer les messages:

Message message = new MimeMessage(session);
try {
message.setFrom(new InternetAddress(expediteur);
InternetAddress to[] = new InternetAddress[1];
to[0] = new InternetAddress(destinataire);
message.setRecipients(Message.RecipientType.TO, to);
message.setSubject(sujet);
message.setContent(corps, "text/html;charset=UTF-8");
Transport.send(message);
} catch (AddressException ex) {
System.out.println( ex.getMessage());
} catch (MessagingException ex) {
System.out.println( ex.getMessage());
}

Le plus pratique est de créer une fonction « helper » pour pouvoir envoyer des messages facilement, du type envoyerMessage(destinataires[],sujets[],corps[])… mais ce n’est pas l’objet de cet article.

Maintenant,votre Tomcat devrait être prêt pour envoyer des mails !

Références : tomcat.apache.org/
Tomcat mailing-list

26 septembre 2008 at 8 h 59 min 1 commentaire


Articles récents