Verbesserung von LocalizationController mit XML-Dokumentation

Die Klasse LocalizationController wurde aktualisiert, um XML-Dokumentationskommentare für eine bessere Klarheit und ein besseres Verständnis der Methoden und Eigenschaften einzuschließen. Zusammenfassungen von Konstruktoren und Methoden sowie Parameterbeschreibungen wurden in deutscher Sprache hinzugefügt. Die allgemeine Struktur und Formatierung der Klasse wurde verbessert, um die richtige Definition und Lesbarkeit zu gewährleisten.

EnvelopeGenerator.GeneratorAPI/Controllers/LocalizationController.cs

@@ -6,12 +6,15 @@ using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.Caching.Memory;
 using Microsoft.Extensions.Localization;
 
-namespace EnvelopeGenerator.GeneratorAPI.Controllers
+namespace EnvelopeGenerator.GeneratorAPI.Controllers;
+
+/// <summary>
+/// Controller für die Verwaltung der Lokalisierung und Spracheinstellungen.
+/// </summary>
+[Route("api/[controller]")]
+[ApiController]
+public class LocalizationController : ControllerBase
 {
-    [Route("api/[controller]")]
-    [ApiController]
-    public class LocalizationController : ControllerBase
-    {
     private static readonly Guid L_KEY = Guid.NewGuid();
 
     private readonly ILogger<LocalizationController> _logger;
@@ -19,6 +22,13 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
     private readonly IStringLocalizer<Resource> _localizer;
     private readonly IMemoryCache _cache;
 
+    /// <summary>
+    /// Konstruktor für den <see cref="LocalizationController"/>.
+    /// </summary>
+    /// <param name="logger">Logger für die Protokollierung.</param>
+    /// <param name="localizer">Lokalisierungsdienst für Ressourcen.</param>
+    /// <param name="memoryCache">Speicher-Cache für die Zwischenspeicherung von Daten.</param>
+    /// <param name="_modelLocalizer">Lokalisierungsdienst für Modelle.</param>
     public LocalizationController(
         ILogger<LocalizationController> logger,
         IStringLocalizer<Resource> localizer,
@@ -31,12 +41,25 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
         _mLocalizer = _modelLocalizer;
     }
 
+    /// <summary>
+    /// Ruft alle lokalisierten Daten ab.
+    /// </summary>
+    /// <returns>Eine Liste aller lokalisierten Daten.</returns>
     [HttpGet]
     public IActionResult GetAll() => Ok(_cache.GetOrCreate(Language ?? string.Empty + L_KEY, _ => _mLocalizer.ToDictionary()));
 
+    /// <summary>
+    /// Ruft die aktuelle Sprache ab.
+    /// </summary>
+    /// <returns>Die aktuelle Sprache oder ein NotFound-Ergebnis, wenn keine Sprache gesetzt ist.</returns>
     [HttpGet("lang")]
     public IActionResult GetLanguage() => Language is null ? NotFound() : Ok(Language);
 
+    /// <summary>
+    /// Setzt die Sprache.
+    /// </summary>
+    /// <param name="language">Die zu setzende Sprache.</param>
+    /// <returns>Ein Ok-Ergebnis, wenn die Sprache erfolgreich gesetzt wurde, oder ein BadRequest-Ergebnis, wenn die Eingabe ungültig ist.</returns>
     [HttpPost("lang")]
     public IActionResult SetLanguage([FromQuery] string language)
     {
@@ -47,6 +70,10 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
         return Ok();
     }
 
+    /// <summary>
+    /// Löscht die aktuelle Sprache.
+    /// </summary>
+    /// <returns>Ein Ok-Ergebnis, wenn die Sprache erfolgreich gelöscht wurde.</returns>
     [HttpDelete("lang")]
     public IActionResult DeleteLanguage()
     {
@@ -54,6 +81,9 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
         return Ok();
     }
 
+    /// <summary>
+    /// Eigenschaft für die Verwaltung der aktuellen Sprache über Cookies.
+    /// </summary>
     private string? Language
     {
         get
@@ -87,5 +117,4 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
             }
         }
     }
-    }
 }