Minnor.Core 1.1.0

Minnor.Core

Minnor.Core é um micro ORM (Object-Relational Mapper) minimalista e leve para .NET, projetado para fornecer uma camada simples e expressiva de mapeamento entre objetos C# e bancos de dados relacionais. Ideal para quem busca controle direto sobre SQL, mas com uma estrutura mais organizada que o Dapper puro.

🆕 Versão 1.1.0 - Novidade: Suporte a Paginação

✨ O que há de novo?

A nova versão do Minnor agora inclui para paginação de resultados, permitindo que você obtenha subconjuntos de dados de forma eficiente e controlada.

Exemplo de uso

var pageIndex = 0;
var pageSize = 2;

var pagedUsers = CreateContext()
    .Query<User>()
    .Page(pageIndex, pageSize)
    .ToList();

🆕 Versão 1.0.10 - Novidade: Método para Inserção em Lotes

✨ O que há de novo?

A nova versão do Minnor agora inclui um método para inserção em lotes, permitindo inserir várias entidades de uma só vez com performance otimizada.

Exemplo de uso

var lista = new List<MinhaClasse>
    {
        new MinhaClasse { Nome = "Item 1", Valor = 100 },
        new MinhaClasse { Nome = "Item 2", Valor = 200 }
    };

var results = context.InsertRange<MinhaClasse>(lista);

🆕 Versão 1.0.9 - Correções e Melhorias

🆕 Versão 1.0.8 - Novidade: Método FirstOrDefault com Suporte a Expressões Lambda

✨ O que há de novo?

A nova versão do Minnor introduz o método FirstOrDefault, que permite recuperar o primeiro registro de uma entidade diretamente com um predicado opcional.

Agora ficou mais simples buscar um único item da base de dados com performance e clareza, sem necessidade de carregar listas inteiras ou escrever SQL manualmente.

Exemplo de uso

// Retorna o primeiro usuário com Id = 2
var usuario = context.Query<Usuario>()
    .FirstOrDefault(u => u.Id == 2);

// Retorna o primeiro usuário da tabela
var primeiroUsuario = context.Query<Usuario>()
    .FirstOrDefault();

⚙️ Como funciona?

• Traduz o predicado para SQL usando SqlExpressionVisitor.

• Gera dinamicamente o SELECT TOP 1 com as colunas da entidade.

• Executa o comando diretamente via SqlCommand e popula a instância da entidade.

• Ignora propriedades de navegação/coleções no mapeamento.

🆕 Versão 1.0.7 - Correções e Melhorias

🆕 Versão 1.0.6 - Novidade: Suporte a Transações

✨ O que há de novo?

• ✅ Suporte completo a transações com o MinnorContext

Exemplo de uso

try
{
    context.BeginTransaction();

    context.Insert(new Usuario { Nome = "Maria" });
    context.Insert(new Pedido { UsuarioId = 1, Valor = 150 });

    context.Commit(); // Salva as alterações no banco
}
catch
{
    context.Rollback(); // Cancela tudo se houver erro
}

🆕 Versão 1.0.5 - Novidade: Suporte a Injeção de Dependências

✨ O que há de novo?

• ✅ Suporte completo à injeção de dependência (DI) com IServiceCollection
• ✅ Registro fluente via AddMinnor(...)
• ✅ Facilita o uso do MinnorContext em projetos ASP.NET Core, Worker Services e outros projetos baseados em DI.
• ✅ Suporte completo à injeção de dependência (DI) com IServiceCollection
• ✅ Registro fluente via AddMinnor(...)
• ✅ Facilita o uso do MinnorContext em projetos ASP.NET Core, Worker Services e outros projetos baseados em DI.

Exemplo de uso

Para registrar o MinnorContext no seu projeto, basta adicionar o seguinte código no método ConfigureServices da sua classe Startup:

builder.Services.AddMinnor(options =>
{
    options.ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection");
});

Na sua classe de serviço:

public class ClienteService
{
    private readonly MinnorContext _context;

    public ClienteService(MinnorContext context)
    {
        _context = context;
    }

    public void CriarCliente()
    {
        var cliente = new Cliente { Nome = "Maria" };
        _context.Insert(cliente);
    }
}

🆕 Versão 1.0.4 - Novidade: Suporte a Queries SQL Personalizadas

✨ O que há de novo?

A nova versão do Minnor agora permite executar queries SQL personalizadas diretamente no ORM. Com isso, você tem total controle sobre a consulta executada, o que é ideal para:

• Consultas complexas
• Uso de JOIN, GROUP BY, HAVING, ORDER BY
• Subqueries e CTEs
• Chamadas a views e stored procedures
• Projeções específicas em DTOs ou tipos anônimos

✅ Exemplo de uso

Você pode fornecer a query completa como string e informar o tipo de retorno esperado (entidade ou DTO):

var resultado = context.Query<PedidoDTO>().CustomQuery(
    "SELECT p.Id, p.Data, c.Nome AS ClienteNome " +
    "FROM Pedidos p INNER JOIN Clientes c ON c.Id = p.ClienteId"
).ToList();

public class PedidoDTO
{
    public int Id { get; set; }
    public DateTime Data { get; set; }
    public string ClienteNome { get; set; }
}

⚙️ Como funciona?

• O método Query<T>(string sql) executa a string SQL diretamente.

• O ORM faz o mapeamento automático dos resultados para o tipo informado (T).

• Ideal para retornos personalizados fora do modelo padrão das entidades mapeadas.

🆕 Versão 1.0.3 - Novidade: Suporte a Includes nos Selects

✨ O que há de novo?

A nova versão do Minnor agora oferece suporte à funcionalidade de Includes, permitindo carregar entidades relacionadas em uma única consulta, simplificando o mapeamento de relações entre entidades (por exemplo, 1:1, 1:N e N:N).

Essa funcionalidade é especialmente útil para cenários onde você deseja evitar múltiplas chamadas ao banco de dados ao trabalhar com relacionamentos.

✅ Exemplo de uso

Suponha que você tenha as seguintes classes:

public class User
{
    public int Id { get; set; }

    public string Email { get; set; }

    public string Senha { get; set; }

    public string Nome { get; set; }

    public ICollection<Document> Documents { get; set; } = new List<Document>();
}

public class Document
{
    public int Id { get; set; }
    public string DocumentNumber { get; set; }
    [ForeignKey("User")]
    public int UserId { get; set; }
    public virtual User User { get; set; }
}

Agora você pode fazer:

var users = orm.Query<User>()
                   .Include(d => d.Documents)
                   .ToList();

Essa chamada irá automaticamente incluir os Documentos para cada Usuario retornado.

⚙️ Como funciona?

O método Include permite que você especifique propriedades de navegação que devem ser carregadas junto com a entidade principal.

A funcionalidade utiliza internamente JOINs automáticos baseados nos atributos de chave estrangeira definidos na sua modelagem de classes.

🚀 Principais Recursos

• 🔍 Consultas SQL simplificadas com mapeamento automático
• 🧩 Suporte a expressões lambda
• 🧠 Convenções inteligentes para inferência de chaves primárias
• 🏗️ Arquitetura modular e extensível

📦 Instalação

Adicione o pacote ao seu projeto .NET:

Install-Package Minnor.Core