AspNet6InDepth

ASP.NET 6 im Detail lernen

1. ASP.NET 6-Übersicht

   • Geschichte und Hintergrundgeschichte
   • Versionierungsstrategie
   • Installation
   • Projektstruktur
   • .NET SDK

2. ASP.NET 6-Grundlagen

   • Gerüst für ASP.NET 6-API-Anwendung mit .NET SDK
   • Analysieren der Datei Program.cs
   • Abhängigkeitsinjektion
     • Registrieren Sie das Objekt als Singleton-Lebensdauer
     • Registrieren Sie das Objekt als Gültigkeitsbereich
     • Registrieren Sie das Objekt als vorübergehende Lebensdauer
   • Middleware
     • Überblick
     • Erstellen Sie benutzerdefinierte Middlewares
       • Durch die Implementierung IMiddleware Schnittstelle
       • Durch Einfügen RequestDelegate -Objekts
       • Schreiben Sie Inline-Middlewares mit app.Use , app.Map , app.MapWhen , app.UseWhen und app.Run
     • Statische Dateien Middleware app.UseStaticFiles();
     • CORS-Middleware app.UseCors();
     • Fügen Sie Correlationid-Middleware hinzu
     • Fügen Sie globale Middleware für nicht behandelte Ausnahmen hinzu und geben Sie die Standardantwort ProblemDetails zurück
   • Host einrichten
   • Konfigurationen
     • Lesen Sie Konfigurationen aus appsettings.{environment}.json und der IConfiguration Schnittstelle
     • Optionsmuster
       • Binden Sie die Konfiguration mithilfe IOptions<T> -Schnittstelle an stark typisiertes C#-POCO
       • Binden Sie die Konfiguration, die zur Laufzeit über die Schnittstelle IOptionsSnapshot<T> oder IOptionsMonitor<T> in stark typisiertes C# POCO neu geladen werden kann
   • Grundlegendes zu HttpContext , HttpContext.Request und HttpContext.Response
   • Attributrouting
     • Binden Sie mehrere Routen mithilfe des Route -Attributs an einen Controller
     • Übergeben Sie Parameter mithilfe von Routenparametern an Aktionsmethoden
     • Aktionsverben HttpGetAttribute , HttpPostAttribute , HttpPutAttribute , HttpPatchAttribute und HttpDeleteAttribute
   • Modellbindung
     • Modellbindung aus den folgenden Quellen
       • FromQuery : Ruft Werte aus der Abfragezeichenfolge ab
       • FromRoute : Ruft Werte aus Routendaten ab
       • FromForm : Ruft Werte aus geposteten Formularfeldern ab
       • FromBody : Ruft Werte aus dem Anforderungstext ab
       • FromHeader : Ruft Werte aus HTTP-Headern ab
   • Behandeln Sie Antworten mit IActionResult<T> oder ActionResult<T>
   • Behandeln Sie die Inhaltsaushandlung mithilfe Accept Headers
     • XML-Antwort senden, wenn Accept Header auf application/xml gesetzt ist
     • Senden Sie eine JSON-Antwort, wenn Accept Header auf application/json gesetzt ist
   • Versionierung in .NET6-API(s)
   • Behandeln Sie HTTP Patch -Anfragen
   • Modellvalidierung
     • Verwenden von Datenanmerkungsattributen
       • Compare : Überprüfen Sie, ob zwei Eigenschaften in einem Modell übereinstimmen.
       • EmailAddress : Überprüfen Sie, ob eine Eigenschaft ein E-Mail-Format hat.
       • Phone : Überprüfen Sie, ob eine Eigenschaft ein Telefonnummernformat hat.
       • Range : Überprüfen Sie, ob ein Eigenschaftswert innerhalb eines angegebenen Bereichs liegt.
       • RegularExpression : Überprüfen Sie, ob ein Eigenschaftswert mit einem angegebenen regulären Ausdruck übereinstimmt.
       • Required : Validieren, ob ein Feld nicht null ist.
       • StringLength : Validiert, ob ein String-Eigenschaftswert eine angegebene Längenbeschränkung nicht überschreitet.
       • Url : Überprüfen Sie, ob eine Eigenschaft ein URL-Format hat.
     • FluentValidation-Validierung mit Fluent-Methoden
   • HTTP-Client
     • Erstellen einer grundlegenden IHttpClientFactory mit IHttpClientFactory.CreateClient();
     • Mit dem Namen HttpClient
     • HttpClient eingegeben
     • Fügen Sie DelegatingHandler zu HTTP-Clients hinzu, um allgemeine Logik auszuführen
     • Behandeln Sie HTTP-Ausnahmen mithilfe der Polly-Bibliothek
   • Filter
   • Antworttext komprimieren
     • Fügen Sie die Antwortkomprimierung mithilfe des gzip -Algorithmus hinzu
   • Globalisierung und Lokalisierung
   • Ratenbegrenzung
     • Ratenbegrenzung mithilfe AspNetCoreRateLimit Nuget-Pakets mit Speicheranbieter.
     • Ratenbegrenzung mithilfe des Nuget-Pakets AspNetCoreRateLimit und AspNetCoreRateLimit.Redis mit dem Azure Cache for Redis-Anbieter.
   • Protokollierung
     • Protokollebenen verstehen
     • Protokollieren Sie mit ILogger<T> -Erweiterungsmethoden
       • logger.LogTrace protokolliert Meldungen auf Trace-Ebene
       • logger.LogDebug protokolliert Meldungen auf Debug-Ebene
       • logger.LogInformation protokolliert Meldungen auf Informationsebene
       • logger.Warning protokolliert Meldungen der Warnstufe
       • logger.Error protokolliert Meldungen auf Fehlerebene
       • logger.Critical protokolliert Meldungen kritischer Stufe
     • Protokollieren Sie mit dem Azure AppInsights SDK
   • Gehostete Dienste
     • Implementieren Sie gehostete Dienste mithilfe IHostedService Schnittstelle
     • Implementieren Sie Hintergrunddienste, indem Sie die BackgroundService -Klasse überschreiben
   • Zuordnen von Objekten von einem Typ zu einem anderen mithilfe des Automapper-Nuget-Pakets
   • Mediatormuster
     • Implementieren Sie lose gekoppelte Dienste mit dem MediatR-Nuget-Paket
   • Stolzieren
     • Installieren Sie Swashbuckle.AspNetCore Nuget, um Swagger OpenAPI-Unterstützung hinzuzufügen
     • Fügen Sie API-Informationen und Beschreibung hinzu
     • Fügen Sie Zusammenfassungs-Tags für Metadaten auf API-Ebene hinzu
     • OperationIds zu Gruppen-API(s) hinzufügen
     • Bereichern Sie Vorgangsmetadaten
     • Antwortmetadaten anreichern
     • Parametermetadaten anreichern
     • Bereichern Sie RequestBody-Metadaten
     • Bereichern Sie Schema-Metadaten
     • Tag-Metadaten hinzufügen
     • Ändern Sie das Swagger-Routenpräfix, um swagger.json von der Root-Ebene aus bereitzustellen
     • Lassen Sie API(s) weg, damit sie in Swagger sichtbar sind
     • Generieren Sie mehrere Swagger-Dokumente
   • Gesundheitschecks

