Express– tag –
-
Docker 深掘り
Dockerfileの命令を1つずつ読む — EXPOSEを書いてもポートは開かない
他人の Dockerfile をコピーすると動く。でも1行ずつ何をしているかは分からないままになる。~/dockerlab に小さな Express アプリを作り、FROM だけの1行から命令を1つずつ足して、その都度ビルドして確かめる。latest が固定ではないこと、RUN cd が次の行に効かないこと、EXPOSE がドキュメントでしかないこと、shell形式だと docker stop が10秒待たされることを、実際に測って確認する。 -
React 深掘り
SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない
Viteで作ったReactアプリをビルドして配信し、curlでHTMLの中身を見ると 空の root 要素(div) しか入っていない。検索エンジンやSNSのクローラが見ているのはそれです。この記事では ~/ssrlab を新しく作り、まず症状をcurlで目に見せます。そのうえでCSR/SSG/SSR/ISRを「いつHTMLを作るか」の一本の軸で整理し、SSG(ビルド時に作る)を実際にやってcurlに本文が入るところを確認します。さらにExpressとrenderToStringで小さなSSRサーバーを自分で書き、フレームワークが何を代行しているのかを手で確かめます。山場はハイドレーションのズレで、new Date() と window を使ったコードでわざと警告とクラッシュを出してから直します。最後にNext.js・Remix・Astro・TanStack Startを同じ軸で対比し、SSRの代償と「とりあえずNext.js」をやめる判断表まで書きます。 -
React 深掘り
GraphQLクライアント — 一覧を出すのにAPIを4回叩く
一覧画面を1枚出すために、REST のエンドポイントを4回、多いときは21回叩いていた。そのうえ1件70項目も返ってきて、使うのは2項目だけだった。この記事では外部の公開APIを一切使わず、その「取りすぎ」と「足りない」を再現する小さな REST API を Express で自分で立て、転送量とリクエスト回数を実測する。次に graphql-yoga で GraphQL サーバーを自分で書き、まず curl の POST 1本だけで叩いて、同じ表で数字を比べる。そのうえで React 側に urql を入れ、ドキュメントキャッシュの素直さと限界を Network タブで確認する。Relay は思想が違うので、コンパイラを実際に走らせて「スキーマ側の規約を要求される」ところまで見て、個人開発では重いと結論を出す。最後に「GraphQL を入れない理由のほうが多い」判断基準を残す。 -
アプリ
全部書いてから動かさない — 作品のAPIと認証
作品づくりの2本目。練習用の ~/server は開けず、新しく ~/hitokoto を作るところから始めます。テーブルより先にマイグレーションを書き、外部キーの ON DELETE を用途で選び分ける。URLの一覧を表で先に決めてから、まず POST /api/books と GET /api/books の2本「だけ」を通す。動いたら次を足す。登録画面は作らず管理者1人を seed で用意し、書き込みだけログインを要求する。入力の検証とエラーの形を1つに揃え、公開用のAPIを別の道に分けて、画面が無いまま curl で全部確かめ、systemd で常駐させるところまで。 -
アプリ
Webhookは向こうから来る — Botと署名検証
APIは「こちらから聞きに行く」もの、Webhookは「向こうから来る」もの。この向きの違いが全部を決めます。まず最大の壁——自分のVMには外から届かない——をNATの話から正面で扱い、トンネル・VPS・ポート開放を比べます。次に受け口を作り、山場の署名検証をHMACで自分で書きます。ここで必ずハマる「express.json のあとでは検証できない」と「=== で比べてはいけない」も実際に起こします。さらに、遅いと再送されて二重実行されること、同じイベントIDが2回来ること(再送は仕様)に、200即返しと冪等化で対処します。最後に返信する側のトークン管理・レート制限・リトライ、そしてBotが荒らしにならないための設計まで。トークンはすべてダミーです。 -
バックエンド
APIの正体はJSONを返すHTTP — Node.jsで作る
前回の15行のサーバーを、そのままAPIに育てる。生のNodeでPOSTの本文を受け取り、第3段階で「フロントでは直せない」と書いたCORSを今度はサーバー側から解除する。最後にExpressで書き直して、ライブラリが何を肩代わりしていたのかを確かめる。 -
バックエンド
URLに動詞を入れない — REST APIの設計
/api/deleteTask?id=3 と書きたくなるのを、なぜ DELETE /api/tasks/3 にするのか。URLはモノ、メソッドが動詞。PUTとPATCHの違い、2回打っても壊れない設計(冪等性)、そして「無いIDを消したとき何を返すか」まで、前回のtasks APIを完成させながら決めていきます。
1