⚙️ カテゴリハンドラ

カテゴリハンドラは Express ミドルウェアではなくルートパイプライン関数です。params と context から RouteHandlerPayload の値を読み取り、成功した値を context.data にマージするか、成功した Result を HTTP レスポンス記述子で終了します。

インベントリ

ハンドラ	パイプラインの役割	入力 / context	結果 / 動作 / エラー	ルートでの使用
createCategory	ハンドラ	空でない requestBody、context.db.categories	categoryId を書き込み；ベースエンティティを作成；失敗時に 400 または 500。	createCategoryRoute
getCategoryById	ハンドラ	context.data.categoryId またはパス categoryId、context.db.categories	category を書き込み；失敗時に 400、404、または 500。	createCategoryRoute、getCategoryRoute、updateCategoryRoute
findCategories	ハンドラ	requestQuery、context.db.categories	一致する categories を書き込み；クエリ失敗時に 500。	findCategoriesRoute
updateCategory	ハンドラ	カテゴリ ID、空でない requestBody、context.db.categories	ベースエンティティフィールドを更新し、更新結果を書き込み；400、404、または 500。	updateCategoryRoute
deleteCategory	ハンドラ	カテゴリ ID、context.db.categories	一致するカテゴリを削除し、削除結果を書き込み；400、404、または 500。	deleteCategoryRoute
enableCategory	ハンドラ	カテゴリ ID、context.db.categories	status を 'active' に設定；400、404、または 500。	enableCategoryRoute
disableCategory	ハンドラ	カテゴリ ID、context.db.categories	status を 'inactive' に設定；400、404、または 500。	disableCategoryRoute
normalizeCategoryTerminator	ターミネータ	context.data.category	_id を削除しカテゴリを1件返却；データ欠損は 500。	createCategoryRoute、getCategoryRoute、updateCategoryRoute
normalizeCategoriesListTerminator	ターミネータ	context.data.categories	_id を削除しページネーションメタデータを保持；形状無効は 500。	findCategoriesRoute
deleteCategoryTerminator	ターミネータ	context.data.deleteCategory	{ statusCode: 204 } を返却；データ欠損は 500。	deleteCategoryRoute
enableCategoryTerminator	ターミネータ	context.data.enableCategory	{ statusCode: 204 } を返却；データ欠損は 500。	enableCategoryRoute
disableCategoryTerminator	ターミネータ	context.data.disableCategory	{ statusCode: 204 } を返却；データ欠損は 500。	disableCategoryRoute

詳細

createCategory

実装

空のボディを 400 で拒否し、createBaseEntity(requestBody) を挿入して生成された id を categoryId として書き込みます。データベースの失敗は 500、欠損した insertedId は 400 を返します。createCategoryRoute で使用されます。

getCategoryById

実装

パスパラメータより前に context.data.categoryId を使用します。ID 欠損は 400、データベースの失敗は 500、一致するカテゴリなしは 404 です。createCategoryRoute、getCategoryRoute、updateCategoryRoute で使用されます。

findCategories

実装

requestQuery（または {}）を直接 categories.find に渡し、カーソルを配列に変換して categories を書き込みます；データベースの失敗は 500 です。エクスポートされたルートでは、withPagination がこのハンドラの前に page と limit を削除し、toArray() をページネーションされた { data, metadata } 結果に変更します。findCategoriesRoute で使用されます。ページネーションはそのルートの withPagination ラッパーによって適用されます。

updateCategory

実装

ID と空でないボディを要求し、updateBaseEntity(requestBody) を適用します。ID またはボディの欠損は 400；一致なしは 404；変更なしは 400 です。updateCategoryRoute で使用されます。

deleteCategory

実装

ID で削除し deleteCategory を書き込みます。ID 欠損は 400、削除なしは 404、データベースの失敗は 500 です。deleteCategoryRoute で使用されます。

enableCategory

実装

updateBaseEntity({ status: 'active' }) でカテゴリを更新します。ID 欠損は 400、一致なしは 404、変更なしの結果は 500 です。enableCategoryRoute で使用されます。

disableCategory

実装

updateBaseEntity({ status: 'inactive' }) でカテゴリを更新します。ID 欠損は 400、一致なしは 404、変更なしの結果は 500 です。disableCategoryRoute で使用されます。

normalizeCategoryTerminator

実装

パイプラインエラーをスローするか、context.data.category が欠損している場合に 500 をスローします；それ以外の場合は MongoDB _id なしでカテゴリを返却します。createCategoryRoute、getCategoryRoute、updateCategoryRoute で使用されます。

normalizeCategoriesListTerminator

実装

パイプラインエラーをスローするか、categories が配列またはページネーションされた { data, metadata } 値でない場合に 500 をスローします。返却されるすべてのカテゴリから _id を削除します。エクスポートされたルートでは、ページネーションされた入力は常に { data, metadata: { pagination } } に正規化されます。findCategoriesRoute で使用されます。

deleteCategoryTerminator

実装

パイプラインエラーをスローするか、deleteCategory が欠損している場合に 500 をスローします；それ以外の場合は { statusCode: 204 } を返却します。deleteCategoryRoute で使用されます。

enableCategoryTerminator

実装

パイプラインエラーをスローするか、enableCategory が欠損している場合に 500 をスローします；それ以外の場合は { statusCode: 204 } を返却します。enableCategoryRoute で使用されます。

disableCategoryTerminator

実装

パイプラインエラーをスローするか、disableCategory が欠損している場合に 500 をスローします；それ以外の場合は { statusCode: 204 } を返却します。disableCategoryRoute で使用されます。