Javaコーディング標準

　Javaを使ったアプリケーション開発におけるコーディング行程での作業標準については、独自のものを起案するのもいいが、一般に開示されているものから適当と思われるものを採用するのも良案と考える。
そんな中で、

という点で、Scotte W. Ambler 氏の

「Writing Robust Java Code（頑健なJavaプログラムの書き方）」 （オリジナル（英文）［HTML ｜PDF］｜和訳）

を薦める。

ただし、当書では、いくつかの項目については複数の方式を提示している。
それらについては、以下の選択が良いと考える。

3.1.1 フィールドの命名には完全な英語記述を使う
3.1.2 コンポーネント(ウィジェット)の命名

　別の記法として紹介されているハンガリアン記法や先頭または末尾にアンダースコアを使用する記法は使用しない。

5.1 パラメータの命名

　原則としてフィールドを直接アクセスするのはアクセッサメソッドに限ることとするので、パラメータ名とフィールド名が同じであった場合の問題は起きない。
唯一問題が発生するアクセッサメソッドにおいては、種々の IDE のコード生成ウィザードが採用していることもあり、5.1.3 の this を使用する方式を採用する。

　当書には従わず、別の方式とする事項については、以下のようにする。

1.4.1 コメント

　当書では、

                /*
                   hogehoge
                 */

としているが、多くのの IDE のコード生成ウィザードでもそうしていることから、

                /*
                 * hogehoge
                 */

とする。

6.1.4.2 メソッドとフィールドの順序

　原著では、メソッドとフィールドを一緒にして可視性の順にするとしているが、一般的にはメソッドとフィールドは分けて考え、フィールドを先に記載する場合が多い。
また、多くのの IDE のコード生成ウィザードでもそうしていることから、フィールドを先に、次にメソッドを記載することとする。
また、メソッドの順序は、可視性の順ではなく、機能的は意味合いでグルーピングする。

　また、当書では規定していないが、以下については記載のようにすることとする。

抽象クラス，実装クラス，例外の命名
- 抽象クラスは、Abstruct から始める。
- インターフェースの実装クラスは、Impl で終わる。
  ※ RMI,EJBのホームインターフェース，リモートインターフェースの場合は特に。
- 例外は、Exception で終わる。

ファクトリメソッド，コンバータメソッドの命名
- ファクトリメソッドは、new または create から始める。
- コンバータメソッドは、to から始める。

参考文献

そのほかのコーディング標準