Repositório que demonstra a criação de um projeto asp.net core através do CLI e conectando a um banco de dados My SQl utilizando Dapper e .net Core.
Repositório base para o seguinte artigo: aqui.
- .Net Core 2.1
- Visual Studio Code / Visual Studio 2017
- Docker/Docker-compose (Instruções de instalação)
Visando as melhores práticas para desenvolvimento de uma API, este projeto conta com as seguintes tecnologias:
- Dapper - Biblioteca do StackOverflow que possui um mecanismo simples de execução de comandos em um banco de dados, mapeando, de forma otimizada, objetos do banco em classes no projeto;
- Swagger - Biblioteca que gera um site, com capacidade de testar a API online e exibe a documentação de cada método dos controllers;
- MySqlConnector - Library utilzada para conexão com uma base de dados MySql
Para facilitar a execução da API de forma independente de instalações de base de dados, foi adicionao ao repositório um pasta denominada Database e um arquivo docker-compose-mysql.yml.
- Database - esta pasta contém um arquivo, script_inicial.sql, que será executado quando o container da imagem MySql for isntanciado. Neste aquivo apenas existe um script para criação de uma tabela e alguns registros.
- docker-compose-mysql.json - Arquivo de composição docker para facilitar orquestrar a execução do container do MySQl com alguns parâmetros(variáveis de ambiente), contendo informações como usuário, senha e volumes.
Para executar a aplicação é necessário a execução do container MySql.
Primeiramente execute o seguinte comando:
docker-compose -f docker-compose-mysql.yml up -d
Este comando executan um container com base no descritivo do arquvo de composição.
Após o container iniciado, execute o comando:
dotnet run
Se desejar fechar o container após a execução, digite o comando:
docker-compose -f docker-compose-mysql.yml down
Se já possuir um banco de dados MySql e deseja utilizá-lo na aplicação, modifique a string de conexão no arquivo appsettings.json, no trecho indicado:
...
"ConnectionStrings": {
"MySqlDbConnection": "server=localhost;database=MyFirstAPI;user id=root;password=p@ssw0rd"
},
...
O script para criação da tabela do exemplo e alguns dados iniciais encontra-se na pasta Database.
Maiores informações consultar o artigo: https://wp.me/p7SQs9-9B