CLASSE HELPER POUR L'ENVOI DE MAILS

/*
 * Created on 10 nov. 2004
 */
package xxxx.util;

import java.util.Properties;

import javax.mail.Message;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;

/**
 * Classe pour simplifier les envois de mails
 * @author SMAC
 */
public class Mail {
	/** Type texte brut */
	static public final int TEXT = 0;
	/** Type text/html */
	static public final int HTML = 1;
	
	/** Adresse "no-reply" par défaut de l'entreprise */
	private static final String NOREPLY = "noreply@societe.fr";
	/** Adresse du serveur SMTP de l'entreprise */
	private static final String SMTPHOST = "smtp.societe.fr";
	
	private Properties props;
	private Session session;
	private MimeMessage mm;
	private int mimetype;
	/**
	 * Si on n'appelle pas setFrom, met automatiquement noreply@societe.fr
	 */
	private boolean noreply = true;
	
	/**
	 * Créateur d'un mail.
	 */
	public Mail() {
		//Par défaut en texte brut
		mimetype = TEXT;
		
		//Get system properties
		props = System.getProperties();
		//Setup mail server
		props.put("mail.smtp.host", SMTPHOST);
		//Get session
		session = Session.getDefaultInstance(props, null);
		//Define message
		mm = new MimeMessage(session);
	}
		
	//############################################################
	//Ajout d'expéditeur et destinataires
	//############################################################
	
	/**
	 * Ajoute un expéditeur
	 * @param expediteur
	 * @throws Exception
	 */
	public void setFrom(String expediteur) throws Exception {
		if (expediteur.trim().length() > 0) {
			mm.setFrom(checkMail(expediteur));
			noreply = false;
		}
	}
	
	/**
	 * Ajoute un destinataire
	 * @param destinataire
	 * @throws Exception
	 */
	public void setTo(String destinataire) throws Exception {
		if (destinataire.trim().length() > 0) {
			if (plusieursMails(destinataire))
				setTo(decoupe(destinataire));
			else {
				mm.addRecipient(Message.RecipientType.TO, checkMail(destinataire));
			}
		}
	}
	/**
	 * Ajoute plusieurs destinataires
	 * @param dest
	 * @throws Exception
	 */
	public void setTo(String[] dest) throws Exception {
		for (int i=0; i<dest.length; i++)
			setTo(dest[i]);
	}
	
	/**
	 * Ajoute un destinataire en copie
	 * @param cc
	 * @throws Exception
	 */
	public void setCC(String cc) throws Exception {
		if (cc.trim().length() > 0) {
			if (plusieursMails(cc))
				setCC(decoupe(cc));
			else {
				mm.addRecipient(Message.RecipientType.CC, checkMail(cc));
			}
		}
	}
	/**
	 * Ajoute plusieurs destinataires en copie
	 * @param cc
	 * @throws Exception
	 */
	public void setCC(String[] cc) throws Exception {
		for (int i=0; i < cc.length; i++)
			setCC(cc[i]);
	}
	
	/**
	 * Ajoute un destinataire en copie cachée.
	 * @param bcc
	 * @throws Exception
	 */
	public void setCopieCachee(String bcc) throws Exception {
		if (bcc.trim().length() > 0) {
			if (plusieursMails(bcc))
				setCopieCachee(decoupe(bcc));
			else {
				mm.addRecipient(Message.RecipientType.BCC, checkMail(bcc));
			}
		}
	}
	/**
	 * Ajoute plusieurs destinataires en copie cachée.
	 * @param bcc
	 * @throws Exception
	 */
	public void setCopieCachee(String[] bcc) throws Exception {
		for (int i=0; i < bcc.length; i++)
			setCopieCachee(bcc[i]);
	}
	
	//############################################################
	//Champs avec destinataires multiples
	//############################################################

	/**
	 * Teste si y'a plusieurs mails dans la chaîne, séparés par un espace, une virgule ou un point-virgule
	 * @param mails
	 * @return
	 */
	static public boolean plusieursMails(String mails) {
		return ((mails.indexOf(' ') + mails.indexOf(',') + mails.indexOf(';')) > -1);
	}
	/**
	 * Découpe la chaîne contenant plusieurs mails en String[]
	 * @return
	 */
	static public String[] decoupe(String mails) {
		return mails.split(" |,|;");
	}
	