3. Datenzugriff in der ASP.NET 6-API-Anwendung

   • Datenzugriff mit Micro ORM Dapper und PostgreSQL

     • Installieren Sie Npgsql
     • Installieren Sie Dapper Micro ORM
     • Installieren Sie Azure Data Studio
     • Konfigurieren Sie Azure Database für PostgreSQL
     • Machen Sie CRUD-API(s) mit Dapper MicroORM verfügbar und machen Sie die folgenden Endpunkte verfügbar
       • Versetzte Paginierung /api/Persons?page=1&limit=10
       • Keyset-Paginierung /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Holen Sie sich eine Single mit der ID /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Erstellen Sie /api/Persons
       • Aktualisieren Sie /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646 wird gelöscht

   • Datenzugriff mit EF Core 6 ORM und PostgreSQL

     • Installieren Sie EF Core 6
     • Installieren Sie Azure Data Studio
     • Konfigurieren Sie Azure Database für PostgreSQL
     • Fügen Sie DbSet<T> zu Modelltabellen in der Datenbank hinzu
     • DbContext analysieren
     • Erstellen Sie ein Repository-Muster mit DbContext-Erweiterungsmethoden
     • Fügen Sie Konfigurationen hinzu, um Einschränkungen zu Datenbanktabellen hinzuzufügen
     • Seed-Daten hinzufügen
     • Fügen Sie Migrationen mithilfe von EF Core-Migrationsskripts und idempotent Option hinzu
     • Machen Sie CRUD-API(s) mithilfe von EF Core ORM verfügbar, um die folgenden Endpunkte verfügbar zu machen
       • Versetzte Paginierung /api/Employees?page=1&limit=10
       • Keyset-Paginierung /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Werden Sie Single mit der ID /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Erstellen Sie /api/Employees
       • Aktualisieren Sie /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646 wird gelöscht

4. Antwort-Caching in der ASP.NET 6-API-Anwendung

   • Fügen Sie In-Memory-Caching mit IMemoryCache hinzu
   • Fügen Sie verteiltes Caching mit Azure Cache for Redis und StackExchange.Redis hinzu

