AspNet6InDepth

ASP.NET 6を詳しく学ぶ

1. ASP.NET 6の概要

   • 歴史と裏話
   • バージョン管理戦略
   • インストール
   • プロジェクトの構造
   • .NET SDK

2. ASP.NET 6 の基礎

   • .NET SDKを使用したASP.NET 6 APIアプリケーションのスキャフォールディング
   • 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インターフェイスから構成を読み取ります。
     • オプションパターン
       • IOptionsインターフェイスを使用して、厳密に型指定された C# POCO に構成をバインドする
       • IOptionsSnapshotまたはIOptionsMonitorインターフェイスを使用して、実行時に厳密に型指定された C# POCO にリロードできるバインド構成
   • HttpContext 、 HttpContext.RequestおよびHttpContext.Responseについて
   • 属性ルーティング
     • Route属性を使用して複数のルートをコントローラーにバインドする
     • Route パラメーターを使用してアクション メソッドにパラメーターを渡す
     • アクション動詞HttpGetAttribute 、 HttpPostAttribute 、 HttpPutAttribute 、 HttpPatchAttributeおよびHttpDeleteAttribute
   • モデルバインディング
     • 次のソースからのモデルバインド
       • FromQuery : クエリ文字列から値を取得します
       • FromRoute : ルートデータから値を取得します
       • FromForm : 投稿されたフォームフィールドから値を取得します
       • FromBody : リクエスト本文から値を取得します
       • FromHeader : HTTP ヘッダーから値を取得します
   • IActionResultまたはActionResultを使用して応答を処理する
   • Acceptヘッダーを使用してコンテンツ ネゴシエーションを処理する
     • Acceptヘッダーがapplication/xmlに設定されている場合は XML 応答を送信します
     • Acceptヘッダーがapplication/jsonに設定されている場合は、JSON 応答を送信します
   • .NET6 API のバージョン管理
   • HTTP Patchタイプのリクエストを処理する
   • モデルの検証
     • データ注釈属性の使用
       • Compare : モデル内の 2 つのプロパティが一致するかどうかを検証します。
       • EmailAddress : プロパティに電子メール形式があるかどうかを検証します。
       • Phone : プロパティに電話番号形式があるかどうかを検証します。
       • Range : プロパティ値が指定された範囲内にあるかどうかを検証します。
       • RegularExpression : プロパティ値が指定された正規表現と一致するかどうかを検証します。
       • Required : フィールドが null でないかどうかを検証します。
       • StringLength : 文字列プロパティ値が指定された長さ制限を超えていないかどうかを検証します。
       • Url : プロパティが URL 形式であるかどうかを検証します。
     • Fluent メソッドを使用した FluentValidation 検証
   • HTTPクライアント
     • IHttpClientFactory.CreateClient();を使用して基本的な IHttpClientFactory を作成します。
     • 名前付き HttpClient
     • 型指定された HttpClient
     • 共通ロジックを実行するための DelegatingHandler を HTTP クライアントに追加する
     • Polly ライブラリを使用して HTTP 例外を処理する
   • フィルター
   • レスポンスボディを圧縮する
     • gzipアルゴリズムを使用して応答圧縮を追加する
   • グローバリゼーションとローカリゼーション
   • レート制限
     • AspNetCoreRateLimit nuget パッケージとメモリ プロバイダーを使用したレート制限。
     • Azure Cache for Redis プロバイダーでAspNetCoreRateLimitおよびAspNetCoreRateLimit.Redis nuget パッケージを使用したレート制限。
   • ロギング
     • ログレベルを理解する
     • ILogger拡張メソッドを使用してログを記録する
       • logger.LogTraceログ トレース レベル メッセージ
       • logger.LogDebugログのデバッグ レベルのメッセージ
       • logger.LogInformationログ情報レベルのメッセージ
       • logger.Warningログの警告レベルのメッセージ
       • logger.Errorログのエラー レベル メッセージ
       • logger.Criticalログのクリティカル レベルのメッセージ
     • Azure AppInsights SDK を使用してログを記録する
   • ホスト型サービス
     • IHostedServiceインターフェイスを使用してホストされたサービスを実装する
     • BackgroundServiceクラスをオーバーライドしてバックグラウンド サービスを実装する
   • Automapper nuget パッケージを使用してオブジェクトをある型から別の型にマッピングする
   • メディエーターパターン
     • MediatR nuget パッケージを使用して疎結合サービスを実装する
   • 闊歩する
     • Swagger OpenAPI サポートを追加するためにSwashbuckle.AspNetCore nuget をインストールします
     • API 情報と説明を追加する
     • API レベルのメタデータの概要タグを追加する
     • OperationId をグループ API に追加する
     • オペレーションのメタデータを強化する
     • 応答メタデータを強化する
     • パラメータのメタデータを強化する
     • RequestBody メタデータを強化する
     • スキーマのメタデータを強化する
     • タグメタデータの追加
     • swagger.jsonルート レベルから提供するように swagger ルート プレフィックスを変更します
     • Swagger で表示される API を省略します
     • 複数の Swagger ドキュメントを生成する
   • 健康診断

