AspNet6InDepth

Apprendre ASP.NET 6 en profondeur

1. Présentation d'ASP.NET 6

   • Histoire et trame de fond
   • Stratégie de gestion des versions
   • Installation
   • Structure du projet
   • SDK .NET

2. Principes fondamentaux d'ASP.NET 6

   • Échafaudage d'une application API ASP.NET 6 à l'aide du SDK .NET
   • Analyse du fichier Program.cs
   • Injection de dépendances
     • Enregistrer l'objet en tant que durée de vie singleton
     • Enregistrer l'objet en tant que durée de vie limitée
     • Enregistrer l'objet comme durée de vie transitoire
   • Intergiciels
     • Aperçu
     • Créer des middlewares personnalisés
       • En implémentant l'interface IMiddleware
       • En injectant l'objet RequestDelegate
       • Écrivez des middlewares en ligne à l'aide de app.Use , app.Map , app.MapWhen , app.UseWhen et app.Run
     • middleware de fichiers statiques app.UseStaticFiles();
     • app.UseCors();
     • Ajouter le middleware Correlationid
     • Ajoutez un middleware d'exception global non géré et renvoyez la réponse standard ProblemDetails
   • Hôte de configuration
   • Configurations
     • Lire les configurations depuis appsettings.{environment}.json et l'interface IConfiguration
     • Modèle d'options
       • Lier la configuration au POCO C# fortement typé à l'aide de l'interface IOptions<T>
       • Lier la configuration qui peut être rechargée au moment de l'exécution sur un POCO C# fortement typé à l'aide de l'interface IOptionsSnapshot<T> ou IOptionsMonitor<T>
   • Comprendre HttpContext , HttpContext.Request et HttpContext.Response
   • Routage d'attributs
     • Liez plusieurs routes à un contrôleur à l'aide de l'attribut Route
     • Transmettre les paramètres aux méthodes d'action à l'aide des paramètres de route
     • Verbes d'action HttpGetAttribute , HttpPostAttribute , HttpPutAttribute , HttpPatchAttribute et HttpDeleteAttribute
   • Reliure du modèle
     • Liaison de modèle à partir des sources suivantes
       • FromQuery : obtient les valeurs de la chaîne de requête
       • FromRoute : obtient les valeurs des données d'itinéraire
       • FromForm : obtient les valeurs des champs de formulaire publiés
       • FromBody : récupère les valeurs du corps de la requête
       • FromHeader : récupère les valeurs des en-têtes HTTP
   • Gérer les réponses à l'aide de IActionResult<T> ou ActionResult<T>
   • Gérer la négociation de contenu à l'aide de l'en-tête Accept
     • Envoyer une réponse XML si l'en-tête Accept est défini sur application/xml
     • Envoyer une réponse JSON si l'en-tête Accept est défini sur application/json
   • Gestion des versions dans les API .NET6
   • Gérer les requêtes de type HTTP Patch
   • Validation du modèle
     • Utilisation des attributs d'annotation de données
       • Compare : Valide si deux propriétés d'un modèle correspondent.
       • EmailAddress : Validez si une propriété a un format email.
       • Phone : Validez si un bien possède un format de numéro de téléphone.
       • Range : validez si la valeur d'une propriété se situe dans une plage spécifiée.
       • RegularExpression : valide si une valeur de propriété correspond à une expression régulière spécifiée.
       • Required : Valider si un champ n'est pas nul.
       • StringLength : validez si la valeur d'une propriété de chaîne ne dépasse pas une limite de longueur spécifiée.
       • Url : Validez si une propriété a un format URL.
     • Validation FluentValidation à l'aide des méthodes Fluent
   • Client HTTP
     • Création d'IHttpClientFactory de base à l'aide de IHttpClientFactory.CreateClient();
     • Nommé HttpClient
     • HttpClient tapé
     • Ajoutez DelegatingHandler aux clients HTTP pour exécuter une logique commune
     • Gérer les exceptions HTTP à l'aide de la bibliothèque Polly
   • Filtres
   • Compresser le corps de la réponse
     • Ajouter une compression de réponse à l'aide de l'algorithme gzip
   • Mondialisation et localisation
   • Limitation du débit
     • Limitation du débit à l’aide du package nuget AspNetCoreRateLimit avec fournisseur de mémoire.
     • Limitation du débit à l’aide du package nuget AspNetCoreRateLimit et AspNetCoreRateLimit.Redis avec le fournisseur Azure Cache pour Redis.
   • Enregistrement
     • Comprendre les niveaux de journalisation
     • Connectez-vous à l'aide des méthodes d'extension ILogger<T>
       • logger.LogTrace messages de niveau de trace du journal
       • logger.LogDebug messages de niveau de débogage du journal
       • logger.LogInformation messages de niveau d'information du journal
       • logger.Warning messages de niveau d'avertissement du journal
       • logger.Error messages de niveau d'erreur du journal
       • logger.Critical log messages de niveau critique
     • Se connecter à l'aide du SDK Azure AppInsights
   • Services hébergés
     • Implémenter des services hébergés à l'aide de l'interface IHostedService
     • Implémentez les services d'arrière-plan en remplaçant la classe BackgroundService
   • Mappage d'objets d'un type à un autre à l'aide du package nuget Automapper
   • Modèle de médiateur
     • Implémenter des services faiblement couplés à l'aide du package MediatR nuget
   • Fanfaronnade
     • Installez le nuget Swashbuckle.AspNetCore pour ajouter la prise en charge de Swagger OpenAPI
     • Ajouter des informations et une description sur l'API
     • Ajouter des balises récapitulatives pour les métadonnées au niveau de l'API
     • Ajouter des OperationIds aux API de groupe
     • Enrichir les métadonnées des opérations
     • Enrichir les métadonnées de réponse
     • Enrichir les métadonnées des paramètres
     • Enrichir les métadonnées RequestBody
     • Enrichir les métadonnées du schéma
     • Ajouter des métadonnées de balise
     • Modifier le préfixe de la route swagger pour servir swagger.json à partir du niveau racine
     • Omettre les API pour qu'elles soient visibles dans Swagger
     • Générer plusieurs documents Swagger
   • Bilans de santé

