Jarvis.EntityFrameworkCore 3.0.1.2

Jarvis.EntityFrameworkCore

Biblioteca de extensões para Entity Framework Core com tratamento de erros automático, operações CRUD simplificadas e suporte a exclusão lógica (soft delete).

Instalação

dotnet add package Jarvis.EntityFrameworkCore

DbUpdateResponse

Todas as operações de escrita retornam um DbUpdateResponse com o status da operação.

var response = context.AddAndSave(produto);

if (response.IsSuccess)
{
    // sucesso
}

if (response.IsError)
{
    // response.Exception contém a exceção
}

Consultas (DbContext e DbSet)

Todos os métodos de consulta possuem tratamento de exceção automático, retornando null em caso de erro.

Find

// Por DbContext
var produto = context.Find<Produto>(id);
var produto = await context.FindAsync<Produto>(id);

// Por DbSet
var produto = context.Produtos.Find(id);
var produto = await context.Produtos.FindAsync(id);

FirstOrDefault

var produto = context.FirstOrDefault<Produto>();
var produto = context.FirstOrDefault<Produto>(x => x.Ativo);
var produto = await context.FirstOrDefaultAsync<Produto>(x => x.Nome == "Teste");

All (IQueryable)

var produtos = context.All<Produto>();
var ativos = context.All<Produto>(x => x.Ativo);

AllAsEnumerable

var produtos = context.AllAsEnumerable<Produto>();
var ativos = context.AllAsEnumerable<Produto>(x => x.Ativo);

AllAsAsyncEnumerable

var produtos = context.AllAsAsyncEnumerable<Produto>();
var ativos = context.AllAsAsyncEnumerable<Produto>(x => x.Ativo);

Find em IQueryable

Busca por chave primária em qualquer IQueryable<T>. Detecta a chave via [Key] ou propriedade Id.

var produto = await context.All<Produto>(x => x.Ativo).Find(id);

Inserção

Cada método possui três variantes: sem save, com save síncrono (AndSave) e com save assíncrono (AndSaveAsync).

// Adicionar sem salvar
context.Add(produto);

// Adicionar e salvar
context.AddAndSave(produto);
var response = await context.AddAndSaveAsync(produto);

// Adicionar vários
context.AddRange(listaProdutos);
context.AddRangeAndSave(listaProdutos);
await context.AddRangeAndSaveAsync(listaProdutos);

Atualização

A entidade deve estar rastreada (tracked) pelo contexto. O update salva as alterações detectadas pelo change tracker.

produto.Nome = "Novo Nome";

context.UpdateAndSave(produto);
var response = await context.UpdateAndSaveAsync(produto);

// Atualizar vários
context.UpdateRangeAndSave(listaProdutos);
await context.UpdateRangeAndSaveAsync(listaProdutos);

Remoção

Remoção física

context.RemoveAndSave(produto);
var response = await context.RemoveAndSaveAsync(produto);

Exclusão lógica (Soft Delete)

Define a propriedade Ativo como false (por padrão) ou uma propriedade customizada.

// Usando a propriedade "Ativo" (padrão)
context.LogicalRemoveAndSave(produto);
await context.LogicalRemoveAndSaveAsync(produto);

// Usando uma propriedade customizada
context.LogicalRemoveAndSave(produto, x => x.Habilitado);
await context.LogicalRemoveAndSaveAsync(produto, x => x.Habilitado);

Limpar tabela

Remove todos os registros de uma tabela.

context.ClearAndSave<Produto>();
await context.ClearAndSaveAsync<Produto>();

Save

var response = context.Save();
var response = await context.SaveAsync();

Metadados

// Nome da tabela no banco
var tableName = context.GetTableName<Produto>();

// Nome da coluna no banco
var columnName = context.GetColumnName<Produto>(x => x.Nome);

Change Tracking (EntityEntry)

Extensões para trabalhar com o change tracker do EF Core.

// Obter entradas modificadas
var modified = context.GetModifiedEntries();

// Obter/definir valores de propriedades
foreach (var entry in modified)
{
    var nome = entry.GetPropertyValue("Nome");
    entry.SetPropertyValue("DataAlteracao", DateTime.Now);

    var prop = entry.GetProperty("Nome");
    // prop.CurrentValue, prop.OriginalValue, prop.IsModified
}

DbSet vs DbContext

Todos os métodos estão disponíveis tanto como extensão de DbContext quanto de DbSet<T>:

// Via DbContext
context.Find<Produto>(id);
context.AddAndSave(produto);

// Via DbSet
context.Produtos.Find(id);
context.Produtos.AddAndSave(produto);