Interface Annuaire

public interface Annuaire

Annuaire téléphonique permettant d'associer à une Personne une liste de numéros de téléphones.
Created: Tue Dec 04 21:25:14 2001

See Also:

NumTel, Personne, ListeNumTel

Method Summary

void	afficher() affiche l'intégralité de l'annuaire, sous la forme d'une personne par ligne suivie de ses numéros de téléphone.
boolean	ajouterEntree(Personne p, ListeNumTel nums) ajoute une nouvelle entrée dans l'annuaire.
void	ajouterNumeroDebut(Personne p, NumTel n) ajoute un numero au début de la liste des numéros d'une personne.
void	ajouterNumeroFin(Personne p, NumTel n) ajoute un numero à la fin de la liste des numéros d'une personne.
ListeNumTel	numeros(Personne p) retourne la liste des numéros d'une personne si la personne est absente retourne null
java.util.Iterator	personnes() renvoie un iterateur sur l'ensemble des personnes contenues dans l'annuaire
NumTel	premierNumero(Personne p) retourne le premier numéro d'une personne, si la personne n'est pas dans l'annuaire retourne null.
void	supprimer(Personne p) supprime une personne de l'annuaire.
void	supprimer(Personne p, int n) supprime un numero donné pour une personne.

Method Detail

ajouterEntree

public boolean ajouterEntree(Personne p,
                             ListeNumTel nums)

ajoute une nouvelle entrée dans l'annuaire. Si p n'existe pas: on crée une nouvelle association (p,nums) et le booleen true est retourné; sinon le booleen /false est retourné et la méthode est sans effet.

Parameters:

p - la personne

nums - sa liste de numeros

Returns:

truesi l'entrée a été ajoutée, false si la personne p était déjà présente dans l'annuaire

ajouterNumeroFin

public void ajouterNumeroFin(Personne p,
                             NumTel n)

ajoute un numero à la fin de la liste des numéros d'une personne. Si la personne n'existe pas on crée une nouvelle entrée pour cette personne avec comme liste de numéros associée la liste constituée du numéro passé en paramètre.

Parameters:

p - la personne

n - le numero à ajouter

ajouterNumeroDebut

public void ajouterNumeroDebut(Personne p,
                               NumTel n)

ajoute un numero au début de la liste des numéros d'une personne. Si la personne n'existe pas on crée une nouvelle entrée pour cette personne avec comme liste de numéros associée la liste constituée du numéro passé en paramètre.

Parameters:

p - la personne

n - le numero à ajouter

premierNumero

public NumTel premierNumero(Personne p)

retourne le premier numéro d'une personne, si la personne n'est pas dans l'annuaire retourne null.

Parameters:

p - la personne dont on recherche le numéro

Returns:

son numero, null si p n'est pas présente dans l'annuaire.

numeros

public ListeNumTel numeros(Personne p)

retourne la liste des numéros d'une personne si la personne est absente retourne null

Returns:

la liste des numéros de la personne si celle-ci est présente dans l'annuaire, null sinon.

personnes

public java.util.Iterator personnes()

renvoie un iterateur sur l'ensemble des personnes contenues dans l'annuaire

Returns:

l'iterateur

afficher

public void afficher()

affiche l'intégralité de l'annuaire, sous la forme d'une personne par ligne suivie de ses numéros de téléphone.

supprimer

public void supprimer(Personne p)

supprime une personne de l'annuaire. Sans effet si la persoone n'est pas présente dans l'annuaire.

Parameters:

p - la personne à retirer de l'annuaire.

supprimer

public void supprimer(Personne p,
                      int n)

supprime un numero donné pour une personne.
Si ce numéro est le seul numéro pour la personne, la personne est alors retirée de l'annuaire.
Sans effet si la personne n'est pas présente dans l'annuaire.

Parameters:

p - la personne pour laquelle un numéro doit être supprimé.

n - le numero a supprimer.