ConnectionHU 1.2.1

DynamicBuilder para consultas SQL dinámicas con Dapper

La clase DynamicBuilder permite construir y ejecutar de forma fluida y segura consultas SQL (SELECT, INSERT, UPDATE, DELETE, y consultas personalizadas) utilizando Dapper, con soporte para filtros, joins, alias, y transacciones en múltiples dialectos SQL.

🚀 Características

• Fluent API para construir consultas dinámicas.
• Soporte para múltiples bases de datos vía SqlDialect.
• Filtros dinámicos con validación (FilterRule).
• Soporte para JOIN con múltiples condiciones (ON, AND).
• Ejecución segura usando Dapper.
• Manejo de errores personalizado.
• Soporte para transacciones opcionales.
• Registra las consultas ejecutadas en archivos .log.

🧱 Requisitos

• .NET 6 o superior.
• Dapper
• Las siguientes clases/utilidades deben estar implementadas:
  • FilterRule, CriterioJoin, CriterioON, Criterio
  • SqlDialect, IOperationsSQL, ConcreteConnectionFactory
  • BuildSql, Files, Utilities
  • Excepciones personalizadas como ExceptionForArguments, ExceptionQuery, ExceptionExecute

🛠️ Uso básico

var connection = new SqlConnection("connection_string");
var builder = new DynamicBuilder(connection, SqlDialect.SqlServer);

var result = await builder
    .Schema("dbo")
    .Select("Usuarios", new[] { "Id", "Nombre" })
    .Where(new FilterRule { Field = "Activo", Operator = "=", Value = true })
    .ExecuteAsync();

📌 Métodos disponibles

📄 Ejemplo de Insert

await builder
    .Table("Usuarios")
    .InsertAsync(new { Nombre = "Juan", Activo = true });

🔄 Ejemplo de Update

await builder
    .Table("Usuarios")
    .UpdateAsync(
        new { Activo = false },
        new List<Criterio> { new Criterio { Field = "Id", Operator = "=", Value = 1 } }
    );

🧹 Ejemplo de Delete

await builder
    .Table("Usuarios")
    .DeleteAsync(
        new List<Criterio> { new Criterio { Field = "Id", Operator = "=", Value = 1 } }
    );

📌 Notas

• Los métodos Join(), On() y And() deben usarse en conjunto y en orden.
• Las condiciones (Where, On, And) se validan automáticamente.
• Las consultas ejecutadas se guardan en archivos .log por día.
• Manejo de errores centralizado mediante excepciones específicas del dominio.

🧩 Extensiones futuras

• Soporte para ORDER BY, GROUP BY.
• Soporte para TOP, LIMIT, OFFSET.
• Soporte para subconsultas.

📬 Contribuciones

Este builder está diseñado para ser modular y fácilmente extensible. Se agradecen sugerencias o mejoras.

⚖️ Licencia

Este proyecto está bajo una licencia privada/empresarial. Modifica esta sección según corresponda.