Entity Framework est pour rappel un ORM (Object RelationShip Manager) qui permet de faire :

  • Le mapping entre la base de données et les classes Entités
  • De proposer les méthodes du CRUD (Create Read Update Delete)

Il existe 3 workflows :

  • dataBase First
  • Model First
  • Code First

Lors de la création d’un projet MVC 4 dans Visual Studio 2012 , EF 5 est intégré par défaut
Cet article a pour but d’expliquer comme implémenter Entity Framework en utilisant le workflow Code First (et générer la base de données)

  1. Code First

    Le workflow Code First consiste à écrire comme son nom l’indique en 1er les classes entités (qui représentent le Model) puis:

  • soit de faire le mapping avec une base de données déjà existante
  • soit à partir de ces dernières de générer la base de données.
    1. Les classes Entités (Model)

      Dans notre exemple nous travaillons sur une application simple de gestion de Music (Music Store)
      Nous notre projets MVC dans le répertoire Models nous allons créer 2 classes qui représentent nos entités comme suit :

      Album.cs

      Genres.cs

    2. La classe de mapping (DbContext)

      Dans Models on crée une classe MvcMusicStoreEntities.cs qui hérite de DbContext, ça représente notre DBcontext



      Dans notre exemple on a fait le mapping :

      Table Albums –> classe Album

      Table Genres –> classe Genre

  1. La chaine de connexion

    Dans le fichier web.config, mettre la bonne chaine de connexion
    Dans <connectionSring>

    Exemple:

    <add name= »MvcMusicStoreEntities » connectionString= »Data Source=.\sqlexpress;Initial Catalog=MusicStore;Integrated Security=True » providerName= »System.Data.SqlClient » />
    Comme on peut le remarquer le nom de la chaine de connexion « MvcMusicStoreEntities » correspond au nom du DBContext

    Arrivé à ce point, si la base MusicStore existe déjà, EF est implémenté, et on peut commencer à l’utiliser.

    Par contre si notre but est de générer la base à partir du model, c’est allons utiliser EF Migration comme suit.

  2. Activer la migration

    La toute 1ere fois, il faut activer la migration sur le projet.

    Pour ceci dans la console Package Manager, lancer la commande

    enable-migrations en lui précisant le nom du context avec -ContextTypeName en argument

    enable-migrations -ContextTypeName MvcMusicStoreEntities


    Cette commande a créé un fichier configuration.cs ainsi qu’un répertoire Migration

     

    Ce fichier va contenir la configuration des migrations.
    Remarque : si la base de données existait déjà, un fichier InitialCreate est créé en même temps que la configuration. Sinon il faudra le crée avec 1ere migration

  3. Créer une migration

    Le terme de migration désigne le fait de mettre à jour la base de donnée en fonction d’un Model (entités)
    Pour créer une migration on lance dans le package manager la commande : add-migration « Nomdela migration »
    Exemple dans notre projet on lance add-migration InitialCreate



    Cette commande a créer un fichier dans le répertoire Migration, ce fichier est nommé avec le nom de la migration qui a été utilisé avec add-migration


    Il contient le code qui va permettre de générer les éléments du model

  4. Mettre à jour la base de données

    Pour appliquer les mises à jour en attentes il faut exécuter la commande update-database




    On peut donc voir que les 2 tables ont été crééent.

    La table _MigrationHistory historise les migrations, afin que lors des prochaines migrations ce ne sont que les changements sur la bases qui sont appliqués.
    Exemple : dans Album on rajoute la propriété NbTracks


    On lance la commande add-migration AddNbTracks





    Puis on met à jour la base de données avec update-database


    Remarque sur la commande update-database:

    Cette commande possède 2 arguments facultatifs:

    -verbose : permet de voir les détails de ce qui est appliqué sur la base de données

    -script : permet de générer un fichier sql avec le script qui permet d’appliquer les changements, dans ce cas les changements ne sont pas appliqué automatiquement sur la base.

    Dans un 2eme post nous verrons comment migrer les données avec la migration et comment rendre la migration automatique.