====== Les relations entre entités ======


Maintenant que les entités sont créées, il nous faut créer les relations.
Lorsque les relations seront créées, Doctrine se charge de réaliser le mapping en base de données en créant les champs  supplémentaires étant clés étrangères, les nouvelles tables si nécessaire.

Il existe principalement 3 types de relations entre entités :
  * la relation many-to-one/one-to-many
  * la relation many-to-many
  * l'héritage


===== La relation Many-To-One =====
Dans le contexte webstudent, il s'agit par exemple de la relation entre l'entité Etudiant et l'entité Maison.

{{:sfnmanytoone.png?300|}}

Un étudiant appartient à une et une seule maison (Many-To-One).
Cela signifie qu'une propriété supplémentaire de type Maison doit être ajoutée à l'entité Etudiant (avec son getter et son setter).
En base de données, la clé étrangère id_maison sera ajoutée dans la table Etudiant et fera référence au champ id de la table Maison.

Une maison comprend plusieurs étudiants (One-To-Many). Cette relation n'est pas toujours nécessairement à implémenter. Il faut se poser la question, si au niveau applicatif, nous aurons besoin, partant d'une maison, de récupérer, lister, consulter des étudiants.
Dans notre cas, oui, donc nous implémenterons aussi cette relation.
Dans l'entité Maison, une propriété supplémentaire, liste d'étudiants devra être ajoutée.
En base de donnée, cette relation "inverse" ne change rien, le lien étant assuré par la clé étrangère créée lors de la relation Many-To-One.

La relation Many-To-One doit donc être implémentée dans tous les cas mais pas forcément la relation inverse One-to-Many.

Pour assurer le mapping avec la base de données, des annotations seront donc ajoutées au dessus de chaque propriété assurant la relation.
==== Création des relations avec la console : ====

La version 4 de Symfony permet maintenant de créer ces annotations  grâce à la console.
Il s'agit de la même commande que le création d'une entité.
<code>
>php bin/console make:entity
</code>

