Como fazer um Mapeamento Objeto-Relacional no Entity Framework

#PraCegoVer - Transcriç�o dos Slides O que � Mapeamento Objeto-Relacional?
As classes da aplicaç�o s�o mapeadas para as tabelas do banco
Os objetos s�o mapeados como linhas da tabela

Ir para o c�digo

O que � Mapeamento Objeto-Relacional?

ORM (Object-Relational Mapping) � uma t�cnica que consiste da convers�o das classes da aplicaç�o para tabelas do banco de dados e vice-versa. Da mesma forma, tamb�m faz parte desse processo a convers�o entre os objetos da aplicaç�o e as linhas da tabela. Ou seja, enquanto no c�digo trabalhamos com classes e objetos, esses s�o gravados e recuperados do banco de dados na forma de registros/linhas.

Quando efetuamos esse processo manualmente, cabe a n�s ler as linhas e colunas da tabela e preencher objetos e suas propriedades. No entanto, no .NET framework (assim como em outras linguagens) temos � disposiç�o frameworks que se encarregam desse processo. Dessa forma, podemos trabalhar apenas com classes e objetos, sem escrever instruç�es SQL, e o framework faz todas as convers�es necess�rias para n�s.

Neste microexemplo utilizaremos o Entity Framework, que � o principal framework ORM do ecossistema .NET. Confira abaixo o passo a passo de como proceder para efetuar seu primeiro Mapeamento Objeto-Relacional em C#. Para demonstrar esse processo partiremos de um projeto do tipo Console Application criado no Visual Studio.

Passo 1: Criar a classe de dom�nio

Normalmente em nossos sistemas precisaremos representar elementos do mundo real envolvidos no problema que queremos resolver com esse software. Por exemplo, em um sistema de automaç�o comercial precisaremos representar entidades como Cliente, Produto, Fornecedor, etc. Essas s�o nossas classes de dom�nio.

Neste microexemplo criaremos uma classe chamada Cliente a partir da qual vamos persistir dados em uma tabela chamada Clientes no banco de dados. O c�digo dessa classe pode ser visto abaixo:

class Cliente
{
public int Id { get; set; }
public string Nome { get; set; }
public int Idade { get; set; }
public decimal Credito { get; set; }
}

A propriedade Id ser� usada como chave prim�ria da tabela que ser� gerada no banco. Essa nomenclatura � >reconhecida por padr�o pelo Entity Framework e em seu lugar poderia ser usado ClienteId;

Note que toda propriedade possui os m�todos get e set, definidos de forma padr�o/vazia. Isso � necess�rio para que o Entity Framework possa preencher essa propriedade dinamicamente com os dados vindos do banco.

Passo 2: Instalar o Entity Framework

O segundo passo para utilizar o Entity Framework � instal�-lo em nossa aplicaç�o atrav�s do NuGet, que � o gerenciador de pacotes do ambiente .NET. Para fazer isso, clique com a direita sobre o projeto no Visual Studio e em seguida acesse o menu Manage NuGet Packages, como vemos na Figura 1.

Figura 1. Acessando o NuGet

Em seguida busque por EntityFramework e instale o pacote de mesmo nome, como ilustra a Figura 2.

Figura 2. Instalando o pacote EntityFramework

A partir de agora poderemos usar as classes do framework para acessar o banco de dados.

Passo 3: Criar o DbContext

DbContext � uma classe central do Entity Framework. Ela representa uma abstraç�o do banco de dados dentro da aplicaç�o e � por meio dela que acessamos as tabelas (na forma de listas) e os registros (na forma de objetos).

Precisamos ent�o criar uma nova classe que herdar� de DbContext e aqui se chamar� ClientesContext, como podemos ver a seguir:

Nota: Convenciona-se nomear essa classe com o sufixo Context, uma vez que ela herda de DbContext, mas essa nomenclatura n�o � obrigat�ria.


01 class ClientesContext:DbContext
02 {
03 public ClientesContext():base("BancoClientes")
04 {
05 }
06 
07 public DbSet<Cliente> Clientes { get; set; }
08 }