3. ASP.NET 6 API アプリケーションでのデータ アクセス

   • Micro ORM Dapper と PostgreSQL を使用したデータ アクセス

     • Npgsqlをインストールする
     • Dapper Micro ORM をインストールする
     • Azure データスタジオをインストールする
     • PostgreSQL 用に Azure データベースを構成する
     • Dapper MicroORM を使用して CRUD API を公開し、次のエンドポイントを公開します
       • オフセット ページネーション/api/Persons?page=1&limit=10
       • キーセットのページネーション/api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • ID /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コア6をインストールする
     • Azure データスタジオをインストールする
     • PostgreSQL 用に Azure データベースを構成する
     • データベース内のモデル テーブルにDbSetを追加します
     • DbContext分析する
     • DbContext 拡張メソッドを使用してリポジトリ パターンを作成する
     • 構成を追加してデータベーステーブルに制約を追加する
     • シードデータを追加する
     • EF Core 移行スクリプトとidempotentオプションを使用して移行を追加する
     • EF Core ORM を使用して CRUD API を公開し、次のエンドポイントを公開します
       • オフセット ページネーション/api/Employees?page=1&limit=10
       • キーセットのページネーション/api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • ID /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646で単一を取得
       • /api/Employeesを作成する
       • /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646を更新します。
       • /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646を削除しています

4. ASP.NET 6 API アプリケーションでの応答キャッシュ

   • IMemoryCacheを使用したメモリ キャッシュの追加
   • Azure Cache for Redis とStackExchange.Redisを使用して分散キャッシュを追加する

5. ASP.NET 6 API アプリケーションのセキュリティ

   • 認証の追加

     • Claim 、 ClaimsIdentity 、およびClaimsPrincipal理解する
     • 基本認証の実装
     • Cookie認証を実装する
     • JWT認証の実装(カスタム)
       • BCrypt アルゴリズムとBCrypt.Net-Next nuget を使用してプレーン テキスト パスワードをハッシュする
       • System.IdentityModel.Tokens.Jwtを使用して JWT を生成する
       • 次の API を追加します
         • /api/Account/Registerでユーザーを登録します
         • /api/Account/Loginでユーザーをログインし、アクセス トークンとリフレッシュ トークンの初期セットを生成します。
         • /api/Account/Token送信されたリフレッシュ トークンを使用してアクセス トークンをリフレッシュします
         • /api/Account/Revokeでリフレッシュ トークンを取り消します

   • 権限の追加

     • ロールベースの認可を実装する
     • ポリシーベースの認可を実装する
       • ポリシーの「要件」を理解し、 IAuthorizationRequirementインターフェイスを実装する
       • HandleRequirementAsyncをオーバーライドしてカスタム ポリシー要件を作成します
       • Program.csにカスタム要件を登録する

   • ケーススタディ: Auth0 を使用した JWT 認証とロール認可の追加

     • OAuth2を理解する
     • OAuth2 の用語を理解する
     • OAuth フローを理解する
       • 暗黙的なフロー
       • クライアント認証情報のフロー
       • 認証コードの流れ
     • Auth0でアプリケーションを作成する
     • Auth0 でリダイレクト URL を設定する
     • Auth0 を使用してすべての API エンドポイントを保護する
     • API で権限を定義し、ポリシー認可を実行します。

6. ファイルのアップロードとファイルのダウンロードの処理

   • ファイルのアップロード
     • 単一または複数のファイルのアップロードを処理する
     • アップロードされたファイルをローカルのwwwroot folderに保存する
     • アップロードされたファイルを Azure Blob Storage Containers に保存する
   • ファイルのダウンロード
     • CSV ファイルを応答にストリーム配信する
     • Excel .xlsxファイルを応答にストリーム配信する

7. テスト

   • 単体テスト

     • xUnit.net使用して単体テストを追加する
     • [Fact]と[Theory]を理解する
     • コンストラクターを使用してテストデータを初期化する
     • Disposeメソッドを使用してテスト データをクリーンアップする
     • パラメータ化されたテストを作成する
       • [InlineData]を使用してプリミティブ パラメーターを渡します
       • [MemberData]を使用してプリミティブおよび複雑なパラメータを渡します
       • [ClassData]使用してプリミティブおよび複雑なパラメーターを渡します
     • IClassFixture使用して同じクラスでテスト コンテキストを共有する
     • ICollectionFixtureを使用して複数のクラス間でテスト コンテキストを共有する
     • Moqを使用して依存関係サービスをモックする
     • Verify()またはVerifyAll()を使用してモックされたサービスが呼び出されたかどうかを確認します。

   • 統合テスト

     • WebApplicationFactoryを継承してカスタム Web アプリケーション ファクトリを作成する
     • 統合テストに EF Core インメモリ データベースを使用する
     • xUnit.net使用して API の統合テストを作成する

8. gRPC と HTTP2 を使用した同期サービス間通信

   • gRPC を使用して相互に同期通信するゲートウェイ API と内部 API を構築する

9. メッセージキューを使用した非同期サービス間通信

   • Azure Service Bus を使用して相互に非同期通信するゲートウェイ API と内部 API (Azure Function) を構築します。

10. ASP.NET 6 API アプリケーションのホスティング

    • IIS とフォルダー公開を使用して ASP.NET 6 API アプリケーションをホストする
    • Azure App Service と手動発行を使用して ASP.NET 6 API アプリケーションをホストする