refactor: standardiser la journalisation des contrôleurs et l’utilisation des référentiels

Webzine.WebApplication/Controllers/RechercheController.cs

@@ -5,25 +5,38 @@ using Webzine.WebApplication.ViewModels.Titre;
 
 namespace Webzine.WebApplication.Controllers;
 
+/// <summary>
+/// Controleur responsable de la recherche d'artistes et de titres musicaux.
+/// </summary>
 [Route("recherche")]
 public class RechercheController : Controller
 {
-    private readonly ILogger<RechercheController> _logger;
-    private readonly ITitreRepository _titreRepository;
+    private readonly ILogger<RechercheController> logger;
+    private readonly ITitreRepository titreRepository;
 
+    /// <summary>
+    /// Initialise une nouvelle instance de la classe <see cref="RechercheController"/>.
+    /// </summary>
+    /// <param name="logger">Service de journalisation injecté pour suivre les opérations du contrôleur.</param>
+    /// <param name="titreRepository">Repository des titres injecté pour effectuer les recherches d'artistes et de titres.</param>
     public RechercheController(ILogger<RechercheController> logger, ITitreRepository titreRepository)
     {
-        this._logger = logger;
-        this._titreRepository = titreRepository;
+        this.logger = logger;
+        this.titreRepository = titreRepository;
     }
 
+    /// <summary>
+    /// Affiche les résultats de la recherche d'artistes et de titres en fonction du mot-clé fourni.
+    /// </summary>
+    /// <param name="mot">Le mot-clé de recherche utilisé pour trouver les artistes et les titres correspondants.</param>
+    /// <returns>Une vue contenant les résultats de la recherche d'artistes et de titres.</returns>
     [HttpPost("")]
     public IActionResult Index(string mot)
     {
-        this._logger.LogInformation("Recherche artistes/titres pour le mot : {Mot}.", mot);
+        this.logger.LogInformation("Recherche artistes/titres pour le mot : {Mot}.", mot);
 
-        var titres = _titreRepository.Search(mot)
-            .Concat(_titreRepository.SearchByStyle(mot))
+        var titres = this.titreRepository.Search(mot)
+            .Concat(this.titreRepository.SearchByStyle(mot))
             .DistinctBy(t => t.IdTitre)
             .OrderBy(t => t.Libelle)
             .Select(t => new TitreStyleItem
@@ -32,14 +45,13 @@ public class RechercheController : Controller
                 Libelle = t.Libelle,
                 ArtisteNom = t.Artiste?.Nom,
                 UrlJaquette = t.UrlJaquette,
-                Duree = t.Duree
+                Duree = t.Duree,
             })
             .ToList();
 
-        var artistes = _titreRepository.FindAll()
+        var artistes = this.titreRepository.FindAll()
             .Select(t => t.Artiste)
-            .Where(a => a != null
-                && !string.IsNullOrWhiteSpace(a.Nom)
+            .Where(a => !string.IsNullOrWhiteSpace(a.Nom)
                 && !string.IsNullOrWhiteSpace(mot)
                 && a.Nom.Contains(mot, StringComparison.OrdinalIgnoreCase))
             .DistinctBy(a => a!.IdArtiste)
@@ -47,7 +59,7 @@ public class RechercheController : Controller
             .Select(a => new RechercheArtisteItem
             {
                 Nom = a!.Nom,
-                NombreDeTitres = a.Titres?.Count ?? 0
+                NombreDeTitres = a.Titres?.Count ?? 0,
             })
             .ToList();
 
@@ -55,9 +67,9 @@ public class RechercheController : Controller
         {
             Mot = mot,
             Artistes = artistes,
-            Titres = titres
+            Titres = titres,
         };
 
-        return View(vm);
+        return this.View(vm);
     }
 }