Groupe 2 (communication)
Date de création :	23 septembre 2004
Dernière modification :
Diffusion :	internet

Canal Mailto

Description des classes Mail et MailAttribute

Les attributs d'un mail

un "Mail" est constitué de plusieurs "MailAttribute".

Détail d'un MailAttribute

Il connait le nom du champs du formulaire qui contient la valeur saisie par l'utilisateur. Mais cet attribut n'est util que dans le déroulement du canal servant, le canal maître ne doit pas s'en servir.

Un attribut peut être visible, ou pas, pour l'utilisateur. Ceci est util pour forcer une valeur à l'insue de l'utilisateur, ou pour empêcher la saisie.

Un attribut peut être modifiable, ou pas, par l'utilisateur. Ceci est util pour empêcher la saisie.

Un attribut, s'il est mal saisi, passe en erreur. Le canal servant teste l'état d'un attribut pour faire remonter l'information au niveau du formulaire utilisateur.

Bien évidemment, un attribut a une valeur.

Les attributs d'un Mail

Dès sa création, un Mail contient ces attributs :

un expéditeur *: Mail.FROM
un destinataire *: Mail.TO
un destinataire en copie visible : Mail.CC
un destinataire en copie cachée : Mail.BCC
un sujet *: Mail.SUBJECT
un message *: Mail.CONTENT

Les champs marqués d'une * sont obligatoire pour envoyer le mail.

Récupération d'un attribut d'un mail

Cela peut se fait directement sur le mail.
ex : pour retrourner le MailAttribute "from"

mail.getFrom();

Il est également possible de parcourir tous les attributs avec la méthode suivante

Iterator i = message.getAttributes().keySet().iterator();
	     
/*Récuperation des valeurs d'un mail*/
while (i.hasNext()){
		String attName = (String)i.next();
		MailAttribute attTemp = message.getAttribute(attName);
		/*traitement sur attTemp*/
}

Modifier un attribut

Soit vous ne voulez modifier que la valeur d'un attribut, il suffit alors d'utiliser le setter approporié.
ex : pour modifier le destinataire :

message.setTo("sgaudin@univ-nancy2.fr");

Création : 23 septembre 2004 - Sébastien GAUDIN (N2)
Modifications :