diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteDTO.cs b/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteDTO.cs index 0fb7042..52718b1 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteDTO.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteDTO.cs @@ -1,9 +1,19 @@ namespace WF_WebAdmin.Converter { + /// + /// Représente un objet de transfert de données (DTO) pour une citation quotidienne. + /// public class DailyQuoteDTO { + /// + /// Identifiant unique de la citation quotidienne. + /// private int Id { get; set; } + /// + /// Initialise une nouvelle instance de la classe avec un identifiant. + /// + /// L'identifiant unique de la citation quotidienne. public DailyQuoteDTO(int id) { this.Id = id; diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteExtension.cs b/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteExtension.cs index 63ec57e..cf7ced8 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteExtension.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/DailyQuoteExtension.cs @@ -2,10 +2,19 @@ namespace WF_WebAdmin.Converter { + /// + /// Fournit des extensions pour convertir des objets de type en objets de type . + /// public class DailyQuoteExtension { + /// + /// Convertit une instance de en une instance de . + /// + /// L'objet à convertir. + /// Une instance de contenant l'identifiant de la citation quotidienne. public DailyQuoteDTO DailyQuoteToDTO(DailyQuote dq) { + // Création de l'objet DTO à partir de l'objet DailyQuote DailyQuoteDTO dailyQuote = new DailyQuoteDTO(dq.Id); return dailyQuote; } diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/QuoteDTO.cs b/WF-WebAdmin/WF-WebAdmin/Converter/QuoteDTO.cs index 26a68a8..800d7c3 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/QuoteDTO.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/QuoteDTO.cs @@ -3,41 +3,121 @@ using System; namespace WF_WebAdmin.Converter { + /// + /// Représente un objet Data Transfer Object (DTO) pour une citation. + /// public class QuoteDTO { + /// + /// Identifiant de la citation. + /// public int Id { get; set; } + + /// + /// Contenu de la citation. + /// public string Content { get; set; } + + /// + /// Nombre de "likes" de la citation. + /// public int Likes { get; set; } + + /// + /// Langue de la citation. + /// public string Langue { get; set; } + + /// + /// Indique si la citation est valide. + /// public bool IsValide { get; set; } + + /// + /// Raison pour laquelle la citation pourrait être invalide. + /// public string? Reason { get; set; } + + /// + /// Identifiant du caractère associé à la citation (si applicable). + /// public int? IdCaracter { get; set; } + + /// + /// Nom du caractère associé à la citation (si applicable). + /// public string NameCharac { get; set; } + + /// + /// Identifiant de la source de la citation. + /// public int? IdSource { get; set; } + + /// + /// Titre de la source de la citation. + /// public string TitleSrc { get; set; } + + /// + /// Date de la source de la citation. + /// public DateTime DateSrc { get; set; } + + /// + /// Identifiant de l'utilisateur qui a vérifié la citation (si applicable). + /// public int? IdUserVerif { get; set; } + + /// + /// Nom de l'utilisateur qui a vérifié la citation. + /// public string NameUser { get; set; } + + /// + /// Identifiant de l'image associée à la citation (si applicable). + /// public int? IdImg { get; set; } + + /// + /// Chemin de l'image associée à la citation. + /// public string ImgPath { get; set; } - public QuoteDTO(int id_quote,string content,int likes,string langue,bool isValide,string? reason,int? id_caracter,string name_charac,int? id_source,string title,DateTime date,int? id_user_verif,string name_user ,int? id_img,string img_path) + /// + /// Initialise une nouvelle instance de . + /// + /// L'identifiant de la citation. + /// Le contenu de la citation. + /// Le nombre de likes de la citation. + /// La langue de la citation. + /// Indique si la citation est valide. + /// La raison pour laquelle la citation peut être invalide. + /// L'identifiant du caractère associé à la citation. + /// Le nom du caractère associé à la citation. + /// L'identifiant de la source de la citation. + /// Le titre de la source de la citation. + /// La date de la source de la citation. + /// L'identifiant de l'utilisateur ayant vérifié la citation. + /// Le nom de l'utilisateur ayant vérifié la citation. + /// L'identifiant de l'image associée à la citation. + /// Le chemin de l'image associée à la citation. + public QuoteDTO(int id_quote, string content, int likes, string langue, bool isValide, string? reason, int? id_caracter, string name_charac, int? id_source, string title, DateTime date, int? id_user_verif, string name_user, int? id_img, string img_path) { this.Id = id_quote; - this.Content = content; + this.Content = content; this.Likes = likes; this.Langue = langue; this.IsValide = isValide; - this.Reason = reason; - this.IdCaracter = id_caracter; - this.NameCharac = name_charac; - this.IdSource = id_source; - this.TitleSrc = title; - this.DateSrc = date; - this.IdUserVerif = id_user_verif; - this.NameUser = name_user; - this.IdImg = id_img; - this.ImgPath =img_path; - } + this.Reason = reason; + this.IdCaracter = id_caracter; + this.NameCharac = name_charac; + this.IdSource = id_source; + this.TitleSrc = title; + this.DateSrc = date; + this.IdUserVerif = id_user_verif; + this.NameUser = name_user; + this.IdImg = id_img; + this.ImgPath = img_path; + } } } diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/QuoteExtension.cs b/WF-WebAdmin/WF-WebAdmin/Converter/QuoteExtension.cs index a7bd57f..447fb08 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/QuoteExtension.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/QuoteExtension.cs @@ -2,17 +2,59 @@ namespace WF_WebAdmin.Converter { + /// + /// Classe d'extension pour la conversion entre les objets et . + /// public class QuoteExtension { + /// + /// Convertit un objet en un objet . + /// + /// L'objet à convertir. + /// Un objet contenant les données de l'objet . public QuoteDTO QuoteToDTO(Quote q) { - QuoteDTO quote = new QuoteDTO(q.Id, q.Content, q.Like, q.Langue, q.IsValid,null, null,q.Charac,null,q.TitleSrc,q.DateSrc,null,q.UserProposition,null,q.ImgPath); + // Conversion des propriétés de Quote en QuoteDTO + QuoteDTO quote = new QuoteDTO( + q.Id, + q.Content, + q.Like, + q.Langue, + q.IsValid, + null, // Reason non défini ici + null, // IdCaracter non défini ici + q.Charac, + null, // IdSource non défini ici + q.TitleSrc, + q.DateSrc, + null, // IdUserVerif non défini ici + q.UserProposition, + null, // IdImg non défini ici + q.ImgPath + ); return quote; } + /// + /// Convertit un objet en un objet . + /// + /// L'objet à convertir. + /// Un objet contenant les données de l'objet . public Quote DTOToQuote(QuoteDTO q) { - Quote quote = new Quote(q.Id, q.Content,q.NameCharac,q.ImgPath,q.TitleSrc,q.DateSrc,q.Likes,q.Langue,q.NameUser,q.IsValide); + // Conversion des propriétés de QuoteDTO en Quote + Quote quote = new Quote( + q.Id, + q.Content, + q.NameCharac, + q.ImgPath, + q.TitleSrc, + q.DateSrc, + q.Likes, + q.Langue, + q.NameUser, + q.IsValide + ); return quote; } } diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/UserDTO.cs b/WF-WebAdmin/WF-WebAdmin/Converter/UserDTO.cs index 53a6032..ec832e0 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/UserDTO.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/UserDTO.cs @@ -2,19 +2,51 @@ namespace WF_WebAdmin.Converter { + /// + /// Représente un objet Data Transfer Object (DTO) pour un utilisateur. + /// Utilisé pour transmettre les informations d'un utilisateur entre différentes couches de l'application. + /// public class UserDTO { + /// + /// Obtient ou définit l'image de l'utilisateur. + /// public string Image { get; set; } + + /// + /// Obtient ou définit le nom de l'utilisateur. + /// public string Name { get; set; } + + /// + /// Obtient ou définit l'adresse email de l'utilisateur. + /// public string Email { get; set; } + + /// + /// Obtient ou définit la date de création de l'utilisateur. + /// public DateTime DateCreation { get; set; } + /// + /// Obtient ou définit une valeur indiquant si l'utilisateur est un administrateur. + /// public Boolean IsAdmin { get; set; } + + /// + /// Obtient ou définit la liste des commentaires associés à l'utilisateur. + /// public List Comments { get; set; } + /// + /// Initialise une nouvelle instance de la classe avec les informations de base d'un utilisateur. + /// + /// L'image de l'utilisateur. + /// Le nom de l'utilisateur. + /// L'email de l'utilisateur. + /// La date de création du compte utilisateur. public UserDTO(string image, string name, string email, DateTime dateCreation) { - this.Image = image; this.Name = name; this.Email = email; diff --git a/WF-WebAdmin/WF-WebAdmin/Converter/UserExtension.cs b/WF-WebAdmin/WF-WebAdmin/Converter/UserExtension.cs index ebcf0e4..8d26585 100644 --- a/WF-WebAdmin/WF-WebAdmin/Converter/UserExtension.cs +++ b/WF-WebAdmin/WF-WebAdmin/Converter/UserExtension.cs @@ -2,16 +2,31 @@ namespace WF_WebAdmin.Converter { + /// + /// Classe d'extension permettant la conversion entre un utilisateur et son Data Transfer Object (DTO). + /// public class UserExtension { + /// + /// Convertit un objet en un objet . + /// + /// L'objet à convertir. + /// Retourne un nouvel objet avec les données du DTO. public User UserToDTO(UserDTO u) { - User user = new User(u.Image, u.Name, u.Email, u.DateCreation,u.IsAdmin); + // Création d'un objet User à partir des données du DTO + User user = new User(u.Image, u.Name, u.Email, u.DateCreation, u.IsAdmin); return user; } + /// + /// Convertit un objet en un objet . + /// + /// L'objet à convertir. + /// Retourne un nouvel objet avec les données de l'utilisateur. public UserDTO DTOToUser(User u) { + // Création d'un objet UserDTO à partir des données de l'utilisateur UserDTO user = new UserDTO(u.Image, u.Name, u.Email, u.DateCreation); return user; }