レガシーシステムとモダンAPIの間での『データ型の暗黙の変換』がなぜ本番で問題になるのか

// API から返ってくるデータ
const response = {
  amount: "1000",      // 文字列？数値？
  quantity: "00050",   // ゼロパディング
  price: "99.99"       // 小数
};

// 単純な変換
const total = Number(response.amount) * Number(response.quantity);
// 1000 * 50 = 50000 (正しい)

// しかし、データに空白が含まれていたら？
const amount2 = "1000 ";  // 末尾に空白
Number(amount2);  // → 1000 (JavaScript は許容)

// しかし他の言語では？
Integer.parseInt("1000 ");  // Java → NumberFormatException

// レガシー側の戻り値
{
  optional_field: ""  // NULL なのか、本当に空文字列なのか？
}

// API側での処理
if (data.optional_field) {
  // 空文字列は falsy なので、ここに入らない
}

// しかし DB 側では
INSERT INTO table (field) VALUES ("");  // 空文字列として保存
// vs
INSERT INTO table (field) VALUES (NULL);  // NULL として保存
// → 後続の集計クエリで結果が異なる

// API から返ってくる価格
const price = 0.1 + 0.2;  // JavaScript では 0.30000000000000004
const quantity = 100;
const total = price * quantity;  // 30.000000000000004

// DB に保存するとき
Math.round(total * 100) / 100;  // 30.00 に丸まる
// しかし、複数の計算が重なると、丸めの誤差が蓄積する

// ❌ 暗黙の変換に頼る
const amount = response.amount * 1;

// ✅ 明示的に変換し、失敗時は例外を発生させる
function parseAmount(value) {
  const trimmed = String(value).trim();
  if (!/^\d+(\.\d{1,2})?$/.test(trimmed)) {
    throw new Error(`Invalid amount format: ${value}`);
  }
  return parseFloat(trimmed);
}

const amount = parseAmount(response.amount);

// 本番から抽出した実データセット
const realData = [
  { amount: "00001000", expected: 1000 },
  { amount: "1000   ", expected: 1000 },  // スペースパディング
  { amount: "0", expected: 0 },
  { amount: "999999999", expected: 999999999 }
];

realData.forEach(({ amount, expected }) => {
  const result = parseAmount(amount);
  console.assert(result === expected, `Failed for ${amount}`);
});

// Express.js の例
app.get('/api/items/:id', (req, res) => {
  try {
    const data = fetchFromLegacy(req.params.id);
    
    // 各フィールドを検証して返す
    const validated = {
      amount: validateAmount(data.AMOUNT),
      quantity: validateQuantity(data.QUANTITY),
      date: validateDate(data.DATE)
    };
    
    res.json(validated);
  } catch (error) {
    res.status(400).json({ error: error.message });
  }
});