GoogleのJavaのスタイルガイドは、メソッド名を lowerCamelCase で書き、sendMessage や stop のように動詞か動詞句にするのが一般的だとしています(Google Java Style Guide)。
関数名でよく使う動詞の一覧
| 動詞 | 意味 | 例 |
|---|---|---|
| get | 取得する(手元にあるものをすぐ返す) | getUserName() |
| fetch | 外部(APIなど)から取ってくる | fetchOrders() |
| load | ファイルや保存先から読み込む | loadConfig() |
| find | 探す(見つからないこともある) | findUserByEmail() |
| create | 新しく作る | createInvoice() |
| add | 既存の集まりに加える | addItem() |
| insert | 位置を指定して挿入する・DBに入れる | insertRow() |
| update | 更新する | updateProfile() |
| delete / remove | 削除する/集まりから取り除く | deleteAccount(), removeTag() |
| save | 保存する | saveDraft() |
| calculate / compute | 計算する | calculateTax() |
| convert / to | 変換する | convertToJpy(), toString() |
| parse | 文字列を解析して構造にする | parseDate() |
| format | 表示用に整形する | formatPrice() |
| validate | 入力が正しいか検証する | validateEmail() |
| check | 条件を確かめる | checkStock() |
| handle | イベントや例外を処理する | handleClick() |
| send | 送る | sendNotification() |
| init / setup | 初期化する | initDatabase() |
| reset / clear | 初期状態に戻す/空にする | resetForm() |
迷いやすい動詞の使い分け
| グループ | 違い |
|---|---|
| get / fetch / load | get はすぐ返る取得、fetch はネットワーク越しの取得、load はファイルや保存先からの読み込みに使われることが多い |
| create / add / insert | create は新しく作る、add は集まりに加える、insert は位置を決めて差し込む |
| delete / remove | delete は存在ごと消す、remove は集まりから外す(物自体は残ることもある) |
| check / validate / verify | check は条件を確かめる全般、validate は形式や値が正しいか、verify は本物か・合っているかを照合する |
真偽値を返す関数の名前
true か false を返す関数は、変数と同じく質問の形にします:isEmpty()、hasAccess()、canDelete()、shouldShowBanner()、exists()。「check」で始めると、何を返すのか(真偽値なのか、例外を投げるのか)が分かりにくくなります。
変数名の単語は変数名の英語一覧にまとめています。
Devlingoで開発現場の英語を1日10フレーズ
Gambit StudioのDevlingo(English for Devs)は、開発者のための英語フレーズアプリです。デイリースタンドアップ、コードレビュー、Slack、プルリクエスト、バグ報告、面接など12カテゴリに3,600以上のフレーズを収録し、1日10個ずつ、使う場面と発音ガイド、例文つきで学べます。ホーム画面ウィジェットには今日のフレーズが表示されます。画面表示は英語などで、日本語には対応していません。