fr.iutfbleau.projetIHM2022FI2.MP

Class AbstractGroupeFactoryNP

java.lang.Object

fr.iutfbleau.projetIHM2022FI2.MP.AbstractGroupeFactoryNP

All Implemented Interfaces:

AbstractGroupeFactory

public class AbstractGroupeFactoryNP
extends java.lang.Object
implements AbstractGroupeFactory

Usine abstraite gérant l'ensemble des groupes.

Constructor Summary

Constructors

Constructor and Description
AbstractGroupeFactoryNP(javax.swing.JFrame fenetre) Le constructeur fabrique le groupe promotion déja plein (utilisé en Modèle persistant de donné).
AbstractGroupeFactoryNP(java.lang.String name, int min, int max, javax.swing.JFrame fenetre) Le constructeur fabrique le groupe promotion vide.

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) pemet de changer le nom d'un groupe dans la base de données
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 plutôt optimiste.
Groupe	refreshALL(Groupe g) refresh le Groupe ainsi que ses etudiants

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractGroupeFactoryNP

public AbstractGroupeFactoryNP(javax.swing.JFrame fenetre)

Le constructeur fabrique le groupe promotion déja plein (utilisé en Modèle persistant de donné).

Parameters:

fenetre - fenetre principale

AbstractGroupeFactoryNP

public AbstractGroupeFactoryNP(java.lang.String name,
                               int min,
                               int max,
                               javax.swing.JFrame fenetre)

Le constructeur fabrique le groupe promotion vide. Il faut ensuite y ajouter les étudiants.

Parameters:

fenetre - fenetre principale

name - nom de la promotion

min - le nombre minimum d'étudiants dans la promotion

max - le nombre maximum d'étudiants dans la promotion

Method Detail

knows

public java.lang.Boolean knows(Groupe g)

Test plutôt optimiste. Si la clé est identique alors on fait comme si c'était le bon groupe.

Specified by:

knows in interface AbstractGroupeFactory

Parameters:

g - le groupe à tester

Returns:

true si le groupe est connu

changeNameGroupe

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

pemet de changer le nom d'un groupe dans la base de données

Specified by:

changeNameGroupe in interface AbstractGroupeFactory

Parameters:

g - le groupe dont on veut changer le nom

name - le nouveau nom

Returns:

true si le changement a été effectué, false s'il y a eu une erreur

getPromotion

public Groupe getPromotion()

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

Specified by:

getPromotion in interface AbstractGroupeFactory

Returns:

la promo.

deleteGroupe

public 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.

Specified by:

deleteGroupe in interface AbstractGroupeFactory

Parameters:

g - le groupe à supprimer

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

public 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é.

Specified by:

createGroupe in interface AbstractGroupeFactory

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

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

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

Specified by:

createPartition in interface AbstractGroupeFactory

Parameters:

pere - le groupe père du groupe à partitionner

name - le nom des groupe à créer (on ajoute à la suite un numéro de 1 à n pour distinguer chaque groupe formant la partition)

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

public void addToGroupe(Groupe g,
                        Etudiant e)

permet d'ajouter un étudiant à un groupe.

Specified by:

addToGroupe in interface AbstractGroupeFactory

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

public void dropFromGroupe(Groupe g,
                           Etudiant e)

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

Specified by:

dropFromGroupe in interface AbstractGroupeFactory

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

public 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.

Specified by:

getEtudiants in interface AbstractGroupeFactory

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

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

permet de retrouver les groupes d'un étudiant.

Specified by:

getGroupesOfEtudiant in interface AbstractGroupeFactory

Parameters:

Etu - un étudiant

Returns:

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

Throws:

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

refreshALL

public Groupe refreshALL(Groupe g)

refresh le Groupe ainsi que ses etudiants

Specified by:

refreshALL in interface AbstractGroupeFactory

Parameters:

g - le groupe

Returns:

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