#123 refactor: refonte de DbCommentaireRepository et LocalCommentaireRepository en prenant comme model Joséphine:

- Nettoyage du code
 - ajout des <inheritdoc/>
 - InMemoryDataStore pour le mode local
This commit is contained in:
b.nodon
2026-03-27 10:21:20 +01:00
parent b7f06c8e8b
commit a3db0059ab
2 changed files with 117 additions and 209 deletions

View File

@@ -15,7 +15,7 @@ public class DbCommentaireRepository : ICommentaireRepository
private readonly WebzineDbContext context;
/// <summary>
/// Init de <see cref="DbCommentaireRepository"/> .
/// Initialisation de <see cref="DbCommentaireRepository"/>.
/// </summary>
/// <param name="logger">Le service de journalisation injecté pour suivre les opérations du repository.</param>
/// <param name="context">Le contexte de base de données injecté.</param>
@@ -23,87 +23,99 @@ public class DbCommentaireRepository : ICommentaireRepository
{
this.logger = logger;
this.context = context;
this.logger.LogDebug(1, "NLog injecté dans DbCommentaireRepository");
this.logger.LogDebug("NLog injecté dans DbCommentaireRepository");
}
/// <summary>
/// Ajoute un commentaire à la base de données.
/// </summary>
/// <param name="commentaire">L'objet commentaire à ajouter.</param>
/// <inheritdoc/>
public void Add(Commentaire commentaire)
{
this.logger.LogInformation($"Ajout nouveau commentaire depuis auteur: {commentaire.Auteur}");
this.context.Commentaires.Add(commentaire);
this.context.SaveChanges();
this.logger.LogDebug($"Commentaire ajouté avec l'id: {commentaire.IdCommentaire}");
try
{
if (commentaire == null)
{
throw new ArgumentNullException(nameof(commentaire), "Le commentaire à ajouter ne peut pas être null.");
}
this.logger.LogInformation("Ajout d'un nouveau commentaire de l'auteur : {Auteur}", commentaire.Auteur);
this.context.Commentaires.Add(commentaire);
this.context.SaveChanges();
this.logger.LogDebug("Commentaire ajouté avec l'id : {Id}", commentaire.IdCommentaire);
}
catch (DbUpdateException dbex)
{
this.logger.LogError(dbex, "Erreur de base de données lors de l'ajout du commentaire de l'auteur : {Auteur}", commentaire?.Auteur);
throw;
}
catch (Exception ex)
{
this.logger.LogError(ex, "Une erreur est survenue lors de l'ajout d'un commentaire.");
throw new Exception("Une erreur est survenue lors de l'ajout du commentaire.", ex);
}
}
/// <summary>
/// Remonte le nombre de commentaires.
/// </summary>
/// <returns>Le nombre total de commentaires présents dans la base de données.</returns>
/// <inheritdoc/>
public void Delete(Commentaire commentaire)
{
try
{
if (commentaire == null)
{
throw new ArgumentNullException(nameof(commentaire), "Le commentaire à supprimer ne peut pas être null.");
}
this.context.Commentaires.Remove(commentaire);
this.context.SaveChanges();
this.logger.LogInformation("Le commentaire {IdCommentaire} a bien été supprimé", commentaire.IdCommentaire);
}
catch (DbUpdateException dbex)
{
this.logger.LogError(dbex, "Erreur de base de données lors de la suppression du commentaire : {Id}", commentaire.IdCommentaire);
throw;
}
catch (Exception ex)
{
this.logger.LogError(ex, "Une erreur est survenue lors de la suppression du commentaire {Id}.", commentaire?.IdCommentaire);
throw new Exception("Une erreur est survenue lors de la suppression du commentaire.", ex);
}
}
/// <inheritdoc/>
public int Count()
{
var count = this.context.Commentaires.Count();
this.logger.LogDebug($"Compte total des commentaires: {count}");
this.logger.LogDebug("Compte total des commentaires : {Count}", count);
return count;
}
/// <summary>
/// Supprime un commentaire de la base de données.
/// </summary>
/// <param name="commentaire">L'objet commentaire à supprimer.</param>
public void Delete(Commentaire commentaire)
{
this.logger.LogInformation($"suppression du commentaire avec l'id: {commentaire.IdCommentaire}");
this.context.Commentaires.Remove(commentaire);
this.context.SaveChanges();
this.logger.LogDebug($"Commentaire supprimé: {commentaire.IdCommentaire}");
}
/// <summary>
/// Trouve un commentaire dans la base de données en fonction de son identifiant.
/// </summary>
/// <param name="idCommentaire">L'identifiant du commentaire à trouver.</param>
/// <returns>Le commentaire correspondant à l'identifiant fourni, ou null si aucun n'est trouvé.</returns>
/// <inheritdoc/>
public Commentaire Find(int idCommentaire)
{
this.logger.LogDebug($"Commentaire cherché avec l'id: {idCommentaire}");
this.logger.LogDebug("Recherche du commentaire avec l'id : {Id}", idCommentaire);
// On inclut le titre car il est souvent affiché avec le commentaire (ex: vue Delete)
var commentaire = this.context.Commentaires
// On inclut le titre car il est souvent affiché avec le commentaire
return this.context.Commentaires
.Include(c => c.Titre)
.FirstOrDefault(c => c.IdCommentaire == idCommentaire);
return commentaire;
}
/// <summary>
/// Trouve tous les commentaires dans la base de données, triés du plus récent au plus ancien.
/// </summary>
/// <returns>Une collection de tous les commentaires présents.</returns>
/// <inheritdoc/>
public IEnumerable<Commentaire> FindAll()
{
this.logger.LogDebug("Trouver tout les commentaires");
this.logger.LogDebug("Récupération de tous les commentaires");
var commentaires = this.context.Commentaires
.Include(c => c.Titre)
.OrderByDescending(c => c.DateCreation)
.ToList();
this.logger.LogDebug($"Nombre de tout les commentaires trouvé: {commentaires.Count}");
this.logger.LogDebug("Nombre de commentaires trouvés : {Count}", commentaires.Count);
return commentaires;
}
/// <summary>
/// Recherche les commentaires dans la base de données avec pagination.
/// </summary>
/// <param name="offset">L'offset à partir duquel commencer la recherche.</param>
/// <param name="limit">Le nombre maximum de commentaires à retourner.</param>
/// <returns>Une collection de commentaires paginée.</returns>
/// <inheritdoc/>
public IEnumerable<Commentaire> FindCommentaires(int offset, int limit)
{
this.logger.LogDebug($"Récherche des commentaires (décalage : {offset}, limite : {limit})");
this.logger.LogDebug("Recherche paginée des commentaires (offset : {Offset}, limit : {Limit})", offset, limit);
var commentaires = this.context.Commentaires
.Include(c => c.Titre)
@@ -112,18 +124,14 @@ public class DbCommentaireRepository : ICommentaireRepository
.Take(limit)
.ToList();
this.logger.LogDebug($"{commentaires.Count} commentaires trouvés");
this.logger.LogDebug("{Count} commentaires trouvés pour cette page", commentaires.Count);
return commentaires;
}
/// <summary>
/// Trouve tous les commentaires associés à un titre spécifique.
/// </summary>
/// <param name="idTitre">L'identifiant du titre.</param>
/// <returns>Une collection de commentaires pour ce titre.</returns>
/// <inheritdoc/>
public IEnumerable<Commentaire> FindByIdTitre(int idTitre)
{
this.logger.LogInformation($"Recherche des commentaires pour l'ID de titre : {idTitre}");
this.logger.LogInformation("Recherche des commentaires pour le titre ID : {IdTitre}", idTitre);
var commentaires = this.context.Commentaires
.Where(c => c.Titre.IdTitre == idTitre)