AspNet6InDepth

Aprendendo ASP.NET 6 em profundidade

1. Visão geral do ASP.NET 6

   • História e história de fundo
   • Estratégia de versionamento
   • Instalação
   • Estrutura do projeto
   • SDK do .NET

2. Fundamentos do ASP.NET 6

   • Aplicativo API Scaffold ASP.NET 6 usando .NET SDK
   • Analisando o arquivo Program.cs
   • Injeção de dependência
     • Registre o objeto como tempo de vida singleton
     • Registrar objeto como tempo de vida com escopo definido
     • Registrar objeto como tempo de vida transitório
   • Middlewares
     • Visão geral
     • Faça middlewares personalizados
       • Implementando a interface IMiddleware
       • Injetando o objeto RequestDelegate
       • Escreva middlewares embutidos usando app.Use , app.Map , app.MapWhen , app.UseWhen e app.Run
     • Middleware de arquivos estáticos app.UseStaticFiles();
     • Middleware CORS app.UseCors();
     • Adicionar middleware Correlationid
     • Adicione middleware de exceção global não tratada e retorne a resposta padrão ProblemDetails
   • Host de configuração
   • Configurações
     • Leia as configurações de appsettings.{environment}.json e da interface IConfiguration
     • Padrão de opções
       • Vincule a configuração ao C# POCO fortemente tipado usando a interface IOptions<T>
       • Configuração de vinculação que pode ser recarregada em tempo de execução para C# POCO fortemente tipado usando a interface IOptionsSnapshot<T> ou IOptionsMonitor<T>
   • Noções básicas sobre HttpContext , HttpContext.Request e HttpContext.Response
   • Roteamento de atributos
     • Vincule várias rotas a um controlador usando o atributo Route
     • Passe parâmetros para métodos de ação usando parâmetros de rota
     • Verbos de ação HttpGetAttribute , HttpPostAttribute , HttpPutAttribute , HttpPatchAttribute e HttpDeleteAttribute
   • Vinculação de modelo
     • Associação de modelo das seguintes fontes
       • FromQuery : obtém valores da string de consulta
       • FromRoute : obtém valores dos dados da rota
       • FromForm : Obtém valores de campos de formulário postados
       • FromBody : Obtém valores do corpo da solicitação
       • FromHeader : obtém valores de cabeçalhos HTTP
   • Lidar com respostas usando IActionResult<T> ou ActionResult<T>
   • Lidar com a negociação de conteúdo usando o cabeçalho Accept
     • Enviar resposta XML se o cabeçalho Accept estiver definido como application/xml
     • Enviar resposta JSON se o cabeçalho Accept estiver definido como application/json
   • Versionamento em API(s) .NET6
   • Lidar com solicitações do tipo HTTP Patch
   • Validação de modelo
     • Usando atributos de anotação de dados
       • Compare : valida se duas propriedades em um modelo correspondem.
       • EmailAddress : Valide se uma propriedade possui formato de email.
       • Phone : Valide se um imóvel possui formato de número de telefone.
       • Range : valide se o valor de uma propriedade estiver dentro de um intervalo especificado.
       • RegularExpression : valida se um valor de propriedade corresponde a uma expressão regular especificada.
       • Required : valide se um campo não for nulo.
       • StringLength : valida se o valor de uma propriedade de string não excede um limite de comprimento especificado.
       • Url : Valide se uma propriedade possui formato de URL.
     • Validação FluentValidation usando métodos Fluent
   • Cliente HTTP
     • Criando IHttpClientFactory básico usando IHttpClientFactory.CreateClient();
     • Nomeado HttpClient
     • HttpClient digitado
     • Adicione DelegatingHandler a clientes HTTP para executar lógica comum
     • Lidar com exceções HTTP usando a biblioteca Polly
   • Filtros
   • Comprimir corpo de resposta
     • Adicione compactação de resposta usando o algoritmo gzip
   • Globalização e localização
   • Limitação de taxa
     • Limitação de taxa usando pacote nuget AspNetCoreRateLimit com provedor de memória.
     • Limitação de taxa usando o pacote AspNetCoreRateLimit e AspNetCoreRateLimit.Redis com o provedor Azure Cache para Redis.
   • Registro
     • Noções básicas sobre níveis de log
     • Registrar usando métodos de extensão ILogger<T>
       • Mensagens de nível de rastreamento de log logger.LogTrace
       • logger.LogDebug mensagens de nível de depuração de log
       • logger.LogInformation mensagens de nível de informações de log
       • logger.Warning mensagens de nível de aviso de log
       • logger.Error mensagens de nível de erro de log
       • logger.Critical log mensagens de nível crítico
     • Registrar usando o SDK Azure AppInsights
   • Serviços hospedados
     • Implementar serviços hospedados usando a interface IHostedService
     • Implemente serviços em segundo plano substituindo a classe BackgroundService
   • Mapeando objetos de um tipo para outro usando o pacote Nuget do Automapper
   • Padrão mediador
     • Implementar serviços fracamente acoplados usando o pacote nuget MediatR
   • Arrogância
     • Instale o nuget Swashbuckle.AspNetCore para adicionar suporte Swagger OpenAPI
     • Adicione informações e descrição da API
     • Adicionar tags de resumo para metadados no nível da API
     • Adicionar OperationIds às APIs do grupo
     • Enriquecer metadados de operação
     • Enriquecer metadados de resposta
     • Enriquecer metadados de parâmetros
     • Enriquecer os metadados do RequestBody
     • Enriquecer metadados de esquema
     • Adicionar metadados de tag
     • Alterar o prefixo da rota swagger para servir swagger.json no nível raiz
     • Omitir API(s) para ficarem visíveis no Swagger
     • Gere vários documentos Swagger
   • Verificações de saúde

