AspNet6InDepth

Подробное изучение ASP.NET 6

1. Обзор ASP.NET 6

   • История и предыстория
   • Стратегия управления версиями
   • Установка
   • Структура проекта
   • .NET SDK

2. Основы ASP.NET 6

   • Приложение API Scaffold ASP.NET 6 с использованием .NET SDK
   • Анализ файла Program.cs
   • Внедрение зависимостей
     • Зарегистрировать объект как одноэлементное время жизни
     • Зарегистрировать объект как ограниченное время жизни
     • Зарегистрировать объект как временное время жизни
   • Промежуточное ПО
     • Обзор
     • Создание собственных промежуточных программ
       • Реализуя интерфейс IMiddleware
       • Путем внедрения объекта RequestDelegate
       • Напишите встроенное промежуточное ПО, используя app.Use , app.Map , app.MapWhen , app.UseWhen и app.Run
     • Промежуточное ПО для статических файлов app.UseStaticFiles();
     • Промежуточное программное обеспечение CORS app.UseCors();
     • Добавить промежуточное программное обеспечение Correlationid
     • Добавьте глобальное промежуточное программное обеспечение необработанных исключений и верните стандартный ответ ProblemDetails
   • Настройка хоста
   • Конфигурации
     • Чтение конфигураций из appsettings.{environment}.json и интерфейса IConfiguration
     • Шаблон опционов
       • Привязка конфигурации к строго типизированному C# POCO с помощью интерфейса IOptions
       • Конфигурация привязки, которая может перезагружаться во время выполнения, к строго типизированному C# POCO с помощью интерфейса IOptionsSnapshot или IOptionsMonitor
   • Понимание HttpContext , HttpContext.Request и HttpContext.Response
   • Маршрутизация атрибутов
     • Привяжите несколько маршрутов к контроллеру с помощью атрибута Route .
     • Передача параметров методам действий с использованием параметров маршрута
     • Глаголы действия HttpGetAttribute , HttpPostAttribute , HttpPutAttribute , HttpPatchAttribute и HttpDeleteAttribute
   • Привязка модели
     • Привязка модели из следующих источников
       • FromQuery : получает значения из строки запроса.
       • FromRoute : получает значения из данных маршрута.
       • FromForm : получает значения из опубликованных полей формы.
       • FromBody : получает значения из тела запроса.
       • FromHeader : получает значения из заголовков HTTP.
   • Обработка ответов с помощью IActionResult или ActionResult
   • Обработка согласования содержимого с использованием заголовка Accept .
     • Отправьте ответ XML, если для заголовка Accept установлено значение application/xml
     • Отправьте ответ JSON, если для заголовка Accept установлено значение application/json
   • Управление версиями в API .NET6.
   • Обработка запросов типа HTTP Patch
   • Проверка модели
     • Использование атрибутов аннотаций данных
       • Compare : проверьте, совпадают ли два свойства в модели.
       • EmailAddress : проверьте, имеет ли свойство формат электронной почты.
       • Phone : проверьте, имеет ли свойство формат телефонного номера.
       • Range : проверьте, попадает ли значение свойства в указанный диапазон.
       • RegularExpression : проверяет, соответствует ли значение свойства указанному регулярному выражению.
       • Required : проверьте, не является ли поле пустым.
       • StringLength : проверяет, не превышает ли значение свойства строки указанный предел длины.
       • Url : проверьте, имеет ли свойство формат URL.
     • Проверка FluentValidation с использованием методов Fluent
   • HTTP-клиент
     • Создание базовой IHttpClientFactory с помощью IHttpClientFactory.CreateClient();
     • Именованный HttpClient
     • Типизированный HttpClient
     • Добавьте DelegatingHandler в HTTP-клиенты для выполнения общей логики.
     • Обработка исключений HTTP с помощью библиотеки Polly
   • Фильтры
   • Сжать тело ответа
     • Добавьте сжатие ответа с помощью алгоритма gzip .
   • Глобализация и локализация
   • Ограничение скорости
     • Ограничение скорости с использованием пакета nuget AspNetCoreRateLimit с поставщиком памяти.
     • Ограничение скорости с помощью пакета Nuget AspNetCoreRateLimit и AspNetCoreRateLimit.Redis с поставщиком кэша Azure для Redis.
   • Ведение журнала
     • Понимание уровней журнала
     • Ведение журнала с использованием методов расширения ILogger
       • logger.LogTrace сообщения уровня трассировки журнала
       • logger.LogDebug записывает сообщения уровня отладки
       • logger.LogInformation сообщения уровня информации журнала
       • logger.Warning Сообщения уровня предупреждений журнала
       • logger.Error log сообщения об уровне ошибок
       • logger.Critical регистрирует сообщения критического уровня
     • Ведение журнала с помощью Azure AppInsights SDK.
   • Хостинговые услуги
     • Реализация размещенных служб с использованием интерфейса IHostedService
     • Реализуйте фоновые службы, переопределив класс BackgroundService
   • Сопоставление объектов одного типа с другим с помощью пакета Nuget Automapper
   • Шаблон посредника
     • Реализуйте слабосвязанные сервисы с помощью пакета Nuget MediatR.
   • Суэггер
     • Установите nuget Swashbuckle.AspNetCore для добавления поддержки Swagger OpenAPI.
     • Добавьте информацию и описание API
     • Добавьте сводные теги для метаданных уровня API.
     • Добавить OperationIds в групповые API
     • Расширение метаданных операции
     • Расширение метаданных ответа
     • Расширение метаданных параметров
     • Расширение метаданных RequestBody
     • Обогащение метаданных схемы
     • Добавить метаданные тега
     • Измените префикс маршрута swagger для обслуживания swagger.json с корневого уровня.
     • Опустите API, чтобы они были видны в Swagger.
     • Создать несколько документов Swagger
   • Проверка здоровья

