Interface IAnnuaire


public interface IAnnuaire

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, IListeNumTel 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.
 IListeNumTel 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

boolean ajouterEntree(Personne p,
                      IListeNumTel 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

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

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

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

IListeNumTel numeros(Personne p)
retourne la liste des numéros d'une personne si la personne est absente retourne null

Parameters:
o - la personne pour laquelle on consulte les numeros.
Returns:
la liste des numéros de la personne si celle-ci est présente dans l'annuaire, null sinon.

personnes

java.util.Iterator personnes()
renvoie un iterateur sur l'ensemble des personnes contenues dans l'annuaire

Returns:
l'iterateur

afficher

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

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

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.