🔧 共通 ブロック
共通ブロックは、NodeBlocks アプリケーションの複数のエンティティで使用できる再利用可能なスキーマ、ルート、ハンドラー、機能を提供します。これらのブロックは、一貫性を維持し、重複を削減するために共有および再利用されるように設計されています。
🎯 概要
共通ブロックは次のことを目的として設計されています:
- 複数のエンティティ間で再利用可能なコンポーネントを提供する
- データ検証と API パターンの一貫性を維持する
- 共有スキーマとユーティリティを通じてコード重複を削減する
- ページネーションやレスポンスなどの共通操作の標準化をサポートする
- エンティティ固有のブロックとの構成を有効化する
📦 ブロックタイプ
🔍 スキーマ
共通データ検証のための JSON Schema 定義:
- Address Schemas: 異なるフォーマットと地域の住所検証
- Pagination Schemas: 標準化されたページネーションパラメーターとメタデータ
- Response Schemas: 共通 API レスポンス構造
- Utility Schemas: 共通操作のための再利用可能なユーティリティスキーマ
🔧 ブロック
ドメイン間で共有される再利用可能なロジック:
- redirectTo: ルートチェーンで HTTP リダイレクトを発行
- generateRandomPassword: 安全なランダムパスワードを作成
✅ バリデーター
ドメイン間で再利用するための汎用検証関数:
- checkIdentityType: ID タイプ構成に基づいてアクセスをゲート
- validateResourceAccess: 任意のリソースタイプのための汎用アクセス制御検証機能(非推奨)
- some: OR セマンティクスで検証機能を構成
- requireParam: パラメーター要件検証機能を作成するためのファクトリ関数
- isUUID: UUID フォーマット検証機能を作成するためのファクトリ関数
- isNumber: 数値フォーマット検証機能を作成するためのファクトリ関数
🔗 関連ドキュメント
- 共通スキーマブロック - 共通データ検証とコントラクト
- 共通バリデーターブロック - 共通検証関数
- ユーザーブロック - ユーザー固有のブロック
- 製品ブロック - 製品固有のブロック
- 組織ブロック - 組織固有のブロック