【Node.js実戦習得】第7回：標準httpモジュールで自作する超シンプルWebサーバー（TS版）

1. Webサーバーの正体と「HTTPプロトコル」の深層構造

1. スタートライン（リクエストライン）： 「どのURL（パス）」に「どの方法（HTTPメソッド：GETやPOSTなど）」でアクセスするかという、通信の目的。
2. ヘッダー（Headers）： クライアントのブラウザ環境（User-Agent）、受け入れ可能なデータ形式（Accept）、送信するデータの種類（Content-Type）などの、メタ情報の塊。
3. ボディ（Body）： 新しくカートに追加したい商品情報など、具体的なデータの中身（※GETリクエストのときは基本的に空）。

2. 【ハンズオン】httpモジュールでカートAPIを起動する（データ取得編）

// src/index.ts
import { createServer, IncomingMessage, ServerResponse } from 'node:http';

const PORT = 3000;

// カート内商品の型定義
interface CartItem {
  id: number;
  productName: string;
  price: number;
  quantity: number;
}

// 疑似データベース（メモリ上に保持する配列）
let cartItems: CartItem[] = [
  { id: 1, productName: '熊木用高級キーボード', price: 35000, quantity: 1 },
  { id: 2, productName: 'Type-C 急速充電ケーブル 1.5m', price: 1800, quantity: 2 }
];

// 1. HTTPサーバーインスタンスを作成
// createServerの引数には、リクエストを検知したときに実行されるコールバック関数を渡す
const server = createServer((req: IncomingMessage, res: ServerResponse) => {
  const { method, url } = req;
  // サーバーのログとして、いつ、どのメソッドで、どこにアクセスが来たかを出力
  console.log(`[${new Date().toISOString()}] ${method} ${url}`);

  // 2. ルーティングの分岐：URLが「/api/cart」かつ メソッドが「GET」の場合
  if (url === '/api/cart' && method === 'GET') {
    // レスポンスヘッダーに「JSONを返しますよ」というContent-Typeを指定（日本語が化けないようにutf-8も必須！）
    res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });

    // 配列オブジェクトをJSON文字列に変換して送信し、通信を終了（end）する
    res.end(JSON.stringify(cartItems));
    return;
  }

  // 3. 該当するルーティングがない場合（404 Not Found）
  res.writeHead(404, { 'Content-Type': 'application/json; charset=utf-8' });
  res.end(JSON.stringify({ message: 'リクエストされたリソースが見つかりませんでした。' }));
});

// 4. 指定したポート番号でサーバーを起動（リスニング開始）
server.listen(PORT, () => {
  console.log(`標準モジュール・カートサーバーが起動しました！ http://localhost:${PORT}`);
});

npm run dev

実行結果（ターミナル）

標準モジュール・カートサーバーが起動しました！ http://localhost:3000

curl -i http://localhost:3000/api/cart

実行結果（ターミナル）

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Mon, 10 Aug 2026 12:00:00 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 172

[{"id":1,"productName":"熊木用高級キーボード","price":35000,"quantity":1},{"id":2,"productName":"Type-C 急速充電ケーブル 1.5m","price":1800,"quantity":2}]

3. 低レイヤの死闘：POSTリクエストと「ストリーム」の罠

/* 先ほどの createServer の中に以下を追加 */

  // 【POST /api/cart】 カートへの商品追加
  if (url === '/api/cart' && method === 'POST') {
    let body = '';

    // データの断片（chunk）が届くたびに、文字列として結合していく
    req.on('data', (chunk) => {
      body += chunk;
    });

    // すべてのデータが届き終わったら（end）実行されるイベント
    req.on('end', () => {
      try {
        // 届いた生の文字列を、手動でJSONオブジェクトにパース（解析）する
        const parsedData = JSON.parse(body);
        const { productName, price, quantity } = parsedData;

        // バリデーション（型チェックと必須チェック）
        if (!productName || typeof price !== 'number' || typeof quantity !== 'number') {
          res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' });
          res.end(JSON.stringify({ message: '不正なリクエストデータです。商品名、価格、数量を正しく入力してください。' }));
          return;
        }

        // 数量が0以下、または価格がマイナスの不正チェック
        if (quantity <= 0 || price < 0) {
          res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' });
          res.end(JSON.stringify({ message: '価格は0以上、数量は1以上である必要があります。' }));
          return;
        }

        // 新しいカートアイテムオブジェクトを作成（IDの自動採番）
        const newItem: CartItem = {
          id: cartItems.length > 0 ? Math.max(...cartItems.map(item => item.id)) + 1 : 1,
          productName,
          price,
          quantity
        };

        cartItems.push(newItem);

        // 201 Created で新しく追加されたアイテムを返却
        res.writeHead(201, { 'Content-Type': 'application/json; charset=utf-8' });
        res.end(JSON.stringify(newItem));
      } catch (error) {
        // JSONの構文エラー（カンマが抜けているなど）が起きた場合の例外ハンドリング
        res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' });
        res.end(JSON.stringify({ message: '不正なJSON形式です。パースに失敗しました。' }));
      }
    });
    return;
  }

4. カートAPIの動作確認：curlでのシミュレーション

# 別のターミナルを立ち上げるか、現在のプロセスを止めずに以下のコマンドを実行
curl -i -X POST -H "Content-Type: application/json" -d '{"productName":"AI機能搭載Webカメラ","price":10800,"quantity":1}' http://localhost:3000/api/cart

実行結果（新規作成成功・201 Created）

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Date: Mon, 10 Aug 2026 12:01:00 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 82

{"id":3,"productName":"AI機能搭載Webカメラ","price":10800,"quantity":1}

curl -i -X POST -H "Content-Type: application/json" -d '{"productName":"不正なデータ","price":"一万円","quantity":1}' http://localhost:3000/api/cart

実行結果（バリデーション発動・400 Bad Request）

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Date: Mon, 10 Aug 2026 12:02:00 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 114

{"message":"不正なリクエストデータです。商品名、価格、数量を正しく入力してください。"}

5. 実務での限界：なぜ標準モジュールだけで開発を続けないのか？

本日のまとめ

• Webサーバーの本質： 特定のポートで待機し、HTTP通信ルール（リクエスト）に基づいて、適切なルール（レスポンス）を返却し続けるプログラム。
• node:http モジュール： Node.js標準のコアモジュール。外部ライブラリなしでネイティブなWebサーバーを構築できる。
• ストリームの概念： POSTなどで送られてくるデータは一括ではなく、細切れ（チャンク）のバイナリで届くため、req.on('data') で結合する処理が必要。
• エラーハンドリングの重要性： データの欠損やJSONの構文エラーに対し、適切なステータスコード（400等）とエラーメッセージを返却しないと、フロントエンド側が原因を特定できなくなる。
• 標準モジュールの限界： URLやメソッドの条件分岐（ルーティング）やパラメータの解析をすべて自前で書く必要があり、規模が大きくなるとコードが破綻する。

---

次回：第8回「Expressフレームワーク入門！ECカートAPIの移行と型安全ルーティング」に続く