つくる: 検証つき関数群

エラー設計込みで組む

第4章の内容を全部使います。

作るのは、出品を受け付ける処理です。検証して、手数料を引いて、結果を返します。

関数を3つに分ける

1つの関数に全部書くと、どこが検証でどこが計算か読み取れません。役割で分けます。

submit から見ると、検証は「通ったか通らないか」だけ、手数料は「いくらか」だけです。中身を知らなくても組み立てられます。

エラーを返すか、文字列を返すか

submit は表示用の文字列を返します。ですが内部の関数はエラーを返すべきです。

文字列で返すと、呼ぶ側は「これは成功のメッセージか、失敗の理由か」を文字を見て判断することになります。error なら nil かどうかで機械的に分かります。

表示に直すのは、いちばん外側でやる。 これは Go に限らず通じる考え方で、第8章で HTTP のステータスコードを決めるときにも同じ判断が出てきます。

検証の順番

前のレッスンと同じく、上から順に見て最初の問題を返します。

複数の問題を全部集めて返す設計もありますが、入門では最初の1つで止めるほうが素直です。

順番に作る

1. validate は検証して error を返す。問題が無ければ nil
2. 検証の順番は 商品名が空 → 価格が0以下 → 価格が上限超え
3. 上限超えのエラーだけ fmt.Errorf で実際の価格を含める
4. feeOf は価格の10パーセントを切り捨てて返す
5. submit は成功なら 商品名 受取額N円、失敗ならエラーの理由を返す