3. Accès aux données dans l'application API ASP.NET 6

   • Accès aux données à l'aide de Micro ORM Dapper et PostgreSQL

     • Installer Npgsql
     • Installer Dapper Micro ORM
     • Installer Azure Data Studio
     • Configurer Azure Database pour PostgreSQL
     • Exposez les API CRUD à l'aide de Dapper MicroORM en exposant les points de terminaison suivants
       • Pagination décalée /api/Persons?page=1&limit=10
       • Pagination du jeu de clés /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Devenez célibataire par identifiant /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Créer /api/Persons
       • Mise à jour /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Suppression de /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • Accès aux données à l'aide d'EF Core 6 ORM et PostgreSQL

     • Installer EF Core 6
     • Installer Azure Data Studio
     • Configurer Azure Database pour PostgreSQL
     • Ajouter DbSet<T> aux tables de modèle dans la base de données
     • Analyser DbContext
     • Créer un modèle de référentiel avec les méthodes d'extension DbContext
     • Ajouter des configurations pour ajouter des contraintes aux tables de base de données
     • Ajouter des données de départ
     • Ajouter des migrations à l’aide des scripts de migration EF Core et de l’option idempotent
     • Exposez les API CRUD à l'aide d'EF Core ORM en exposant les points de terminaison suivants
       • Pagination décalée /api/Employees?page=1&limit=10
       • Pagination du jeu de clés /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Devenez célibataire par identifiant /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Créer /api/Employees
       • Mise à jour /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Suppression de /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. Mise en cache des réponses dans l'application API ASP.NET 6

   • Ajouter une mise en cache mémoire à l'aide IMemoryCache
   • Ajouter une mise en cache distribuée à l'aide d'Azure Cache pour Redis et StackExchange.Redis

