Javaの「変数」「メソッド」「定数」名の“ひんしゅくを買わない”付け方

「Java」のソースコードを書く上で、標準的な命名規則に従うことは重要だ。変数、メソッド、定数を定義する際に従うべき命名規則をまとめた。

公開 2021年08月07日 05時00分

著者

Cameron McKenzie

[TechTarget]

印刷する連載新着通知を受け取る

　プログラミング言語および開発・実行環境「Java」では、変数、クラス、メソッド（データに対する処理）の命名に関する言語仕様上の規則はかなり緩い。変数名はアラビア数字で始まることはできない。2文字目以降には文字と数字が利用できる。ただしJavaがあらかじめ特定の用途で用いている単語（予約語）と同じ変数名にはできない。

　Javaの慣例的な命名規則は、もう少し複雑だ。例えばJavaの変数名はドル記号（$）やアンダースコア（_）から始まることができるが、そうした変数名を付ける人はほとんどいない。ソースコードエディターが、自動生成した変数の先頭にドル記号かアンダースコアを追加する場合がある。人による記述ではないことを強調するためだ。これはあくまで例外だと言える。

併せて読みたいお薦め記事

Javaについて知る

さまざまな命名規則

　前後編にわたりJavaの命名規則を紹介する。

覚えておきたい「変数」の命名規則

　慣例的に、Javaの変数名は先頭を小文字にする。Javaの変数名はスペースを含むことができない。複数の単語から成る変数名は「ローワーキャメルケース」で記述することになる。ローワーキャメルケースは、複数の単語を連結した文字列において、先頭の文字を小文字にし、2つ目以降の各単語の先頭を大文字にする表記法だ。キャメルはラクダの意味で、ローワーキャメルケースは「ドロメダリーケース」（ドロメダリーはヒトコブラクダを指す）とも呼ばれる。

　Javaの標準的な命名規則に従った変数名の3つの例を以下に示す。

index
firstName
timeToFirstLoad

覚えておきたい「メソッド」の命名規則

　メソッドの命名規則もローワーキャメルケースだ。Javaで文字列を扱うためのクラス「String」における適切なメソッド名の3つの例を以下に示す。

compareToIgnoreCase
copyValueOf
equalsIgnoreCase

覚えておきたい「定数」の命名規則

　ローワーキャメルケースを適用しない例外は、定数値を持つ変数だ。Javaにおいて定数値を保持する変数は、宣言時に修飾子（変数の性質を決定する文字列）として「static」または「final」を指定して定義する。これらの変数名は「スクリーミングスネークケース」で命名する慣例がある。スクリーミングスネークケースは、全ての文字を大文字にし、単語をアンダースコアで区切る命名規則だ。

　JavaのWebアプリケーション開発用フレームワーク（特定の設計思想に基づくプログラム部品やドキュメントの集合体）「Spring Boot」で定義されている定数名の例を以下に示す。