⌂ Entity Framework
Fiche 1 sur 8

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 :

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.

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.

Vos classes C# class Film IdFilm Titre Annee Entity Framework Core Le traducteur Lit vos classes Écrit le SQL Npgsql Le pilote Parle « PostgreSQL » Envoie le SQL PostgreSQL La base Table « Films » Vos données Vous écrivez du C# Traduit le C# en langage SQL Transporte le SQL jusqu'à la base Crée les tables et range les données Vous ne parlez que C# : le SQL, c'est le travail des deux du milieu.

De gauche à droite :

  1. Vos classes C# : c'est la seule chose que vous écrivez.
  2. Entity Framework Core les lit et fabrique les ordres SQL.
  3. Npgsql envoie ces ordres à PostgreSQL.
  4. 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 PostgreSQLElle contiendra
FilmFilmsles films à l'affiche
GenreGenresaction, comédie, drame...
SalleSallesles salles et leur capacité
SeanceSeancesun film, à une date et une heure
TicketTicketsles 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

1Compléter la chaîneRecopier

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 :

  1. Il traduit les classes en SQL.
  2. Il range les données dans des tables.
  3. Il envoie le SQL à PostgreSQL, dans son dialecte.

Solution

Vos classes C# → Entity Framework Core → Npgsql → PostgreSQL

  1. Entity Framework Core.
  2. PostgreSQL.
  3. Npgsql.
2De la classe à la tableModifier

Voici une classe :

public class Salle
{
    public int IdSalle { get; set; }
    public int NumeroSalle { get; set; }
    public int Capacite { get; set; }
}
  1. Comment s'appellera la table ? Combien aura-t-elle de colonnes ?
  2. On ajoute la propriété public bool Est3d { get; set; }. Combien de colonnes aura la table ?

Solution

  1. La table s'appelle Salles (au pluriel) et elle a 3 colonnes : IdSalle, NumeroSalle et Capacite. Une propriété donne une colonne.
  2. 4 colonnes. Une propriété de plus, une colonne de plus.
3Imaginer sa propre baseCréer

Choisissez un sujet qui vous plaît (un club de sport, une bibliothèque, un garage, une collection...).

  1. Trouvez trois classes et donnez-leur un nom au singulier.
  2. Pour chaque classe, listez trois propriétés.
  3. 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, DateInscription
  • Cours : Intitule, Jour, DureeMinutes
  • Salle : 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

Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.

Fiche 2 : Préparer le projet →