	//############################################################
	//Sujet et message
	//############################################################

	/**
	 * Ajoute le sujet
	 * @param sujet
	 * @throws Exception
	 */
	public void setSujet(String sujet) throws Exception {
		mm.setSubject(sujet);
	}
	
	/**
	 * Choisir entre le type texte brut ({@link Mail#TEXT}) ou HTML ({@link Mail#HTML}).
	 * @param mime
	 * @throws Exception
	 */
	public void setMimeType(int mime) throws Exception {
		mimetype = mime;
	}
	
	/**
	 * Ajoute le message
	 * @param message
	 * @throws Exception
	 */
	public void setMessage(String message) throws Exception {
		if (mimetype == HTML)
			mm.setContent(message, "text/html");
		else mm.setText(message);
	}
	
	//############################################################
	//Envoi
	//############################################################
	
	/**
	 * Envoie le mail
	 * @throws Exception
	 */
	public void send() throws Exception {
		if (noreply)
			setFrom(NOREPLY);
		Transport.send(mm);
	}
	
	//############################################################
	//Vérifications de la validité d'adresse e-mails
	//(fonctions pour l'extérieur : jsp ou WebServices...)
	//############################################################
	/**
	 * Vérifie si l'adresse passée en paramètre est valide. Si elle ne contient pas
	 * de @, vérifie si elle correspond bien à un pseudo (voir nameToMail).
	 * @param mail
	 */
	static public void isValide(String mail) throws Exception {
		if (plusieursMails(mail))
			areValide(decoupe(mail));
		else
			Mail.checkMail(mail);
	}
	/**
	 * Vérifie si les adresses passées en paramètres sont valides. Si elles ne contient pas
	 * de @, vérifie si elles correspondent à des pseudos (voir nameToMail).
	 * <p>Vérifie chacune des adresse, et renvoie une exception global, contenant plusieurs
	 * messages d'erreur si plusieurs adresses sont fausses, chaque message étant séparé
	 * par un \n.
	 * @param mails
	 * @throws Exception
	 */
	static public void areValide(String[] mails) throws Exception {
		String msg = "";
		for (int i=0; i<mails.length; i++) {
			try { 
				isValide(mails[i]);
			} catch (Exception e) {
				msg += ((msg.length()>0)?"\n":"") + e.getMessage(); 
			}
		}
		if (msg.length() > 0) {
			throw new Exception(msg);
		}
	}
	
	//############################################################
	//Fonctions private,
	//statiques pour être appelés par les public isValide et areValide
	//############################################################

	/**
	 * Vérifie la validité d'une adresse e-mail, et renvoie sous forme d'InternetAdress
	 * ou une exception en cas d'erreur.
	 * @param mail
	 * @throws Exception
	 */
	static private InternetAddress checkMail(String mail) throws Exception {
		//Pas de @, c'est peut-être un pseudonyme ?...
		if (mail.indexOf('@') == -1) {
			return new InternetAddress(nameToMail(mail));
		}
		else {
			//le parse d'InternetAddress ne renvoie pas d'erreur sur adresse@mail
			//alors on fait un test simple pour savoir si y'a un point, après l'@
			//adresse@mail.fr est OK, adresse@mail renvoie une exception.
			if (mail.lastIndexOf('.') < mail.indexOf('@')) {
				throw new Exception("Adresse email \""+mail+"\" invalide");
			}
			else {
				return new InternetAddress(mail);
			}
		}
	}
	
	/**
	 * Ici votre fonction perso, qui transforme des noms génériques en adresses e-mail.
	 * <p>Par exemple : webmaster -> webmaster@societe.fr
	 * @param name
	 * @throws Exception si le pseudo est inconnu.
	 */
	static private String nameToMail(String name) throws Exception {
		//L'exemple du mail au webmaster, si on met juste "webmaster" sans mettre
		//@societe.fr, cette fonction transforme.
		if (name.equalsIgnoreCase("webmaster"))
			return "webmaster@societe.fr";
		//else if....
		//else if....
		//else c'est une erreur
		else
			throw new Exception("Nom \""+name+"\" inconnu");
	}
}

29 novembre 2005 01:52:31 :

- "mail" dans les mots clés