ConectaSql 1.0.2

ConectaSql

ConectaSql es una libreria que ayuda al programador a abstraer la logica de conversion de objetos a modelos en la aplicacion. Esto permite concentrarse en la solucion de la aplicacion y no estar lidiando directamente con la extraccion de los datos de DataSets y DataTables para convertirlos de manera manual. Al final queda un codigo mas limpio! Otro objetivo es que al ver el codigo sea mas clara la intencion de la solucion.

Instalacion

La instalacion es por medio de nuget

dotnet add package ConectaSql --version 1.0.1

Uso

Se requieren 4 variables de entorno:

SERVERDB=Instancia o ip
DATABASE=DataBase
USERDB=Usuario previamente encriptado
PASSDB=Password previamente encriptado

La idea original es para usarlo en la capa de datos o donde se maneja los repositorios, Para comenzar solo se instacia, el constructor se encarga de obtener las credenciales de su entorno y configurarse

ConectaMssql cnn = new ConectaMssql();

Para hacer uso de la libreria se usa el metodo GetDataList, tiene 4 sobrecargas

public class Cliente
{
    public string Nombre { get; init; }
    public int Edad { get; init; }
    public DateTime FechaNacimiento { get; init; }
}

string querySimple = "SELECT Nombre, Edad, FechaNacimiento FROM Clientes;";
string queryConParametros = "SELECT Nombre, Edad, FechaNacimiento FROM Clientes WHERE Nombre = @Nombre AND FechaNacimiento > @FechaNacimiento;";

// Consulta simple
List<Cliente> clientes1 = cnn.GetDataList<Cliente>(querySimple);

// Consulta con una lista de parametros
List<Parameter> parameters = new List<Parameter>();
parameters.Add(new Parameter("@Nombre", "Juan Francisco"));
parameters.Add(new Parameter("@FechaNacimiento", new DateTime(1998, 5, 23));
List<Cliente> clientes2 = cnn.GetDataList<Cliente>(queryConParametros, parameters);

// Consulta enciando parametros individualmente
Parameter nombre = new Parameter("@Nombre", "Juan Francisco");
Parameter fechaNacimiento = new Parameter("@FechaNacimiento", new DateTime(1998, 5, 23));
List<Cliente> clientes3 = cnn.GetDataList<Cliente>(queryConParametros, nombre, fechaNacimiento);

// Consulta directa
List<Cliente> clientes4 = cnn.GetDataList<Cliente>(queryConParametros, ("@Nombre", "Juan Francisco"), ("@FechaNacimiento", new DateTime(1998, 5, 23));

Tambien puede hacer una lista de datos primitivos

string query = "SELECT Nombre FROM Clientes WHERE Nombre LIKE @Nombre + '%';";
List<string> nombres = cnn.GetDataList<string>(query, ("@Nombre", "Juan"));

Otra caracteristica es usar la clase Parameter para dejar de depender directametne de la libreria de System.Data.SqlClient y reducir el acoplamiento a un motor de base de datos en especifico

// implementacion public Parameter(string parameterName, object value)
// internamente antes de hacer la consulta se convierte al tipo de dato correspondiente
Parameter stringParemetro = new("@Cliente", "Juan");
Parameter intParemetro = new("@Cliente", 23);
Parameter floatParemetro = new("@Cliente", 543.54f);

Contribucion

Licencia