Agora que temos o suporte ao EF Core vamos criar as classes das entidades para a nossa aplicação.

Como nossa aplicação é bem simples e vai gerenciar informações de livros ela vai ter apenas uma entidade chamada Livro.

Vamos agora criar  a classe que representa a nossa entidade na pasta Models do projeto.

Nota: Você pode colocar classes do modelo em qualquer lugar em seu projeto, mas a pasta Models é usada por convenção.

As classes são criadas na pasta Models clicando com o botão direito sobre a pasta, selecionando New C# Classs e a seguir informando o nome da classe.

Vamos iniciar criando o arquivo Livro.cs e nele vamos definir a classe Livro conforme abaixo:

using System;

namespace mvclinux.Models
{
    public class Livro
    {
        public int Id { get; set; }
        public string Nome { get; set; }
        public string Autor { get; set; }
        public int PublicadoEm { get; set; }
    }
}

A propriedade Id será a coluna de chave primária da tabela de banco de dados que corresponde a essa classe. Por padrão, o Entity Framework interpreta uma propriedade que é chamada de ID ou nome_classeID como sendo a chave primária.(Podemos alterar esse comportamento com annotations)

Nota : O Entity Framework por padrão adota algumas convenções (Conventions) que ele usa para realizar algumas operações.

Criando a classe de contexto do Banco de dados

O Entity Framework permite consultar, inserir, atualizar e excluir dados, usando objetos CLR(Common Language Runtime) conhecidos como entidades; ele mapeia as entidades e relacionamentos que são definidos no seu modelo de entidades para um banco de dados e fornece facilidades para realizar as seguintes tarefas:

1- Materializar dados retornados do banco de dados como objetos de entidade;
2- Controlar as alterações que foram feitas nos objetos;
3- Lidar com concorrência;
4- Propagar as alterações feitas nos objetos de volta ao banco de dados;
5- Vincular objetos a controles.

A principal classe responsável pela interação com os objetos de dados é a classe System.Data.Entity.DbContext (muitas vezes referida como o contexto).

Essa classe de contexto administra os objetos entidades durante o tempo de execução, o que inclui preencher objetos com dados de um banco de dados, controlar alterações, e persistir dados para o banco de dados.

A maneira recomendada para trabalhar com o contexto é definir uma classe que deriva de DbContext e expõe as propriedades de DbSet que representam as coleções das entidades especificadas no contexto.

Essa classe é chamada de classe de contexto do banco de dados e coordena a funcionalidade do Entity Framework para um dado modelo de dados. No código dessa classe você especifica quais entidades estão incluídas no modelo de dados. Você também pode personalizar determinado comportamento do Entity Framework. Neste projeto, a nossa classe de contexto será chamada AppDbContexto.

Para simplificar eu vou criar essa classe na pasta Models. Então crie o arquivo AppDbContext.cs na pasta Models e a seguir inclua o código abaixo na classe AppDbContext:

using Microsoft.EntityFrameworkCore;

namespace mvclinux.Models
{
    public class AppDbContext : DbContext
    {
        public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
        {
        }
        public DbSet<Livro> Livros { get; set; }
    }
}

Este código cria uma propriedade DbSet para cada a entidade Livro. Na terminologia Entity Framework, um conjunto de entidades corresponde a uma tabela de banco de dados e uma entidade corresponde a uma linha na tabela.

Registrando o contexto com injeção de dependência

A ASP.NET Core implementa a injeção de dependência por padrão. Os serviços (como o contexto de banco de dados do EF) são registrados com injeção de dependência durante a inicialização do aplicativo. Componentes que requerem esses serviços (como controladores MVC) fornecem esses serviços através de parâmetros do construtor. Mais adiante iremos definir no construtor do controlador a instância do contexto.

Para registrar o nosso contexto AppDbContext como um serviço, abra o arquivo Startup.cs e adicione as linhas realçadas ao método ConfigureServices:

using Microsoft.EntityFrameworkCore;
using mvclinux.Models;
...
....

       // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            ...
            var connection = Configuration["ConexaoMySql:MySqlConnectionString"];
            services.AddDbContext<AppDbContext>(options =>
                options.UseMySql(connection)
            );

            // Add framework services.
            services.AddMvc();
        }
....

O nome da string de conexão é passada para o contexto pela chamada do método no objeto DbContextOptionsBuilder. Para o desenvolvimento local a ASP .NET Core obtém a string de conexão do arquivo appsettings.json.

Vamos então abrir o arquivo appsettings.json e adicionar a string de conexão conforme mostrado a seguir:

{
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "ConexaoMySql": {
    "MySqlConnectionString": "Server=localhost;DataBase=Livraria;Uid=root;Pwd=*******"
  }
}

A string de conexão especifica um banco de dados identificado pelo nome Livraria.

Nota: Informe um usuário e senha válidos para o seu ambiente.

Criando o banco de dados e tabela - Usando Migrations

Após definir o nosso modelo inicial representando pela classe Livro e definir o contexto na classe AppDbContext onde informamos o provedor do banco de dados usado, a string de conexão e o mapeamento da entidade para a tabela Livros, o EF Core tem todas as condições para criar o banco de dados Livraria e a tabela Livros usando o Migrations.

Usando o recurso Migrations do Entity Framework podemos realizar alterações em nosso modelo de entidades e ter a atualização automática do banco de dados refletindo essas mudanças.

Para aplicar o migrations vamos usar a ferramenta de linha de comando do EF Core digitando no terminal os seguintes comandos:

1. dotnet ef migrations add InitialCreate - Para suportar a migração e criar o conjunto inicial de tabelas para o modelo;

2. dotnet ef database update - Para aplicar a migração ao banco de dados;

Digitando o primeiro comando teremos o seguinte resultado:

Abrindo o projeto no VS Code, vemos a pasta Migrations criada no projeto contendo 3 arquivos:

Digitando o segundo comando no terminal temos o resultado abaixo:

Dessa forma já temos o banco de dados Livraria e a tabela Livros criados no MySQL no ambiente Linux.

Acessando o MySql podemos constatar a criação do banco de dados Livraria conforme figura a seguir:

Na próxima parte do artigo vamos criar o controller e as views para realizar o CRUD básico e gerenciar dados da tabela Livros.

"Jesus respondeu: Na verdade, na verdade te digo que aquele que não nascer da água e do Espírito, não pode entrar no reino de Deus."
João 3:5