RetailSolutions.Shared.Database 1.2.72

RetailSolutions.Shared.Database

Biblioteca compartilhada para abstração de acesso a bancos de dados Oracle e SQL Server, fornecendo uma interface unificada e extensões úteis para operações comuns.

Características

• Factory Pattern: Criação automática de conexões baseada na string de conexão
• Suporte Multi-Banco: Oracle e SQL Server
• Extensões Oracle: Configuração otimizada e geração de SQL statements
• Query Extensions: Binding automático de parâmetros em queries
• Integração Dapper: Suporte para DynamicParameters do Dapper

Instalação

Via NuGet

dotnet add package RetailSolutions.Shared.Database

Dependências

• Dapper (2.1.66)
• Microsoft.Data.SqlClient (6.1.3)
• Oracle.ManagedDataAccess.Core (23.26.0)
• Microsoft.Extensions.Configuration (10.0.0)
• Microsoft.Extensions.DependencyInjection (10.0.0)
• Microsoft.Extensions.Hosting (10.0.1)

Uso

DatabaseConnectionFactory

Cria conexões automaticamente baseado na string de conexão:

using RetailSolutions.Shared.Database;

// Oracle
var oracleConnection = DatabaseConnectionFactory.CreateDbConnection(
    "Data Source=localhost:1521/XE;User Id=user;Password=pass;"
);

// SQL Server
var sqlConnection = DatabaseConnectionFactory.CreateDbConnection(
    "Server=localhost;Database=MyDb;User Id=user;Password=pass;"
);

Oracle Extensions

Configuração Inicial

using RetailSolutions.Shared.Database.Extensions;

OracleExtension.ConfigureOracleStartup();

Configurações aplicadas:

• Statement Cache Size: 25
• Bind By Name: true
• Command Timeout: 300 segundos
• Fetch Size: 1MB
• Trace habilitado em LogFiles/

Geração de SQL Statement

using Oracle.ManagedDataAccess.Client;

var command = new OracleCommand("SELECT * FROM users WHERE id = :id");
command.Parameters.Add(":id", OracleDbType.Int32).Value = 1;

var sql = command.GetSqlStatement();

Dapper Integration

using Dapper;
using RetailSolutions.Shared.Database.Extensions;

var parameters = new DynamicParameters();
parameters.Add(":id", 1);

var query = "SELECT * FROM users WHERE id = :id";
var sql = parameters.GetDapperSqlStatement(query);

Query Extensions

Binding automático de parâmetros em queries:

using RetailSolutions.Shared.Database.Extensions;

var query = "SELECT * FROM users WHERE id = @id AND name = :name";
var parameters = new { id = 1, name = "John" };

var boundQuery = query.BindParameters(parameters);
// Resultado: SELECT * FROM users WHERE id = 1 AND name = 'John'

Suporta:

• Parâmetros @ (SQL Server) e : (Oracle)
• Tipos: string, DateTime, bool, numéricos
• Escape automático de aspas simples
• Normalização de espaços em branco

Build e Test

Build

dotnet build

Test

dotnet test

Estrutura do Projeto

database/
├── DatabaseConnectionFactory.cs    # Factory para criação de conexões
├── Extensions/
│   ├── OracleExtension.cs          # Extensões específicas Oracle
│   └── QueryExtensions.cs          # Extensões para queries
└── RetailSolutions.Shared.Database.csproj

Requisitos

• .NET 10.0 ou superior
• Oracle Client (para conexões Oracle)
• SQL Server (para conexões SQL Server)

Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

Licença

Copyright © Retail Solutions. Todos os direitos reservados.

Links

• Website
• Documentação Microsoft