From 5331efe3c137e7dcf9c4a1d257cea886329c71b6 Mon Sep 17 00:00:00 2001
From: Developer 02 <developer02@didaloghe.onmicrosoft.com>
Date: Tue, 29 Apr 2025 16:39:18 +0200
Subject: [PATCH] =?UTF-8?q?feat(sql):=20Hinzuf=C3=BCgen=20generischer=20?=
 =?UTF-8?q?=C3=9Cberladungen=20zu=20SQLExecutor=20unter=20Verwendung=20von?=
 =?UTF-8?q?=20ISQL<T>=20=C3=BCber=20DI?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Es wurden Überladungen für ExecuteFirstAsync, ExecuteSingleAsync und ExecuteAllAsync
eingeführt, die SQL-Definitionen aus dem Dependency Injection Container mittels ISQL<T> auflösen.
Außerdem wurde ein Fehler bei der Verwendung der Direktive von .cs zu standardmäßigem Schnittstellenimport korrigiert.
---
 .../Contracts/SQLExecutor/ISQL.cs             | 20 ++++++++++++++++
 .../Contracts/SQLExecutor/ISQLExecutor.cs     |  6 +++++
 .../SQLExecutor.cs                            | 23 ++++++++++++++++++-
 3 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQL.cs

diff --git a/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQL.cs b/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQL.cs
new file mode 100644
index 00000000..00c0cd8d
--- /dev/null
+++ b/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQL.cs
@@ -0,0 +1,20 @@
+namespace EnvelopeGenerator.Application.Contracts.SQLExecutor;
+
+/// <summary>
+/// Represents a raw SQL query contract.
+/// </summary>
+public interface ISQL
+{
+    /// <summary>
+    /// Gets the raw SQL query string.
+    /// </summary>
+    string Raw { get; }
+}
+
+/// <summary>
+/// Represents a typed SQL query contract for a specific entity.
+/// </summary>
+/// <typeparam name="TEntity">The type of the entity associated with the SQL query.</typeparam>
+public interface ISQL<TEntity> : ISQL
+{
+}
\ No newline at end of file
diff --git a/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQLExecutor.cs b/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQLExecutor.cs
index e147218f..245657e9 100644
--- a/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQLExecutor.cs
+++ b/EnvelopeGenerator.Application/Contracts/SQLExecutor/ISQLExecutor.cs
@@ -32,4 +32,10 @@ public interface ISQLExecutor<TEntity>
     /// <param name="parameters">Optional parameters for the SQL query.</param>
     /// <returns>An <see cref="IEnumerable{TEntity}"/> containing all matching results.</returns>
     Task<IEnumerable<TEntity>> ExecuteAllAsync(string sql, CancellationToken cancellation = default, params object[] parameters);
+
+    Task<TEntity?> ExecuteFirstAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<TEntity>;
+
+    Task<TEntity?> ExecuteSingleAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<TEntity>;
+
+    Task<IEnumerable<TEntity>> ExecuteAllAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<TEntity>;
 }
diff --git a/EnvelopeGenerator.Infrastructure/SQLExecutor.cs b/EnvelopeGenerator.Infrastructure/SQLExecutor.cs
index fdb69dd4..050beb28 100644
--- a/EnvelopeGenerator.Infrastructure/SQLExecutor.cs
+++ b/EnvelopeGenerator.Infrastructure/SQLExecutor.cs
@@ -1,5 +1,6 @@
-using EnvelopeGenerator.Application.Contracts.SQLExecutor.cs;
+using EnvelopeGenerator.Application.Contracts.SQLExecutor;
 using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
 
 namespace EnvelopeGenerator.Infrastructure;
 
@@ -7,6 +8,8 @@ public sealed class SQLExecutor<T> : ISQLExecutor<T> where T : class
 {
     private readonly EGDbContext _context;
 
+    private readonly IServiceProvider _provider;
+
     public SQLExecutor(EGDbContext context)
     {
         _context = context;
@@ -29,4 +32,22 @@ public sealed class SQLExecutor<T> : ISQLExecutor<T> where T : class
                     .Set<T>()
                     .FromSqlRaw(sql, parameters)
                     .ToListAsync(cancellation);
+
+    public Task<T?> ExecuteFirstAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<T>
+    {
+        var sql = _provider.GetRequiredService<TSQL>();
+        return ExecuteFirstAsync(sql.Raw);
+    }
+
+    public Task<T?> ExecuteSingleAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<T>
+    {
+        var sql = _provider.GetRequiredService<TSQL>();
+        return ExecuteSingleAsync(sql.Raw);
+    }
+
+    public Task<IEnumerable<T>> ExecuteAllAsync<TSQL>(CancellationToken cancellation = default, params object[] parameters) where TSQL : ISQL<T>
+    {
+        var sql = _provider.GetRequiredService<TSQL>();
+        return ExecuteAllAsync(sql.Raw);
+    }
 }