fr.iutfbleau.projetIHM2022FI2.API

Interface AbstractGroupeFactory

All Known Implementing Classes:

AbstractGroupeFactoryNP, AbstractGroupeFactoryNP

public interface AbstractGroupeFactory

Usine abstraite gérant l'ensemble des groupes.

Method Summary

Modifier and Type	Method and Description
void	addToGroupe(Groupe g, Etudiant e) permet d'ajouter un étudiant à un groupe.
boolean	changeNameGroupe(Groupe g, java.lang.String name) Ajout a l'API pour changer facilement de nom de groupe
void	createGroupe(Groupe pere, java.lang.String name, int min, int max) permet d'ajouter un groupe vide de type FREE comme sous-groupe d'un groupe donné.
void	createPartition(Groupe pere, java.lang.String name, int n) permet de créer une partition automatiquement sous un groupe donné.
void	deleteGroupe(Groupe g) permet de supprimer un groupe connu de l'usine abstraite qui ne contient pas de groupes.
void	dropFromGroupe(Groupe g, Etudiant e) permet d'enlever un étudiant d'un groupe.
java.util.Set<Etudiant>	getEtudiants(java.lang.String nomEtu) permet de retrouver un étudiant à partir d'un String.
java.util.Set<Groupe>	getGroupesOfEtudiant(Etudiant etu) permet de retrouver les groupes d'un étudiant.
Groupe	getPromotion() permet de récupérer le Groupe qui contient les étudiants de toute la promotion
java.lang.Boolean	knows(Groupe g) Test si le groupe g est connu de l'usine (connu maintenant).
Groupe	refreshALL(Groupe g) refresh le Groupe ainsi que ses etudiants

Method Detail

getPromotion

Groupe getPromotion()

permet de récupérer le Groupe qui contient les étudiants de toute la promotion

Returns:

la promo.

knows

java.lang.Boolean knows(Groupe g)

Test si le groupe g est connu de l'usine (connu maintenant). Si la réponse est true, les méthodes avec ce groupe en paramètre devraient bien fonctionner. Si la réponse est false, le comportement n'est pas garanti.

deleteGroupe

void deleteGroupe(Groupe g)

permet de supprimer un groupe connu de l'usine abstraite qui ne contient pas de groupes. Pour détruire un groupe connu qui en contient d'autres il faut le faire récursivement.

Throws:

java.lang.NullPointerException - si un argument est null

java.lang.IllegalStateException - si le groupe contient des groupes

java.lang.IllegalArgumentException - si le groupe n'est pas connu de l'usine abstraite ou bien si le groupe est celui de toute la promotion (renvoyé par getPromotion)

createGroupe

void createGroupe(Groupe pere,
                  java.lang.String name,
                  int min,
                  int max)

permet d'ajouter un groupe vide de type FREE comme sous-groupe d'un groupe donné.

Parameters:

pere - le groupe père du groupe à créer

name - le nom du groupe à créer

min,max - bornes indicatives sur la taille du groupe à créer

Throws:

java.lang.NullPointerException - si un argument est null

java.lang.IllegalArgumentException - si le groupe pere est de type PARTITION ou si il n'y a pas 0 < min <= max

createPartition

void createPartition(Groupe pere,
                     java.lang.String name,
                     int n)

permet de créer une partition automatiquement sous un groupe donné.

Parameters:

pere - le groupe père du groupe à partitionner

name - le nom des groupe à créer (on ajoutera à la suite un numéro ou une lettre pour distinguer chaque groupe)

n - le nombre de partitions

Throws:

java.lang.NullPointerException - si un argument est null

java.lang.IllegalArgumentException - si le groupe pere est de type PARTITION ou n négatif ou nul NB. doit créer une "copie" de pere sous pere de type Partition et ajouter sous ce groupe, n groupes de type "FREE". les valeurs min et max de ces n groupes sont min = 0 et max = partie entière de N/n plus 1, où N est le nombre max du groupe pere.

addToGroupe

void addToGroupe(Groupe g,
                 Etudiant e)

permet d'ajouter un étudiant à un groupe.

Parameters:

g - le groupe dans lequel il faut ajouter l'étudiant

e - l'étudiant à ajouter

Throws:

java.lang.NullPointerException - si un argument est null

java.lang.IllegalArgumentException - la factory ne connaît pas g

java.lang.IllegalStateException - le père de g ne contient pas e

dropFromGroupe

void dropFromGroupe(Groupe g,
                    Etudiant e)

permet d'enlever un étudiant d'un groupe.

Parameters:

g - le groupe dans lequel il faut enlever l'étudiant

e - l'étudiant à enlever

Throws:

java.lang.NullPointerException - si un argument est null

java.lang.IllegalStateException - g ne contient pas e

java.lang.IllegalArgumentException - la factory ne connaît pas g

getEtudiants

java.util.Set<Etudiant> getEtudiants(java.lang.String nomEtu)

permet de retrouver un étudiant à partir d'un String. NB. dans une version simple il doit s'agir du nom exact. dans une version un peu plus complexe, il s'agit des premières lettres du nom dans une version avancée, on peut autoriser une expression régulière plus ou moins complexe qui est générée si la première recherche n'a pas renvoyé de candidat.

Parameters:

String - nomEtu le nom approximmatif de l'étudiant

Returns:

Set l'ensemble des étudiants connus de la factory ayant un nom "proche" de ce string au sens de la remarque ci-dessus.

Throws:

java.lang.NullPointerException - si le String est null.

getGroupesOfEtudiant

java.util.Set<Groupe> getGroupesOfEtudiant(Etudiant etu)

permet de retrouver les groupes d'un étudiant.

Parameters:

Etu - un étudiant

Returns:

Etudiant l'étudiant connu de la factory ayant cet identifiant

Throws:

java.lang.NullPointerException - si le String est null.

changeNameGroupe

boolean changeNameGroupe(Groupe g,
                         java.lang.String name)

Ajout a l'API pour changer facilement de nom de groupe

Parameters:

g - le groupe

name - le nom

Returns:

true si possible

refreshALL

Groupe refreshALL(Groupe g)

refresh le Groupe ainsi que ses etudiants

Parameters:

g - le groupe

Returns:

le groupe refresh/un parent si il a été refresh