Le rôle d'Entity Framework
Qui fait quoi entre vos classes C# et la base de données.
Après cette fiche, vous saurez :
- expliquer pourquoi C# et une base de données ne se parlent pas directement
- dire à quoi sert Entity Framework Core
- dire à quoi sert Npgsql
- expliquer ce que veut dire « Code-First »
1Le problème : deux langages
Un programme C# manipule des objets : un film, une salle, un ticket. On les décrit avec des classes.
Une base de données PostgreSQL, elle, ne connaît pas les classes. Elle range tout dans des tables, et on lui parle en SQL.
Voici le même film, dans les deux langages.
public class Film { public int IdFilm { get; set; } public string Titre { get; set; } public int Annee { get; set; } }
CREATE TABLE "Films" ( "IdFilm" integer PRIMARY KEY, "Titre" varchar(60) NOT NULL, "Annee" integer NOT NULL );
Le deuxième bloc est une version simplifiée : Entity Framework l'écrit un peu plus long, mais l'idée est exactement celle-là.
Sans aide, il faudrait écrire les deux à la main, et les garder identiques à chaque modification. C'est long, et on se trompe vite.
2La solution : un traducteur
Entity Framework Core (on dit souvent EF Core) est un traducteur. Il lit vos classes C# et écrit lui-même le SQL à votre place.
Ce genre d'outil porte un nom : un ORM, pour Object-Relational Mapper. C'est un mot compliqué pour une idée simple : faire correspondre les objets d'un côté et les tables de l'autre.
À retenir
Pensez à un interprète dans une réunion. Vous parlez français, votre interlocuteur parle néerlandais, et l'interprète traduit dans les deux sens.
Ici, vous parlez C#, la base parle SQL, et Entity Framework Core traduit.
Mais EF Core est un interprète général : il sait travailler avec plusieurs sortes de bases (PostgreSQL, SQL Server, SQLite...), et chacune a ses petites particularités. Il lui faut donc un adaptateur pour chacune.
Pour PostgreSQL, cet adaptateur s'appelle Npgsql (on prononce « N-P-G-SQL »). C'est lui qui connaît le dialecte de PostgreSQL et qui envoie le SQL jusqu'à la base.
Attention
Ne confondez pas les deux.
- Entity Framework Core décide quoi écrire : quelle table, quelles colonnes.
- Npgsql s'occupe du transport vers PostgreSQL, dans sa langue à lui.
Pour travailler avec PostgreSQL, il faut les deux.
3Le schéma à retenir
Voici la chaîne complète. Regardez-la bien : tout le cours tourne autour d'elle.
De gauche à droite :
- Vos classes C# : c'est la seule chose que vous écrivez.
- Entity Framework Core les lit et fabrique les ordres SQL.
- Npgsql envoie ces ordres à PostgreSQL.
- PostgreSQL crée les tables et range les données.
4Code-First : le code d'abord
Dans ce cours, on commence toujours par écrire les classes. La base de données en découle. Cette méthode s'appelle Code-First (« le code d'abord »).
L'autre méthode existe aussi : partir d'une base déjà faite et en tirer les classes. On ne la verra pas ici.
À retenir
Code-First : on écrit les classes C#, et Entity Framework fabrique la base.
Une classe devient une table. Une propriété devient une colonne.
5Notre fil rouge : le cinéma
Tout au long du cours, nous construisons la base d'un cinéma. Chaque classe C# deviendra une table.
| Classe C# | Table PostgreSQL | Elle contiendra |
|---|---|---|
Film | Films | les films à l'affiche |
Genre | Genres | action, comédie, drame... |
Salle | Salles | les salles et leur capacité |
Seance | Seances | un film, à une date et une heure |
Ticket | Tickets | les places vendues |
Remarquez que la classe est au singulier et la table au pluriel : une classe décrit un film, une table en contient beaucoup. La raison de ce pluriel se trouve dans la fiche 6.
Un aperçu du résultat
À la fin du cours, voici le programme qui crée la base. Vous ne comprenez pas encore chaque ligne : c'est normal, nous les verrons une par une.
var options = new DbContextOptionsBuilder<AppDbContext>() .UseNpgsql("Host=localhost;Database=db_cinema;Username=postgres;Password=VotreMotDePasse") .Options; using var db = new AppDbContext(options); db.Database.EnsureCreated();
Une fois ce programme lancé, la base db_cinema existe dans PostgreSQL,
avec ses tables. Aucune ligne de SQL n'a été écrite.
→Exercices
Recopiez la chaîne ci-dessous sur une feuille et complétez les trois cases vides.
Vos classes C# → [ ? ] → [ ? ] → [ ? ]
Puis associez chaque rôle à son outil :
- Il traduit les classes en SQL.
- Il range les données dans des tables.
- Il envoie le SQL à PostgreSQL, dans son dialecte.
Solution
Vos classes C# → Entity Framework Core → Npgsql → PostgreSQL
- Entity Framework Core.
- PostgreSQL.
- Npgsql.
Voici une classe :
public class Salle { public int IdSalle { get; set; } public int NumeroSalle { get; set; } public int Capacite { get; set; } }
- Comment s'appellera la table ? Combien aura-t-elle de colonnes ?
- On ajoute la propriété
public bool Est3d { get; set; }. Combien de colonnes aura la table ?
Solution
- La table s'appelle
Salles(au pluriel) et elle a 3 colonnes :IdSalle,NumeroSalleetCapacite. Une propriété donne une colonne. - 4 colonnes. Une propriété de plus, une colonne de plus.
Choisissez un sujet qui vous plaît (un club de sport, une bibliothèque, un garage, une collection...).
- Trouvez trois classes et donnez-leur un nom au singulier.
- Pour chaque classe, listez trois propriétés.
- Dessinez votre propre version du schéma : vos classes, puis les trois outils, puis la base.
Solution
Il n'y a pas une seule bonne réponse. Voici un exemple pour un club de sport :
Membre:Nom,Prenom,DateInscriptionCours:Intitule,Jour,DureeMinutesSalle:Numero,Capacite,Etage
Vérifiez que vos noms de classes sont au singulier, et que votre schéma montre bien les quatre éléments dans l'ordre : classes, Entity Framework Core, Npgsql, PostgreSQL.
Je sais faire
- Je sais dire pourquoi il faut un traducteur entre C# et PostgreSQL.
- Je connais le rôle d'Entity Framework Core.
- Je connais le rôle de Npgsql.
- Je sais redessiner la chaîne : classes C#, Entity Framework Core, Npgsql, PostgreSQL.
Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.