asp core crud example

asp-core-crud-exemple

Un exemple de projet .NET Core avec une base de données MongoDB avec un jeu de réplicas et des transactions activées.

But

Le but de ce projet est de donner une solution au sujet ci-dessous (utilisé pour un entretien d'embauche) :

 Please create a sample .net/C# project that includes the following elements:
- Basic CRUD functionality for a data structure of your choice.
- RESTful APIs to expose that functionality with your framework of choice (ASP.NET Web APIs, ASP.NET Core, ServiceStack (preferred), …etc).
- Uses MongoDB using C# driver.
- Please demonstrate your usage of one of MongoDB advanced features (aggregation, transactions, indexes, …etc) using C# driver.
- Please push your code to a Git repository that you can share with us.

Architecture du projet

Il s'agit d'un projet d'API Web asp core 3.1 avec une architecture à n niveaux :

• couche de modèle
• couche de logique métier
• couche d'accès aux données
• couche de présentation (ici, une API REST)

Chaque couche possède sa propre couche d'abstraction afin d'éviter les dépendances. J'utilise le moteur IOC et DI de base .net.

Essais

Je n'ai fait aucun test unitaire car il n'y a pas de logique métier. Cependant, j'ai réalisé un exemple de test d'intégration à l'aide de la bibliothèque Microsoft WebHost . Vous pouvez exécuter les tests d'intégration via Visual Studio ou la ligne de commande, mais n'oubliez pas d'exécuter d'abord docker-compose (sinon vous n'aurez aucune base de données à demander).

Base de données

L'implémentation du DAL utilise le pilote MongoDB C#. En exécutant le docker-compose attaché à la solution, vous obtiendrez une instance d'un serveur Mongo avec un jeu de réplicas activé (afin de prendre en charge les transactions).

Transactions et (type) d'unité de travail

Pour démontrer l'utilisation de l'une des fonctionnalités avancées de MongoDB, j'ai choisi les transactions. Ainsi, le IClientSessionHandle est injecté dans tous les référentiels. J'ai également réussi à créer un middleware appelé TransactionFilter qui crée une transaction pour l'ensemble de la requête HTTP. De cette façon, nous pouvons effectuer des opérations multi-documents, sur différents référentiels, qui peuvent être annulées en cas de problème, sans traiter manuellement les transactions multi-documents.

Exemple :

• La requête HTTP arrive
• Ouverture de la transaction
• Insérer dans la collection XXX
• Mise à jour dans la collection YYY avec l'identifiant extrait de XXX créé précédemment
• La mise à jour échoue
• La transaction sera abandonnée et annulera l'insertion de XXX

Cela fonctionne tel quel, mais cela nécessiterait des tests de charge supplémentaires. Ce n’est peut-être pas prêt pour la production.

Comment courir ?

• Ouvrez la solution dans Visual Studio
• Ciblez le projet docker-compose dans le dossier 00 - Solution Items
• Courir avec F5
• Attendez quelques secondes (temps de configuration du jeu de réplicas)
• Accédez à l'interface utilisateur de swagger pour faire quelques requêtes : https://localhost:5000/swagger
• Regardez la base de données dans l'interface Mongo Express si nécessaire : http://localhost:8081

Bugs connus :

L'utilisation de docker-compose up en ligne de commande ne semble pas fonctionner avec l'API pour le moment. Il ne me restait plus beaucoup de temps, alors j'ai continué à utiliser VS pour composer.