- Un client arrive à l'hôtel et demande une chambre.
- Le réceptionniste lui propose une liste des chambres disponibles.
- Le client, têtu, choisit une chambre au hasard, qu'elle soit libre ou non.
- Selon le choix du client et la disponibilité de la chambre, le réceptionniste va, ou non, lui réserver la chambre souhaitée.
- Les classes
ProgrametChambresont déjà écrites. - La classe
Hotelest déjà structurée, mais les méthodes sont vides (sauf son constructeur). Elles renvoient des erreurs de typeNotImplementedException. - La classe
Programva faire appel aux méthodes de la classeHotel. Le but de l'exercice est donc d'implémenter les méthodes de la classeHotel.
Lorsque vous clonez le contenu du dépôt Git, vous obtenez une solution Visual Studio appelée Exercice1.
La solution contient un dossier src qui contient le code complet du projet.
Dans le dossier src, vous trouverez un Projet Exercice. C'est dans ce projet que vous devrez écrire le code.
Dans le dossier src, vous trouverez aussi un Projet Solution. Ce projet contient un exemple de solution fonctionnelle pour cet exercice en cas de besoin.
À côté du dossier src, vous trouverez un dossier tests. Ce dossier contient les tests unitaires automatisés. Vous n'avez pas à vous soucier du code et du contenu de ce dossier.
Toutes les méthodes de la classe Hotel ont actuellement pour code :
throw new NotImplementedException();
Il faut supprimer cette ligne et implémenter chaque méthode selon leur description (<summary>).
Afin de vous aider à écrire votre code et vérifier votre travail, la classe Hotel est soumise à des Tests Unitaires (TU).
Un test unitaire est un code utilisé pour tester du code.
Chaque méthode la classe Hotel doit exécuter une action bien précise en fonction de ses paramètres et des différentes conditions.
Chaque condition possible est testée par les tests unitaires.
Vous pouvez donc savoir en temps réel si votre code remplit toutes les conditions nécessaires et renvoie les bonnes valeurs attendues grâce aux tests unitaires.
Visual Studio propose une interface graphique avec un bouton pour éxecuter les tests unitaires.
Pour accéder à l'interface graphique et éxecuter les tests, veuillez vous référer à l'article suivant sur le site de Microsoft : Exécuter des tests dans l’explorateur de tests.
Lorsque vous afficherez l'Explorateur de tests et que vous éxecuterez les tests pour la première fois, tous les tests seront en erreur.
Au fur et à mesure que vous implémenterez la classe Hotel, vous pourrez relancer à volonté les tests unitaires afin de suivre votre progression dans l'exercice.
Lorsque tous les tests unitaires sont verts (et donc validés), votre code devrait répondre aux exigences de l'exercice, et votre travail sera donc terminé.
En situation réelle, commencer par écrire des tests avant d'écrire du code s'appelle le TDD (pour Test Driven Development, ou en français Développement piloté par les tests).
L'idée est d'écrire des tests qui répondent aux exigences du business (le client) puis d'écrire progressivement du code en lançant fréquemment les tests pour vérifier si le code répond à toutes les exigences.
Généralement, on commence par écrire un test, puis du code qui y répond. Ensuite, on ajoute un autre test et on modifie notre code pour qu'il réponde aux deux tests, et ainsi de suite.
Le Projet Solution contient un exemple de solution possible et fonctionnelle qui répond à l'exercice. Vous pouvez vous en servir (avec modération...) pour vous aider lorsque vous êtes bloqués.
Avec la solution et les tests, vous devriez pouvoir vous en sortir seuls. Cependant, n'hésitez pas à me demander de l'aide si vous en avez besoin ou si vous ne comprenez pas quelque chose.
Le code est volontairement non optimisé afin de rester accessible aux débutants, Solution comprise.
N'hésitez pas à essayer d'optimiser le code en utilisant des bibliothèques telles que Linq et à me demander de l'aide si vous souhaitez faire cet exercice d'optimisation.
Bon courage !