Introdução ao ADO.NET Entity Framework 4.1

Recentemente foi lançada a versão final do Entity Framework 4.1, que é uma atualização para o Entity Framework 4.0 que acompanha o Visual Studio 2010 e pode ser baixado aqui .

Entre as novidades dessa atualização, destaca-se as seguintes:

DbContext API - Uma abstração simplicada sobre o ObjectContext e uma série de outros tipos que foram introduzidos nas versões anteriores do Entity Framework. A API do DbContext é otimizada para as tarefas mais comuns e foi desenhada para suportar alguns padrões de código muito comuns como "Repository Pattern" e "Unit Of Work Pattern". Pode ser tanto utilizado da maneira tradicional "Database First" em que o banco de dados já existe, "Model First" onde se cria o modelo conceitual que irá gerar o script para criação do banco de dados e a novidade desta versão que é o "Code First" onde classes "POCO" são mapeadas para as entidades.

Code First é um novo padrão de desenvolvimento incluído no Entity Framework 4.1 que provê uma alternativa para os padrões já existentes "Database First" e "Model First". O padrão "Code First" foca na modelagem baseada em classes planas que serão mapeadas a um banco de dados existente ou novo. As configurações adicionais podem ser fornecidas utilizando atributos "Data Anotations" ou via API fluente.

Nessa atualização, os seguintes recursos ainda não foram implementados e devemos aguardar as futuras versões:

* Suporte a ENUM

* Mapeamento de Stored Procedures (permite apenas invocá-las)

* Suporte a migração (geração de scripts para atualizar o banco de dados devido a alterações no modelo)

* Convenções customizadas para o "Code First".

Exemplo de utilização do EF 4.1 com Code First.

Trabalhar com Code First é muito simples. Vou ilustrar usando um cenário simples, onde possuímos 3 tabelas no banco de dados: Cidades, Estados, Paises e seus relacionamentos. Após isso vamos fazer algumas consultas e edições.

Após instalada a atualização (ver link no início do post), crie um novo projeto do tipo de sua preferência, no meu caso criei uma aplicação ASP.NET vazia. Será necessário adicionar as seguintes referências:

* System.ComponentModel.DataAnnotations

* EntityFramework (C:\Program Files\Microsoft ADO.NET Entity Framework 4.1\Binaries\EntityFramework.dll)

Crie uma nova pasta chamada Model e adicione as classes conforme código abaixo:

Observações: O Code-First utiliza algumas convenções para o mapeamento com o banco de dados. Por exemplo, toda a propriedade com o nome "Id" automaticamente é considerada o campo chave (Primary Key) no banco de dados. 

Na classe Cidade, temos uma propriedade do tipo virtual indicando que um tipo complexo (no caso Estado) tem um relacionamento por chave estrangeira (ForeignKey). O EF utilizará esta propriedade para "navegação", (Cidade.Estado.Nome).

Na classe Estado, temos uma propriedade virtual do tipo ICollection. Essa propriedade indica um relacionamento um-para-muitos (One-To-Many), ou seja, para cada Estado, há muitas cidades. Também possui uma propriedade complexa chamada Pais, para indicar o relacionamento entre o Estado e o País.

Na classe Pais, temos uma coleção de Estados.

Através de convenções, o EF realiza o mapeamento praticamente automático dos relacionamentos e propriedades de navegação.

Assim como no Entity Framework 4.0, para acessarmos o banco de dados é necessário utilizar um contexto. Um contexto é um objeto que agrupa várias entidades (tabelas). No caso do "Code First", precisamos criar uma classe que herda de "DbContext" e referenciar essas classes que criamos. Adicione mais uma classe conforme  a figura abaixo:

Nesse momento já possuímos um contexto para ser instanciado e utilizado dentro da aplicação. As propriedades públicas do tipo DbSet disponibilizam acesso às tabelas do banco de dados.

Um recurso interessante que encontramos no CodeFirst é o inicializador. Podemos criar uma classe para inicialização do banco de dados e definir se queremos excluí-lo e cria um novo, por exemplo, alimentando com algumas informações iniciais.

Acho interessante mostrar como funciona esse recurso agora, já que ainda não temos um banco de dados fisicamente criado. O EF irá criar um banco de dados novo em sua estação, de acordo com o nome que colocamos no construtor da classe de contexto, já que até esse ponto ainda não configuramos uma string de conexão no arquivo web.config.

E já que o banco de dados é novo, "zerado", sem registros, vamos alimentá-lo na sua inicialização.

Para isso, crie uma classe chamada MyInitializer conforme a figura mostrada abaixo:

Esta classe implementa uma interface do Entity Framework, chamada IDatabaseInitializer<T> em que passamos como parâmetro genérico a nossa classe "Context" que herdou de DbContext.

O local recomendado para instanciar esta classe é no arquivo Global.asax. Para isso, adicione este arquivo no projeto e faça conforme a figura abaixo:

Repare que criei um parâmetro do tipo bool no construtor da classe MyInitializer. Esse parâmetro, caso seja true, fará com que o banco de dados seja excluído caso exista, recriado novamente em seguida alimentado com alguns objetos (uma cidade, um estado e um país). Antes que a aplicação seja colocada em produção, obviamente esse parâmetro será falso. No nosso caso, como será a primeira execução da aplicação em que o banco de dados não existe, coloque como true.

Ao executar a aplicação web, nada será mostrado, apenas o banco de dados será criado.

Vamos criar uma página Default.aspx e colocar o seguinte código para testar.

Quando a página for carregada, será criado um novo contexto. Nesse momento o EF não gerou nenhuma consulta SQL. A consulta será realizada na linha a seguir, dentro do laço foreach, ao acessar a propriedade Cidades. Para fins de demonstração, apenas imprimi no Response da página o nome da cidade, que deverá ser "Campo Grande", conforme adicionamos na classe MyInitializer.

Conclusão

Nesse post, mostrei alguns recursos básicos na utilização do EF 4.1 Code First. Se o feedback for positivo, mostrarei num próximo post alguns exemplos de mapeamentos mais complexos, com relacionamentos um-para-um e muitos-para-muitos e mais exemplos de operações CRUD (Create, Update, Delete)

Para quem se interessar, o projeto usado neste post pode ser baixado no link abaixo.

.PostPantanetEf41.rar