はじめに
最近、コードを書いて気づいた「命名・例外・引数」の扱いについて、可読性や安全性を意識した考え方を自分なりにまとめてみました！
命名のポイント
- メソッドは動詞一言で
- 連番（getData1など）は避ける
- 命名で処理の意図を表すのが基本
コメントに頼らない設計
- 命名で意味を伝える
- コメントは変更漏れのリスクがある
戻り値は意味のあるクラスで
- int や String よりも UserId 等の専用クラスを使うと混乱が減る
引数は final ＋ 意味のある命名
- final指定で安全性UP
- newUser、dbUserなどで状態を明確に
例外は throw で明確に
- -1やnull返しはバグの元
- IllegalArgumentExceptionなどを活用
- 独自例外も視野に！
おわりに
こうした設計の小さな工夫が、長期的に安全で読みやすいコードにつながると実感しています。もっと良いやり方やフィードバックがあればぜひ教えてください！