3. Доступ к данным в приложении API ASP.NET 6

   • Доступ к данным с использованием Micro ORM Dapper и PostgreSQL

     • Установить Npgsql
     • Установите Dapper Micro ORM
     • Установите Студию данных Azure.
     • Настройка базы данных Azure для PostgreSQL
     • Откройте API-интерфейсы CRUD с помощью Dapper MicroORM, открывая следующие конечные точки
       • Смещение страниц /api/Persons?page=1&limit=10
       • Пагинация набора ключей /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Получить сингл по идентификатору /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Создать /api/Persons
       • Обновить /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Удаление /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • Доступ к данным с использованием EF Core 6 ORM и PostgreSQL

     • Установите EF Core 6
     • Установите Студию данных Azure.
     • Настройка базы данных Azure для PostgreSQL
     • Добавьте DbSet в таблицы модели в базе данных.
     • Анализ DbContext
     • Создайте шаблон репозитория с помощью методов расширения DbContext.
     • Добавьте конфигурации для добавления ограничений в таблицы базы данных.
     • Добавить начальные данные
     • Добавьте миграции с помощью сценариев миграции EF Core и опции idempotent .
     • Предоставьте API-интерфейсы CRUD с помощью EF Core ORM, предоставляя следующие конечные точки
       • Смещенная нумерация страниц /api/Employees?page=1&limit=10
       • Пагинация набора ключей /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Получить сингл по идентификатору /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Создать /api/Employees
       • Обновить /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Удаление /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. Кэширование ответов в приложении API ASP.NET 6

   • Добавьте кэширование в памяти с помощью IMemoryCache
   • Добавьте распределенное кэширование с помощью Azure Cache для Redis и StackExchange.Redis

5. Безопасность в приложении API ASP.NET 6

   • Добавить аутентификацию

     • Общие сведения Claim , ClaimsIdentity и ClaimsPrincipal
     • Реализация базовой аутентификации
     • Внедрить аутентификацию с помощью файлов cookie
     • Внедрение аутентификации JWT (настраиваемая)
       • Хешируйте пароли в виде простого текста с использованием алгоритма BCrypt и BCrypt.Net-Next nuget.
       • Сгенерируйте JWT с помощью System.IdentityModel.Tokens.Jwt
       • Добавьте следующие API:
         • /api/Account/Register для регистрации пользователя
         • /api/Account/Login для входа в систему пользователя и создания исходного набора токена доступа и токена обновления.
         • /api/Account/Token для обновления токена доступа с использованием отправленного токена обновления.
         • /api/Account/Revoke чтобы отозвать токен обновления.

   • Добавить авторизацию

     • Реализация авторизации на основе ролей
     • Внедрение авторизации на основе политик
       • Понимание «требований» политики и реализация интерфейса IAuthorizationRequirement
       • Переопределите HandleRequirementAsync , чтобы создать требование настраиваемой политики.
       • Зарегистрируйте пользовательское требование в Program.cs

   • Практический пример: добавление аутентификации JWT и авторизации ролей с использованием Auth0

     • Понимание OAuth2
     • Понимать терминологию OAuth2
     • Понимание потоков OAuth
       • Неявный поток
       • Поток учетных данных клиента
       • Поток кода аутентификации
     • Создать приложение в Auth0
     • Установите URL-адреса перенаправления в Auth0
     • Защитите все конечные точки API с помощью Auth0.
     • Определите разрешения для API и выполните авторизацию политики.

6. Обработка загрузки файлов и загрузок файлов

   • Загрузка файлов
     • Обрабатывать загрузку одного или нескольких файлов
     • Сохраните загруженный файл локально в wwwroot folder
     • Сохранение отправленного файла в контейнерах хранилища BLOB-объектов Azure.
   • Загрузка файлов
     • Потоковая передача CSV-файла в ответ
     • Потоковая передача файла Excel .xlsx в ответ

7. Тестирование

   • Модульное тестирование

     • Добавьте модульное тестирование с помощью xUnit.net
     • Понимание [Fact] и [Theory]
     • Инициализируйте тестовые данные с помощью конструктора
     • Очистка тестовых данных с использованием метода Dispose
     • Создание параметризованных тестов
       • Передайте примитивные параметры, используя [InlineData]
       • Передавайте примитивные и сложные параметры, используя [MemberData]
       • Передавайте примитивные и сложные параметры, используя [ClassData]
     • Совместное использование тестового контекста в одном классе с помощью IClassFixture
     • Совместное использование тестового контекста между несколькими классами с помощью ICollectionFixture
     • Имитация службы зависимостей с помощью Moq
     • Проверьте, была ли вызвана имитируемая служба, используя Verify() или VerifyAll()

   • Интеграционное тестирование

     • Создайте собственную фабрику веб-приложений, унаследовав WebApplicationFactory
     • Использование базы данных EF Core в памяти для интеграционного тестирования
     • Написание интеграционных тестов для API с использованием xUnit.net .

8. Синхронная межсервисная связь с использованием gRPC и HTTP2.

   • Создайте API шлюза и внутренний API, синхронно взаимодействующие друг с другом с помощью gRPC.

9. Асинхронная межсервисная связь с использованием очередей сообщений

   • Создайте API шлюза и внутренние API (функции Azure), взаимодействующие друг с другом асинхронно с помощью служебной шины Azure.

10. Размещение приложения ASP.NET 6 API

    • Размещение приложения API ASP.NET 6 с использованием IIS и публикации папок.
    • Размещение приложения API ASP.NET 6 с помощью службы приложений Azure и публикации вручную.