Possibilité d'ajouter des destinataires, copie et copie cachée, de vérifier si une adresse est valide.
On peut appeler les fonctions avec un tableau de String en paramètre, ou avec une String toute seule.
Une string peut contenir plusieurs adresses mails séparées par un espace, une virgule ou un point virgule.
Notes :
- - une fonction spéciale à la fin permet de transformer un pseudo en mail.
- - un tout petit peu de config au début, le serveur smtp et l'adresse no-reply
Exemple :
Mail m = new Mail();
m.setTo("webmaster, mail@exemple.com;no.spam@thank.you");
m.setSujet("test");
m.setMessage("Ceci est un test");
m.send();
/*
* 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() {
mimetype = TEXT;
props = System.getProperties();
props.put("mail.smtp.host", SMTPHOST);
session = Session.getDefaultInstance(props, null);
mm = new MimeMessage(session);
}
/**
* 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]);
}
/**
* 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(" |,|;");
}
/**
* 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);
}
/**
* Envoie le mail
* @throws Exception
*/
public void send() throws Exception {
if (noreply)
setFrom(NOREPLY);
Transport.send(mm);
}
/**
* 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);
}
}
/**
* 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 {
if (mail.indexOf('@') == -1) {
return new InternetAddress(nameToMail(mail));
}
else {
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 {
if (name.equalsIgnoreCase("webmaster"))
return "webmaster@societe.fr";
else
throw new Exception("Nom \""+name+"\" inconnu");
}
}
|