Em primeiro lugar, é importante dizer que o Dapper funciona muito bem como um complemento ao Entity Framework. Usar apenas o Dapper na sua aplicação pode implicar em uma perda de produtividade, já que o Dapper não possui, por exemplo, carga preguiçosa, controle incremental de banco e geração dinâmica de SQL. Tudo fica a encargo do programador, que tem que escrever todas as sentenças de interface com o banco manualmente.
Para esta resposta, vou supor que você cogitará usar ambos. Não tem problema não usar, mas o desenvolvimento ficará mais trabalhoso e espero conseguir mostrar isso aqui.
Tendo isto em mente, podemos escrever um guia rápido para o Dapper.
Usando com o Entity Framework
O Dapper é basicamente uma biblioteca que estende IDbConnection
. Começando um novo projeto com Entity Framework, usar o Dapper é bastante simples:
using Dapper;
private EntityFrameworkContext context = new EntityFrameworkContext();
...
db.Database.Connection.Query(); // Query já é um dos métodos do Dapper.
Selecionando
Vou usar Pais
para o exemplo.
Um País
var umPais = context.Database.Connection.Query<Pais>("select * from Paises where PaisId = @Id", new { Id = 1 }).FirstOrDefault();
Todos os Países
var todosOsPaises = context.Database.Connection.Paises.Query<List<Pais>>("select * from Paises");
Joins
Vou usar agora Estado
e Pais
:
var sql = @"select e.EstadoId, e.Nome, e.Sigla, e.PaisId, p.PaisId, p.Nome, p.Sigla
from Estados e
inner join Paises p on e.PaisId = p.PaisId";
var estadosEPaises = db.Database.Connection
.Query<Estado, Pais, Estado>(sql,
(e, p) => {
e.Pais = p;
return e;
},
splitOn: "PaisId");
Inserindo
var resultadosAfetados = db.Database.Connection.Execute("insert into Paises (Nome, Sigla) values (@Nome, @Sigla)", new { Nome = "Brasil", Sigla = "BR" });
Dá pra inserir vários:
var resultadosAfetados = db.Database.Connection.Execute("insert into Paises (Nome, Sigla) values (@Nome, @Sigla)", new[] { { Nome = "Brasil", Sigla = "BR" }, { Nome = "Portugal", Sigla = "PT" } });
Atualizando
Mesma coisa:
var resultadosAfetados = db.Database.Connection.Execute("update Paises set Nome = @Nome where Sigla = @Sigla", new { Nome = "Brazil", Sigla = "BR" });
Excluindo
Preciso colocar?
Facilitando
Escrever métodos de inserção, exclusão, etc., pode ser bem tedioso, então a equipe do Dapper criou um método que faz não ser necessário escrever inserções e atualizações:
using Dapper.Contrib.Extensions;
public void Persistir(IDbConnection connection, Usuario usuario)
{
if (usuario.UsuarioId == null) {
SqlMapperExtensions.Insert(connection, usuario);
}
else {
SqlMapperExtensions.Update(connection, usuario);
}
}
Vi que existe um Dapper.EntityFramework no fonte do Dapper. Por que você não usa?
Porque ele contém apenas duas tipagens para trabalhar adequadamente com coordenadas geográficas e geométricas. Tem pouca utilidade nos exemplos que fazem parte da pergunta.