Principes de base de .NET : DTO (objet de transfert de données)

protected override void OnModel6590 OnModel6590 OnModel6590 OnModelCreating (ModelBuilder modelBuilder)
{
modelBuilder.Entity<Seller>().HasDatanew ]Vendeur(Guid.NouveauGuid(),"John Smith", DateHeure[35].[1945]. UtcNow, "John@mail.com","947 Heritage Road", 10),
nouveau[19659049]Vendeur(Guid.NouveauGuid(), "Violet Marshall",. UtcNow, "vmarshall@mail.com", "360 Bates Brothers Road", 10)
)[27]6590 ;
}
}

Dans la classe AppDbContext, nous créons une entité "Sellers" qui représente la table qui sera créée lors de l'exécution ultérieure des commandes Migrations.[19659003]Nous avons également la méthode "OnConfiguring" qui définit les paramètres de la base de données, comme le nom du fichier qui sera généré "app.db".

Enfin, nous avons la méthode "OnModelCreating" chargée d'insérer des exemples de données lorsque la base de données est générée.

Exécution des commandes Entity Framework

Maintenant que le mappage des données est prêt, nous pouvons exécuter les commandes qui créeront la base de données et ajouteront les données initiales qui ont été implémentées dans les étapes précédentes.

Tout d'abord, avant d'exécuter les commandes, vous devez cliquer avec le bouton droit sur le projet (solution), puis cliquer sur l'option "Reconstruire la solution" – cela évitera les erreurs lors de l'exécution des commandes.

Puis dans Visual Studio, cliquez sur Outils -> Nuget Package Manager -> Package Manager Console et exécutez les commandes ci-dessous :

dotnet ef migrations add InitialModel
mise à jour de la base de données dotnet ef

Ces commandes créeront la base de données à la racine du projet dans le fichier app.db et rempliront la table "seller" avec les données que nous avons préparées dans la méthode "OnModelCreating".

Utilisation de DTO pour renvoyer des données[19659019]Dans le fichier Program.cs, juste après la création de la variable "builder", ajoutez le code suivant pour créer la configuration DB Context :

builder.Services. AddDbContext<AppDbContext>();

Et après avoir créé la variable "app", ajoutez le code suivant :

app.MapGet("/v1/sellers", (Contexte AppDbContext) =>[196591965]{5165] ]var vendeurs = contexte.Vendeurs;

    var vendeursDtoList = nouveau nouveau nouveau nouveau  VendeurDà>[19659027]() ;

    si (les vendeurs est pas null)
    {15] (var vendeur dans vendeurs)
        {
            var vendeurDto = nouveau Vendeur vendeur.Nom, vendeur.E-mail) ;

            sellersDtoList.Ajouter(sellerDto);
        }
    }

    return sellersDtoList[1945049]count [19450490][19450490]> 0  ? Résultats.Ok(sellersDtoList)  :[965]Résultats : Introuvable() ;

}).Produit<Vendeur>[9459027][67][194590924] ]);

Dans cette méthode, nous créons un point de terminaison pour interroger la base de données. La variable "sellers" recevra la liste des enregistrements retournés, mais elle ne sera pas envoyée directement au client, car elle contient toutes les données du vendeur, comme le "DiscountFactor", qui dans ce contexte ne doit pas être exposé. Au lieu de cela, les éléments de cette liste seront transmis au DTO (sellerDto), qui renverra les données au client.

Exécution du projet

Si vous exécutez le projet et accédez à l'adresse : https : //localhost :/v1/sellersvous aurez la liste des vendeurs renvoyée par la base de données, comme dans l'image ci-dessous :

Conclusion

The l'utilisation des DTO est fortement recommandée car elle devient très avantageuse pour les applications, principalement si les données exposées sont sensibles. Au-delà de la possibilité de personnalisation des entités, on peut éviter l'utilisation excessive de requêtes aux API.

Donc, dans la mesure du possible. , essayez d'utiliser des DTO dans vos applications. En plus d'être une bonne pratique, cela peut éviter des problèmes futurs.

Dans cet article, nous avons examiné le concept de DTO et ses avantages. Nous avons créé une application qui possède une entité de domaine et qui n'expose que les données nécessaires via l'entité DTO.

Si vous souhaitez en savoir plus sur ce contenu, je vous propose un excellent article sur le site officiel de Microsoft : Pros et contre de DTO.