Linha 1: A classe deve herdar de DbContext, que pertence ao namespace System.Data.Entity e deve ser importado por meio da diretiva using;

Linha 3: Aqui invocamos o construtor da classe pai, passando como par�metro o nome da string de conex�o na qual essa classe encontrar� as informaç�es necess�rias para se conectar ao banco de dados;

Linha 7: Aqui temos a definiç�o da propriedade Clientes, que representar� a tabela de mesmo nome no banco de dados. A classe DbSetrepresenta uma coleç�o de objetos que ser� mapeada como registros do banco de dados.

Nota: O nome da tabela que ser� gerada no banco depende do nome da classe (Cliente) e n�o da propriedade DbSet (Clientes). Por padr�o o Entity Framewok pluraliza o nome da classe para gerar a tabela (seguindo o padr�o do ingl�s).

Passo 4: Criar a string de conex�o

Como vimos anteriormente a classe ClientesContext faz refer�ncia � string de conex�o chamada �BancoClientes�. A string de conex�o, ou connection string, define as informaç�es necess�rias para conectar com o banco de dados. Por padr�o ela � definida no arquivo App.config ou Web.config, da seguinte forma:


01 <?xml version="1.0" encoding="utf-8"?>
02 <configuration>
03 <!-- demais elementos do XML -->
04 <connectionStrings>
05 <add name="BancoClientes"
06 connectionString="Data Source=.\SQLExpress;
07 Initial Catalog=DbClientes;
08 Integrated Security=True;"
09 providerName="System.Data.SqlClient" />
10 </connectionStrings>
11 </configuration>

Linha 4: As connection strings de uma aplicaç�o devem estar dentro da seç�o connectionStrings no XML;

Linha 5: Cada string de conex�o � criada com o elemento add, que possui v�rios atributos: name (o nome dessa string, que � o mesmo referenciado na classe DbContext), connectionString (a sequ�ncia de informaç�es para acessar o banco - servidor, nome do banco e modo de autenticaç�o) e providerName (a biblioteca de classes respons�vel por prover ao Entity Framework o acesso ao banco - nesse caso usamos a biblioteca do ADO.NET para SQL Server).

A partir de agora a classe ClientesContext j� tem as informaç�es necess�rias para acessar o servidor do SQL Server, criar o banco e criar a tabela Clientes. Ent�o podemos us�-la para gravar nosso primeiro registro, como veremos a seguir.

Passo 5: Gravar dados no banco

Agora que nossa aplicaç�o j� est� configurada para efetuar o Mapeamento Objeto-Relacional, podemos criar um novo cliente e grav�-lo no banco de dados. Para isso utilizaremos o m�todo Main da classe Program, da seguinte forma:


01 static void Main(string[] args)
02 {
03 Cliente cli = new Cliente
04 {
05 Nome = "Joel",
06 Credito = 900,
07 Idade = 24
08 };
09
10 ClientesContext db = new ClientesContext();
11 db.Clientes.Add(cli);
12 db.SaveChanges();
13
14 Console.WriteLine("Cliente salvo com sucesso.");
15 Console.ReadKey();
16 }

Linhas 3 a 8: Criamos um objeto do tipo Cliente e preenchemos seus dados. Note que n�o preenchemos o Id, pois ele ser� gerado pelo banco de dados automaticamente;

Linhas 10 a 12: Instanciamos a classe ClientesContext e a partir dela adicionamos o novo cliente � lista e salvamos a operaç�o com o m�todo SaveChanges;

Linhas 14 e 15: Imprimimos uma mensagem no console e aguardamos o pressionamento de uma nova tecla para finalizar a aplicaç�o.

Se executarmos a aplicaç�o agora veremos que o banco de dados ser� criado no SQL Server, bem como a tabela de Clientes e o registro ser� inserido. Isso tudo foi feito utilizando poucas linhas de c�digo e sem escrever instruç�es SQL, graças ao Mapeamento Objeto-Relacional feito pelo Entity Framework.