Files
Data-Coupler/DataConnection/DB/Interfaces/IDatabaseManager.cs
T
Alessio 51c61eabf7 feat: Implementa gestione intelligente della chiave sorgente con rilevamento PK
- Aggiunge rilevamento automatico Primary Key per connessioni database
- Rimuove completamente il fallback automatico per lato sorgente
- Implementa selezione manuale obbligatoria per file e sorgenti non-DB
- Migliora UI con suggerimenti intelligenti e feedback visivo
- Aggiunge validazione multi-livello (UI, pre-transfer, runtime)
- Introduce metodo GetPrimaryKeyFieldAsync in IDatabaseManager
- Modifica GenerateSourceKey per richiedere sempre campo specifico
- Implementa controllo IsTransferButtonEnabled per validazione form

Breaking changes:
- La generazione automatica delle chiavi sorgente è stata rimossa
- Il campo chiave sorgente è ora obbligatorio quando si usa il sistema associazioni

Fixes: Risolve problema di discovery schema vuoto con selezione database
2025-06-28 02:05:59 +02:00

87 lines
2.9 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq.Expressions;
using System.Threading.Tasks;
namespace DataConnection.Interfaces;
/// <summary>
/// Interfaccia per la gestione di database preesistenti tramite EF Core
/// </summary>
public interface IDatabaseManager : IDisposable
{
/// <summary>
/// Verifica la connessione al database
/// </summary>
Task<bool> TestConnectionAsync();
/// <summary>
/// Ottiene entità dal database in base ai criteri specificati
/// </summary>
/// <typeparam name="T">Tipo di entità</typeparam>
/// <param name="filter">Espressione di filtro</param>
/// <param name="orderBy">Espressione di ordinamento</param>
/// <param name="includeProperties">Proprietà di navigazione da includere</param>
/// <param name="skip">Numero di elementi da saltare</param>
/// <param name="take">Numero di elementi da prendere</param>
Task<IEnumerable<T>> GetAsync<T>(
Expression<Func<T, bool>> filter = null,
Func<IQueryable<T>, IOrderedQueryable<T>> orderBy = null,
string includeProperties = "",
int? skip = null,
int? take = null) where T : class;
/// <summary>
/// Ottiene un'entità singola in base alla chiave primaria
/// </summary>
Task<T> GetByIdAsync<T>(object id) where T : class;
/// <summary>
/// Esegue una query SQL raw
/// </summary>
Task<IEnumerable<T>> ExecuteQueryAsync<T>(string sql, params object[] parameters) where T : class;
/// <summary>
/// Esegue un comando SQL che non restituisce risultati
/// </summary>
Task<int> ExecuteCommandAsync(string sql, params object[] parameters);
/// <summary>
/// Ottiene l'elenco dei database disponibili sul server
/// </summary>
Task<List<string>> GetAvailableDatabasesAsync();
/// <summary>
/// Cambia il database corrente per la connessione
/// </summary>
Task ChangeDatabaseAsync(string databaseName);
/// <summary>
/// Ottiene i metadati delle tabelle nel database
/// </summary>
Task<IDictionary<string, IEnumerable<DbColumnInfo>>> GetDatabaseSchemaAsync();
/// <summary>
/// Ottiene tutti i record da una tabella specifica come dizionari chiave-valore
/// </summary>
Task<IEnumerable<Dictionary<string, object>>> GetAllRecordsAsync(string tableName);
/// <summary>
/// Ottiene il nome del campo Primary Key di una tabella specifica
/// </summary>
Task<string?> GetPrimaryKeyFieldAsync(string tableName);
}
/// <summary>
/// Informazioni su una colonna del database
/// </summary>
public class DbColumnInfo
{
public string Name { get; set; } = string.Empty;
public string DataType { get; set; } = string.Empty;
public bool IsNullable { get; set; }
public bool IsPrimaryKey { get; set; }
public bool IsForeignKey { get; set; }
public string? ReferencedTable { get; set; }
public string? ReferencedColumn { get; set; }
}