commentaire endpoint

PyroFetes/Endpoints/Effect/UpdateEffectEndpoint.cs

@@ -7,35 +7,32 @@ namespace PyroFetes.Endpoints.Effect;
 
 public class UpdateEffectEndpoint(PyroFetesDbContext pyrofetesdbcontext) : Endpoint<UpdateEffectDto, GetEffectDto>
 {
-    public override void Configure()
+    public override void Configure() //Configuration de l'endpoint
     {
-        Put("Api/effects/{@id}", x => new { x.Id });
-        AllowAnonymous();
+        Put("Api/effects/{@id}", x => new { x.Id }); //Création d'un endpoint qui modifie un effet grâce à son id
+        AllowAnonymous(); //Ignorer les requêtes non authentifiées
     }
 
     public override async Task HandleAsync(UpdateEffectDto req, CancellationToken ct)
     {
-        Models.Effect? effectToEdit = await pyrofetesdbcontext
-            .Effects 
-            .SingleOrDefaultAsync(x => x.Id == req.Id, cancellationToken: ct);
+        Models.Effect? effectToEdit = await pyrofetesdbcontext //Récupère un effet dans la bdd et le stocke dans effectToEdit
+            .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 (effectToEdit == null)
+        if (effectToEdit == 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 qu'aucun effet avec l'id ... n'a été trouvé
+            await Send.NotFoundAsync(ct); //Renvoie une erreur 404
+            return; //Arrêt de la méthode
         }
-        effectToEdit.Label = req.Label;
-        await pyrofetesdbcontext.SaveChangesAsync(ct);
+        effectToEdit.Label = req.Label; //Modification du label de l'effet
+        await pyrofetesdbcontext.SaveChangesAsync(ct); //Sauvegarde les changements effectués dans la base de données
 
-        GetEffectDto responseDto = new()
+        GetEffectDto responseDto = new() //Construire l'objet de réponse pour retourner l'id et le label de l'effet modifié
         {
-            Id = req.Id,
-            Label = req.Label,
+            Id = req.Id, //Inclut l'id dans la réponse
+            Label = req.Label, //Inclut le label dans la réponse
         };
-        await Send.OkAsync(responseDto, ct);
-
+        await Send.OkAsync(responseDto, ct); //Envoie une réponse 200 OK avec l'objet de réponse
     }
-    
 }