5. Sicherheit in der ASP.NET 6-API-Anwendung

   • Authentifizierung hinzufügen

     • Verstehen Sie Claim , ClaimsIdentity und ClaimsPrincipal
     • Implementieren Sie die Basisauthentifizierung
     • Implementieren Sie die Cookie-Authentifizierung
     • JWT-Authentifizierung implementieren (benutzerdefiniert)
       • Hashen Sie Klartext-Passwörter mit dem BCrypt-Algorithmus und BCrypt.Net-Next -Nuget
       • Generieren Sie JWTs mit System.IdentityModel.Tokens.Jwt
       • Fügen Sie die folgenden API(s) hinzu
         • /api/Account/Register um den Benutzer zu registrieren
         • /api/Account/Login um den Benutzer anzumelden und den ersten Satz von Zugriffstoken und Aktualisierungstoken zu generieren
         • /api/Account/Token um das Zugriffstoken mithilfe des gesendeten Aktualisierungstokens zu aktualisieren
         • /api/Account/Revoke um das Aktualisierungstoken zu widerrufen

   • Autorisierung hinzufügen

     • Implementieren Sie eine rollenbasierte Autorisierung
     • Implementieren Sie eine richtlinienbasierte Autorisierung
       • Verstehen Sie die „Richtlinienanforderungen“ und implementieren Sie die IAuthorizationRequirement Schnittstelle
       • Überschreiben Sie HandleRequirementAsync um eine benutzerdefinierte Richtlinienanforderung festzulegen
       • Registrieren Sie die benutzerdefinierte Anforderung in Program.cs

   • Fallstudie: JWT-Authentifizierung und Rollenautorisierung mit Auth0 hinzufügen

     • Verstehen Sie OAuth2
     • Verstehen Sie die OAuth2-Terminologien
     • OAuth-Abläufe verstehen
       • Impliziter Fluss
       • Ablauf der Client-Anmeldeinformationen
       • Authentifizierungscode-Ablauf
     • Erstellen Sie eine Anwendung in Auth0
     • Legen Sie Weiterleitungs-URLs in Auth0 fest
     • Sichern Sie alle API-Endpunkte mit Auth0
     • Definieren Sie Berechtigungen für die API und führen Sie eine Richtlinienautorisierung durch

6. Abwicklung von Datei-Uploads und Datei-Downloads

   • Datei-Uploads
     • Behandeln Sie das Hochladen einzelner oder mehrerer Dateien
     • Speichern Sie die hochgeladene Datei lokal im wwwroot folder
     • Speichern Sie die hochgeladene Datei in Azure Blob Storage Containern
   • Datei-Downloads
     • Streamen Sie die CSV-Datei zur Antwort
     • Streamen Sie die Excel- .xlsx Datei zur Antwort

7. Testen

   • Unit-Tests

     • Fügen Sie Unit-Tests mit xUnit.net hinzu
     • [Fact] und [Theory] verstehen
     • Testdaten mit Konstruktor initialisieren
     • Bereinigen Sie Testdaten mit Dispose -Methode
     • Erstellen Sie parametrisierte Tests
       • Übergeben Sie primitive Parameter mit [InlineData]
       • Übergeben Sie primitive und komplexe Parameter mit [MemberData]
       • Übergeben Sie primitive und komplexe Parameter mit [ClassData]
     • Teilen Sie den Testkontext in derselben Klasse mit IClassFixture
     • Teilen Sie den Testkontext mit ICollectionFixture zwischen mehreren Klassen
     • Verspotten Sie einen Abhängigkeitsdienst mit Moq
     • Überprüfen Sie, ob der simulierte Dienst mit Verify() oder VerifyAll() aufgerufen wurde.

   • Integrationstests

     • Erstellen Sie eine benutzerdefinierte Webanwendungsfabrik, indem Sie WebApplicationFactory<TStartup> erben
     • Verwenden Sie die EF Core In-Memory-Datenbank für Integrationstests
     • Schreiben Sie Integrationstests für API(s) mit xUnit.net

8. Synchrone Inter-Service-Kommunikation mit gRPC und HTTP2

   • Erstellen Sie mithilfe von gRPC eine Gateway-API und eine interne API, die synchron miteinander kommunizieren

9. Asynchrone Kommunikation zwischen Diensten mithilfe von Message Queues

   • Erstellen Sie eine Gateway-API und interne API(s) (Azure-Funktion), die mithilfe von Azure Service Bus asynchron miteinander kommunizieren.

10. Hosten der ASP.NET 6-API-Anwendung

    • Hosten Sie die ASP.NET 6-API-Anwendung mit IIS und veröffentlichen Sie den Ordner
    • Hosten Sie die ASP.NET 6-API-Anwendung mit Azure App Service und veröffentlichen Sie sie manuell