Jarvis.DAO 1.0.2.3

Jarvis.DAO

Camada DAO (Data Access Object) para Entity Framework Core com exclusão lógica automática, timestamps de alteração/exclusão e registro simplificado via injeção de dependência.

Instalação

dotnet add package Jarvis.DAO

Configuração

Registre o DAO no Program.cs informando a implementação do seu DbContext:

builder.Services.AddJarvisDAO<AppDbContext>();

O lifetime padrão é Scoped. Para alterar:

builder.Services.AddJarvisDAO<AppDbContext>(ServiceLifetime.Transient);

Uso

Injete JarvisIDAOContext no construtor do seu serviço ou controller:

public class ProdutoService(JarvisIDAOContext dao)
{
    public async Task<Produto> Buscar(int id)
    {
        return await dao.Find<Produto>(id);
    }
}

Consultas

Find

Busca por chave primária:

var produto = await dao.Find<Produto>(id);

List (com filtro de exclusão lógica)

Retorna apenas registros ativos. Se a entidade possuir a propriedade Ativo, filtra automaticamente por Ativo == true. Caso contrário, retorna todos.

var produtos = dao.List<Produto>();

All (sem filtro)

Retorna todos os registros, incluindo inativos:

var todos = dao.All<Produto>();

Inserção

var response = await dao.Add(produto);
var response = await dao.AddRange(listaProdutos);

Atualização

produto.Nome = "Novo Nome";
var response = await dao.Update(produto);
var response = await dao.UpdateRange(listaProdutos);

Remoção (Exclusão Lógica)

O método Remove define Ativo = false automaticamente. Não remove fisicamente o registro.

var response = await dao.Remove(produto);
var response = await dao.RemoveRange(listaProdutos);

Remoção em coleções

Para marcar itens de uma coleção como inativos sem salvar:

produto.Itens.Remove();
await dao.SaveAsync();

Timestamps Automáticos

Em operações de escrita (Add, Update, Remove), o DAO atualiza automaticamente:

• DataAlteracao → DateTime.UtcNow em toda entidade modificada
• DataExclusao → DateTime.UtcNow quando Ativo é definido como false

Basta que a entidade possua essas propriedades.

Acesso ao DbContext

Para acessar o DbContext original:

var db = dao.DatabaseContext<AppDbContext>();

Com interface de serviço:

var db = dao.DatabaseContext<IAppDbContext, AppDbContext>();

DbUpdateResponse

Todas as operações de escrita retornam DbUpdateResponse:

var response = await dao.Add(produto);

if (response.IsSuccess)
{
    // sucesso
}

if (response.IsError)
{
    // response.Exception contém o erro
}