RESTfulなAPIへの理解

// GET /getUsers - 全ユーザを取得
app.get('/getUsers', function(req, res) {
  // コードで全てのユーザを取得
});

// GET /getUser?id=123 - 特定のユーザを取得
app.get('/getUser', function(req, res) {
  // コードで特定のユーザを取得
});

// GET /users - 全ユーザを取得
app.get('/users', function(req, res) {
  // コードで全てのユーザを取得
});

// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // コードで特定のユーザを取得
});

// POST /users - 新しいユーザを作成
app.post('/users', function(req, res) {
  // 前回のリクエストから状態を取得
  const previousRequest = getPreviousRequest(req);
  // 前回のリクエストの状態に基づいて新しいユーザを作成
});

// POST /users - 新しいユーザを作成
app.post('/users', function(req, res) {
  // req.bodyからユーザ情報を取得し、新しいユーザを作成
  // リクエスト間に依存性がなく、このリクエストだけで完結している。
});

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // 特定のユーザを取得し、その情報をHTMLとしてレンダリング
  // サーバーがクライアントの表示方法まで決定してしまっている
});

// クライアントサイド
fetch('/users/1')
  .then(response => response.text())
  .then(html => {
    // サーバーから返されたHTMLをそのまま表示
  });

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // 特定のユーザを取得し、その情報をレスポンスとして返す
  // サーバーはクライアントの表示方法については一切考慮しない
});

// クライアントサイド
fetch('/users/1')
  .then(response => response.json())
  .then(user => {
    // サーバーから取得したユーザ情報をどのように表示するかを決定
  });

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // 特定のユーザを取得し、その情報をレスポンスとして返す
  // しかし、キャッシュに関する情報が一切ない
});

// クライアントサイド
// クライアントはこのレスポンスを受け取った際、キャッシュに関する情報がないため、キャッシュするべきか判断できない

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // 特定のユーザを取得し、その情報をレスポンスとして返す
  // Cache-Controlヘッダを設定して、このレスポンスがキャッシュ可能であることを示す
  res.set('Cache-Control', 'public, max-age=3600');
});

// クライアントサイド
// クライアントはこのレスポンスを受け取った際、Cache-Controlヘッダを解釈し、適切にキャッシュする。

// クライアントサイド
// クライアントがサーバーの内部構造を知ってしまっている
fetch('/users/1?database=main&table=users')
  .then(response => response.json())
  .then(user => {
    // サーバーから取得したユーザ情報を表示
  });

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // データベースとテーブルはクライアントから指定される
  // これはレイヤードシステムの原則に反している
});

// クライアントサイド
fetch('/users/1')
  .then(response => response.json())
  .then(user => {
    // サーバーから取得したユーザ情報を表示
  });

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // データベースからユーザ情報を取得
  // この処理は中間層であり、クライアントはこの詳細を知らなくても良い
  // クライアントはエンドポイントだけを知っていれば良い
});

// サーバーサイド
// GET /getUsers - ユーザ一覧を取得
app.get('/getUsers', function(req, res) {
  // ...
});

// POST /createUser - 新しいユーザを作成
app.post('/createUser', function(req, res) {
  // ...
});

// POST /updateUser/:id - ユーザ情報を更新
app.post('/updateUser/:id', function(req, res) {
  // ...
});

// POST /deleteUser/:id - ユーザを削除
app.post('/deleteUser/:id', function(req, res) {
  // ...
});

// サーバーサイド
// GET /users/:id - 特定のユーザを取得
app.get('/users/:id', function(req, res) {
  // 特定のユーザを取得
});

// POST /users - 新しいユーザを作成
app.post('/users', function(req, res) {
  // 新しいユーザを作成
});

// PUT /users/:id - 特定のユーザを更新
app.put('/users/:id', function(req, res) {
  // 特定のユーザを更新
});

// DELETE /users/:id - 特定のユーザを削除
app.delete('/users/:id', function(req, res) {
  // 特定のユーザを削除
});