3. Acesso a dados no aplicativo API ASP.NET 6

   • Acesso a dados usando Micro ORM Dapper e PostgreSQL

     • Instale o Npgsql
     • Instale o Dapper Micro ORM
     • Instale o Azure Data Studio
     • Configurar a Base de Dados Azure para PostgreSQL
     • Exponha API(s) CRUD usando Dapper MicroORM expondo os seguintes endpoints
       • Paginação de deslocamento /api/Persons?page=1&limit=10
       • Paginação do conjunto de chaves /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Obtenha solteiro por id /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Criar /api/Persons
       • Atualizar /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Excluindo /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • Acesso a dados usando EF Core 6 ORM e PostgreSQL

     • Instale o EF Core 6
     • Instale o Azure Data Studio
     • Configurar a Base de Dados Azure para PostgreSQL
     • Adicione DbSet<T> às tabelas de modelo no banco de dados
     • Analisar DbContext
     • Faça um padrão de repositório com métodos de extensão DbContext
     • Adicione configurações para adicionar restrições às tabelas do banco de dados
     • Adicionar dados iniciais
     • Adicione migrações usando scripts de migração do EF Core e opção idempotent
     • Exponha API(s) CRUD usando EF Core ORM expondo os seguintes endpoints
       • Paginação de deslocamento /api/Employees?page=1&limit=10
       • Paginação do conjunto de chaves /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Obtenha solteiro por id /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Criar /api/Employees
       • Atualizar /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Excluindo /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. Cache de resposta no aplicativo API ASP.NET 6

   • Adicionar cache de memória usando IMemoryCache
   • Adicione cache distribuído usando Azure Cache para Redis e StackExchange.Redis

5. Segurança no aplicativo API ASP.NET 6

   • Adicionar autenticação

     • Entenda Claim , ClaimsIdentity e ClaimsPrincipal
     • Implementar autenticação básica
     • Implementar autenticação de cookie
     • Implementar autenticação JWT (personalizada)
       • Hash de senhas de texto simples usando o algoritmo BCrypt e o nuget BCrypt.Net-Next
       • Gere JWTs usando System.IdentityModel.Tokens.Jwt
       • Adicione as seguintes APIs
         • /api/Account/Register para registrar o usuário
         • /api/Account/Login para fazer login do usuário e gerar o conjunto inicial de token de acesso e token de atualização
         • /api/Account/Token para atualizar o token de acesso usando o token de atualização enviado
         • /api/Account/Revoke para revogar o token de atualização

   • Adicionar autorização

     • Implementar autorização baseada em função
     • Implementar autorização baseada em políticas
       • Compreender os "requisitos" da política e implementar a interface IAuthorizationRequirement
       • Substitua o HandleRequirementAsync para criar um requisito de política personalizado
       • Registre o requisito personalizado em Program.cs

   • Estudo de caso: Adicionar autenticação JWT e autorização de função usando Auth0

     • Entenda o OAuth2
     • Entenda as terminologias do OAuth2
     • Entenda os fluxos OAuth
       • Fluxo implícito
       • Fluxo de credenciais do cliente
       • Fluxo do código de autenticação
     • Criar aplicativo em Auth0
     • Definir URLs de redirecionamento em Auth0
     • Proteja todos os endpoints da API usando Auth0
     • Defina permissões na API e faça autorização de políticas

6. Tratamento de uploads e downloads de arquivos

   • Uploads de arquivos
     • Lidar com upload de arquivos únicos ou múltiplos
     • Armazene o arquivo carregado localmente na wwwroot folder
     • Armazenar arquivo carregado em contêineres de armazenamento de blobs do Azure
   • Downloads de arquivos
     • Transmitir arquivo CSV para resposta
     • Transmita o arquivo .xlsx do Excel para resposta

7. Teste

   • Teste de unidade

     • Adicione testes de unidade usando xUnit.net
     • Compreendendo [Fact] e [Theory]
     • Inicialize dados de teste usando construtor
     • Limpe os dados de teste usando o método Dispose
     • Crie testes parametrizados
       • Passe parâmetros primitivos usando [InlineData]
       • Passe parâmetros primitivos e complexos usando [MemberData]
       • Passe parâmetros primitivos e complexos usando [ClassData]
     • Compartilhe contexto de teste na mesma classe usando IClassFixture
     • Compartilhe o contexto de teste entre várias classes usando ICollectionFixture
     • Simule um serviço de dependência usando Moq
     • Verifique se o serviço simulado foi chamado usando Verify() ou VerifyAll()

   • Teste de Integração

     • Crie uma fábrica de aplicativos da web personalizada herdando WebApplicationFactory<TStartup>
     • Use o banco de dados EF Core In Memory para testes de integração
     • Escreva testes de integração para API(s) usando xUnit.net

8. Comunicação síncrona entre serviços usando gRPC e HTTP2

   • Crie uma API de gateway e uma API interna comunicando-se entre si de forma síncrona usando gRPC

9. Comunicação assíncrona entre serviços usando filas de mensagens

   • Crie uma API de gateway e API(s) internas (Função do Azure) comunicando-se entre si de forma assíncrona usando o Barramento de Serviço do Azure.

10. Hospedando aplicativo API ASP.NET 6

    • Hospedar aplicativo API ASP.NET 6 usando IIS e publicação de pasta
    • Hospedar aplicativo API ASP.NET 6 usando o Azure App Service e publicação manual