Liste des informations à fournir :
  * Class name of the entity to create or update : Etudiant
  * New property name : maison     <wrap lo>(avec un m minuscule, pour respecter CamelCase, puisqu'il s'agit d'une propriété !)</wrap>
  * Field type : relation
  * What class should this entity be related to? : Maison <wrap lo>(avec un M majuscule puisqu'il s'agit du nom de l'entité)</wrap>

  * What type of relationship is this?: ManyToOne
  * Is the Etudiant.maison property allowed to be null (nullable)?: yes
  * Do you want to add a new property to Maison so that you can access/update Etudiant objects from it - e.g. $maison->getEtudiants()? yes  <wrap lo>(Cette dernière instruction permet de créer la relation inverse OneToMany dans l'entité Maison.)</wrap>
  *  New field name inside Maison : etudiants  <wrap lo>(avec un e minuscule  car c'est une propriété et un s car c'est c'est une liste)</wrap>

__Résultat :__
  * Liste à puceDans l'entité Etudiant, on retrouve la propriété supplémentaire maison annotée de la relation ManyToOne :
<code php>
/**
     * @ORM\ManyToOne(targetEntity="App\Entity\Maison", inversedBy="etudiants")
     */
    private $maison;
</code>.
Le getter et le setter de cette propriété ont été également implémentés :
<code php>
public function getMaison(): ?Maison
    {
        return $this->maison;
    }

    public function setMaison(?Maison $maison): self
    {
        $this->maison = $maison;

        return $this;
    }
</code>

  * Dans l'entité Maison, une propriété supplémetaire a été ajoutée :

<code php>
 /**
     * @ORM\OneToMany(targetEntity="App\Entity\Etudiant", mappedBy="maison")
     */
    private $etudiants;
  
 </code>
    
Avec les getters et les setters et les méthodes d'ajout/suppression de liste
<code php>
 /**
     * @return Collection|Etudiant[]
     */
    public function getEtudiants(): Collection
    {
        return $this->etudiants;
    }

    public function addEtudiant(Etudiant $etudiant): self
    {
        if (!$this->etudiants->contains($etudiant)) {
            $this->etudiants[] = $etudiant;
            $etudiant->setMaison($this);
        }

        return $this;
    }

    public function removeEtudiant(Etudiant $etudiant): self
    {
        if ($this->etudiants->contains($etudiant)) {
            $this->etudiants->removeElement($etudiant);
            // set the owning side to null (unless already changed)
            if ($etudiant->getMaison() === $this) {
                $etudiant->setMaison(null);
            }
        }

        return $this;
    }
</code>

==== Réaliser le mapping avec le base de données : ====
Exécuter les instructions de mise à jour de la base de données
<code>php bin/console make:migration</code>
<code>php bin/console doctrine:migrations:migrate</code>

Un nouveau champ nommé maison_id a été créé. Il s'agit en plus d'une clé étrangère faisant référence au champ id de la table Maison.

==== Tests de la relation ManyToOne : ====

Pour tester la relation ManyToOne, nous allons récupérer une maison et l'ajouter à un étudiant.
Nous allons créer la nouvelle route permettant de modifier un étudiant :
Dans le fichier routes.yaml :
<code php>
etudiantModifier:
    path: /etudiant/modifier/{id}
    controller: App\Controller\EtudiantController::modifierEtudiant
</code>

Dans le fichier EtudiantController, nous ajoutons la nouvelle méthode :
<code php>
public function modifierEtudiant(ManagerRegistry $doctrine, $id){
		
		//récupération de l'étudiant dont l'id est passé en paramètre
		$etudiant= $doctrine->getRepository(Etudiant::class)->find($id);

		if (!$etudiant) {
			throw $this->createNotFoundException(
            'Aucun etudiant trouvé avec le numéro '.$id
			);
		}
		else
		{


		// récupération de la maison des griffondor à partir du code de la maison
                $maison= $doctrine->getRepository(Maison::class)->findOneBy(['code' => 'SPT']);
	

		if (!$maison) {
			throw $this->createNotFoundException(
            'Aucune maison trouvé avec ce nom'
			);
		}
		else
		{

		//Affectation de la maison à l'étudiant
		$etudiant->setMaison($maison);

		// persistence de l'objet modifié
                $entityManager = $doctrine->getManager();
		$entityManager->persist($etudiant);
		$entityManager->flush();



		//return new Response('Etudiant : '.$etudiant->getNom());
		return $this->render('etudiant/consulter.html.twig', [
            'etudiant' => $etudiant,]);
        }
        }
	}
</code>

http://localhost/webstudent/public/etudiant/modifier/4

==== Tests de la relation OneToMany: ====

Pour tester la relation OneToMany, nous allons récupérer une maison à partir du code qui sera passé en paramètre de l'url et lister tous les étudiants de cette maison.

Ajout de la route :
<code php>
maisonConsulter:
    path: /maison/consulter/{code}
    controller: App\Controller\MaisonController::consulterMaison
</code>


Ajout du contrôleur et de la méthode consulterMaison :
<code php>
class MaisonController extends AbstractController
{
    /*
     * @Route("/maison", name="maison")
     */
	
	public function consulterMaison(ManagerRegistry $doctrine, $code){
		$repository = $doctrine->getRepository(Maison::class);
		$maison= $doctrine->getRepository(Maison::class)->findOneBy(['code' => 'SPT']);
		
		return $this->render('maison/consulter.html.twig', ['pMaison' => $maison,]);			
	}	
}
</code>

Création de la vue dans un nouveau dossier maison
<code php>
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>Maison-consulter</title>    
    </head>
    <body>
     		
		<h5>BIENVENUE DANS LA MAISON DES {{ pMaison.nom | upper}}</h5>
 <p>
  <table >
	<tr><td>id</td><td>Nom</td><td>Prénom</td><td>datenaissance</td><td>ville</td></tr>
	{% for e in pMaison.etudiants %}
	<tr>
			<td><a href="{{ path('etudiantConsulter', { 'id': e.id }) }}">{{ e.id }}</a></td>
			<td><a href="{{ path('etudiantConsulter', { 'id': e.id }) }}">{{ e.nom }}</a></td>
			<td><a href="{{ path('etudiantConsulter', { 'id': e.id }) }}">{{ e.prenom }}</a></td>
			<td>{{ e.dateNaiss|date('d/m/Y') }}</td>
			<td>{{ e.ville}}</td>
			</tr>
	   {% endfor %}
	  
 </table	 
    </body>
</html>
</code>

http://localhost/webstudent/public/maison/consulter/GFD

===== Relation Many-To-Many =====

Dans le contexte webstudent, il s'agit de la relation entre Competence et Professeur.
{{sfnmanytomany.png}}

==== Création de la relation avec la console : ====

Avec la commande permettant de générer les entités, nous pouvons créer la relation en renseignant les informations ci-dessous :
  * Class name of the entity to create or update : Competence
  * New property name : professeurs  <wrap lo>(avec un s car c'est une collection)</wrap>
  * Field type : relation
  * What class should this entity be related to?: Professeur
  * Relation type? : ManyToMany
  * Do you want to add a new property to Professeur so that you can access/update Competence objects from it - e.g. $professeur->getCompetences()? yes <wrap lo>(permet de créer la relation inverse, c'est-à-dire dans Professeur, créer une collection de professeurs.</wrap>

Dans l'entité Compétence, une propriété de type collection de professeurs a été ajoutée.
Dans l'entité Professeur, une propriété de type collection de compétences a été ajoutée.

==== mapping des relations en base de données : ====
Après avoir exécuté les commandes de mapping, une nouvelle table a été créée en base de données nommée ''competence_professeur''.
Cette table comporte deux champs composant la clé primaire : competence_id + professeur_id.
Chaque champ est aussi clé étrangère en référence respectivement à la table compétence et professeur.

===== Relation de type Classe-association =====

Dans le contexte webstudent, ce type de relation est représenté par les entités et relation entre Etudiant et Competence.

{{:sfnclasseassociation.png?150|}}

Il faut transformer les relations manyToMany en relations ManyToOne comme ci-dessous :
{{:sfnclassassoc2.png?400|}}

Il faut donc créer une nouvelle entité, Note avec les deux propriétés primitives dateNote et note puis créer les deux relations ManyToOne vers Etudiant et vers Competence.

Après exécution des commandes de mapping de base de données, la table Note contiendra id en clé primaire ainsi que deux clés étrangères etudiant_id et competences_id faisant référence respectivement à Etudiant et Competence.