5. Sécurité dans l'application API ASP.NET 6

   • Ajouter une authentification

     • Comprendre Claim , ClaimsIdentity et ClaimsPrincipal
     • Implémenter l'authentification de base
     • Implémenter l'authentification par cookie
     • Implémenter l'authentification JWT (personnalisée)
       • Hachez les mots de passe en texte brut à l'aide de l'algorithme BCrypt et du nuget BCrypt.Net-Next
       • Générer des JWT à l'aide de System.IdentityModel.Tokens.Jwt
       • Ajoutez la ou les API suivantes
         • /api/Account/Register pour enregistrer l'utilisateur
         • /api/Account/Login pour connecter l'utilisateur et générer l'ensemble initial de jeton d'accès et de jeton d'actualisation
         • /api/Account/Token pour actualiser le jeton d'accès à l'aide du jeton d'actualisation envoyé
         • /api/Account/Revoke pour révoquer le jeton d'actualisation

   • Ajouter une autorisation

     • Implémenter l’autorisation basée sur les rôles
     • Mettre en œuvre une autorisation basée sur des politiques
       • Comprendre les « exigences » de la politique et implémenter l'interface IAuthorizationRequirement
       • Remplacez HandleRequirementAsync pour créer une exigence de stratégie personnalisée
       • Enregistrez l'exigence personnalisée dans Program.cs

   • Étude de cas : ajouter l'authentification JWT et l'autorisation de rôle à l'aide d'Auth0

     • Comprendre OAuth2
     • Comprendre les terminologies OAuth2
     • Comprendre les flux OAuth
       • Flux implicite
       • Flux d'informations d'identification client
       • Flux de code d'authentification
     • Créer une application dans Auth0
     • Définir les URL de redirection dans Auth0
     • Sécurisez tous les points de terminaison de l'API à l'aide d'Auth0
     • Définir les autorisations sur l'API et effectuer l'autorisation de la politique

6. Gestion des téléchargements de fichiers et des téléchargements de fichiers

   • Téléchargements de fichiers
     • Gérer le téléchargement d’un ou plusieurs fichiers
     • Stocker le fichier téléchargé localement dans wwwroot folder
     • Stocker le fichier téléchargé dans les conteneurs de stockage Azure Blob
   • Téléchargements de fichiers
     • Diffusez le fichier CSV vers la réponse
     • Diffusez le fichier Excel .xlsx vers la réponse

7. Essai

   • Tests unitaires

     • Ajouter des tests unitaires à l'aide de xUnit.net
     • Comprendre [Fact] et [Theory]
     • Initialiser les données de test à l'aide du constructeur
     • Données de test de nettoyage à l'aide de la méthode Dispose
     • Créer des tests paramétrés
       • Transmettre les paramètres primitifs à l'aide de [InlineData]
       • Transmettez des paramètres primitifs et complexes à l'aide de [MemberData]
       • Transmettre des paramètres primitifs et complexes à l'aide de [ClassData]
     • Partager le contexte de test dans la même classe à l'aide de IClassFixture
     • Partager le contexte de test entre plusieurs classes à l'aide ICollectionFixture
     • Se moquer d'un service de dépendance à l'aide Moq
     • Vérifiez si le service simulé a été appelé à l'aide Verify() ou VerifyAll()

   • Tests d'intégration

     • Créez une fabrique d'applications Web personnalisée en héritant de WebApplicationFactory<TStartup>
     • Utiliser la base de données EF Core In Memory pour les tests d’intégration
     • Écrire des tests d'intégration pour les API à l'aide de xUnit.net

8. Communication interservice synchrone utilisant gRPC et HTTP2

   • Créez une API de passerelle et une API interne communiquant entre elles de manière synchrone à l'aide de gRPC

9. Communication interservices asynchrone à l'aide de files d'attente de messages

   • Créez une API de passerelle et des API internes (fonction Azure) communiquant entre elles de manière asynchrone à l'aide d'Azure Service Bus.

10. Hébergement de l'application API ASP.NET 6

    • Hébergez l'application API ASP.NET 6 à l'aide d'IIS et de la publication de dossiers
    • Hébergez l'application API ASP.NET 6 à l'aide d'Azure App Service et publiez manuellement