PostgresからAPIへのJSONパススルーを設計
PostgreSQL関数が完成したJSONを返し、Go APIがそのまま転送するJSONパススルー構成を設計。中間のアンマーシャリングをなくし、フロントエンドをスキーマ変更から切り離した。
実施時期: 2025
データベースからブラウザーへ直接届くJSON
状況. 通常、データベースからブラウザーへは、変換を連ねてデータを渡す。DBが行を返し、APIが構造体へ読み込み、形を変え、JSONへ再変換して、ようやく外へ送る。各段階にコードとテストが必要で、APIとDBの認識が食い違う場所も増える。
課題. この変換の中継を省くことを考えた。DBが完成した応答を返せば、APIはそのまま通し、フロントエンドもGo内の手作業で維持する複製ではなく、DBの構造に直接依存できる。
行動. 直接通過させる構成にした。PostgreSQL関数が、データのある場所で、SQLの責任としてJSON応答全体を組み立てる。Goハンドラーはjson.RawMessageで受け取り、分解も再符号化もせず転送する。小さなQueryJSON補助関数で、意識して覚えなくてもこの方法が最も簡単な実装になるようにした。従来の多層APIで増えるDTO、マッパー、応答構造体など、中間の仕組みが不要になった。
結果. ハンドラーが大幅に短くなり、特にフロントエンドとGoの結合がなくなった。関数の返す内容を変えれば、ハンドラーを1行も直さず新しい形がクライアントへ届く。可動部分が減り、層間の不一致という種類の問題自体が存在しなくなった。

写真: Wuestensohn2000 / Pixabay 
写真: wal_172619 / Pixabay
前の実績: システムの境界を明確にした海事プラットフォーム. 次に読む: 利用者の組織コンテキスト切り替えを構築. すべての実績はこちら: 実績紹介.

