1. プログラミング勉強会
「いいコード」を書くには

2. いいコード
かいてますか？

3. 今回は。。。
ソフトウェアコンストラクションの最初の一歩
「ルーチン」の作成について学ぼう

4. ソフトウェアコンストラクショ
ン？
課題定義
コーディング
要求開発
コンストラクション計画
とデバッグ
単体テスト
概略設計
結合テスト
詳細設計
統合
システムテスト
保守

5. ソースコードこそが
常に最新のドキュメ
ント

6. 学習のステップ？
Step 1 •処理がちゃんと書ける
Step 2 •設計がちゃんとできる
Step 3 •いいものがつくれる！

7. お題のコードを
みんなで読んでみよ
う

8. こんなコード、書いてません
か？
public void moke(String fileName) {
if (isValidName(fileName)) {
if (file.exist()) {
if (key.isValid()) {
}
}
}
} ネストが深い！

9. ガード句
制御を早めに戻すための前提条件
ダメなときは早く上司に報告せい！

10. ガード句を使うと。。。
public void moke(String fileName) {
if (!isValidName(fileName)) return;
if (!file.exist()) return;
if (!key.isValid()) return;
// メインの処理
}
ネストが浅くなっ
た！

11. 高品質なルーチン(関数)
の前に、ダメな例をみてみよう

12. 良いルーチン名
ルーチンが行うことをすべて説明する
意味のない動詞、あいまいな動詞、どっちつかず
の動詞を使わない
run()じゃ何やるか、理解できない

13. 良いルーチン名
ルーチン名を数字だけで区別しない
Hoge() { do1(); do2(); do3(); }なんてのは論外
必用な長さのルーチン名にする
長い名前は理解しにくい
関数名には戻り値の説明を反映させる
Voidな関数は効果的な動詞とオブジェクトを
オブジェクトに対して何か操作する関数

14. 良いルーチン名
正確な反意語を
add/remove
begin/end
get/set(put)

15. 良いルーチン名
一般的な処理の規約を
ある場所ではid.get()が使われ、別の場所ではgetId()
が使われたり とかしてるとわからなくなる

16. 引数のルール
順序は、引数の似たルーチンに合わせる
似たルーチンの第一引数がユーザー名なら、今から
作るルーチンの第一引数もユーザー名にしておく
Write(配列, offset, 長さ)の順 とか
すべての引数を使う
引数を作業用変数として使わない
面倒でも、最初に作業用変数に代入しておこう

17. ちょっとしたルール
で
コードのよさ（保守
性）は