commentaire endpoint

PyroFetes/Endpoints/Effect/GetEffectEndpoint.cs

@@ -11,31 +11,31 @@ public class GetEffectRequest
 
 public class GetEffectEndpoint(PyroFetesDbContext pyrofetesdbcontext) : Endpoint<GetEffectRequest, GetEffectDto>
 {
-    public override void Configure()
+    public override void Configure() //Configuration de l'endpoint
     {
-        Get("Api/effects/{@id}", x => new { x.Id });
-        AllowAnonymous();
+        Get("Api/effects/{@id}", x => new { x.Id }); //Création d'un endpoint qui récupère un effet grâce à son id
+        AllowAnonymous(); //Ignorer les requêtes non authentifiées
     }
 
-    public override async Task HandleAsync(GetEffectRequest req, CancellationToken ct)
+    public override async Task HandleAsync(GetEffectRequest req, CancellationToken ct) //Méthode asynchrone qui traite la récupération de l'effet
     {
-        Models.Effect? effect = await pyrofetesdbcontext
-            .Effects
-            .SingleOrDefaultAsync(x => x.Id == req.Id, cancellationToken: ct);
+        Models.Effect? effect = await pyrofetesdbcontext //Récupère un effet dans la bdd et le stocke dans effect
+            .Effects //Recherche l'effet dans la table Effects
+            .SingleOrDefaultAsync(x => x.Id == req.Id, cancellationToken: ct); //Recherche un effet dont l'id correspond à req.Id  
 
-        if (effect == null)
+        if (effect == null) //Si l'effet n'est pas trouvé
         {
-            Console.WriteLine("Aucun effet avec l'ID {req.Id} trouvé.");
-            await Send.NotFoundAsync(ct);
-            return;
+            Console.WriteLine("Aucun effet avec l'ID {req.Id} trouvé."); //Afficher aucun effet avec l'id ... trouvé
+            await Send.NotFoundAsync(ct); //Renvoie une erreur 404
+            return; //Arrêt de la méthode
         }
 
-        GetEffectDto responseDto = new()
+        GetEffectDto responseDto = new() //Constuire l'objet de réponse pour retourner id et label à l'utilisateur
         {
-            Id = effect.Id,
-            Label = effect.Label,
+            Id = effect.Id, //Affiche l'id lors de la réponse
+            Label = effect.Label, //Affiche le label lors de la réponse
         };
-        await Send.OkAsync(responseDto, ct);
-
+        await Send.OkAsync(responseDto, ct); //Envoie de la réponse réussite 200 au client
+ 
     }
 }