頭字語を使用したJava命名規則[終了]

次のJavaクラスの正しい名前は何ですか： DVDPlayerまたはDvdPlayer？

答えはJavaにはこれに対する単一の標準がないということですので、.NET Framework設計ガイドラインでこれが指定されていることに注意したいと思います。

話題から外れると非難する前に、Javaと.NET Frameworkのクラス命名ガイドラインは非常に似ているため、.NETガイドラインは説得力のあるリファレンスとして役立ちます。

一般的なルール

どちらのガイドラインでも、頭字語が広く知られ、よく理解されている場合にのみ頭字語を使用することを推奨しています。DVDまたはXMLはこの優れた例です。すぐに認識できますが、拡張バージョンの認識には少し時間がかかります。

略語

.NET Frameworkガイドラインでは、識別子に2つの一般的な略語「ID」と「OK」を使用する場合があることを除いて、略語を使用しないことをお勧めします（頭字語ではありません）。省略形を使用する場合Id、キャメルケース識別子の最初の単語（PascalCase識別子とは対照的）を除いて、常に大文字と小文字が混在します。

Javaでは、この規則はたまにしか守られません。見てくださいスペルを混合する方法で、getIDかつgetIdJCLであるが。（そのページを途中までスクロールします）。ただし、Java 8バージョンでは、getIdがますます使用されており、PascalCaseの規則が今日では好まれています。可能な場合は、省略形を完全に避けることをお勧めします。

短い頭字語

.NET Frameworkガイドラインでは、「IO」のような2文字の頭字語は、両方の文字で同じ大文字にする必要があると述べています。したがって、PascalCase識別子（クラス名など）の場合はDBRate、キャメルケース識別子（ローカル変数など）の場合はが得られioChannelます。

これは間違いなくJavaでも一般的な慣習のようです。

長い頭字語

.NET Frameworkガイドラインでは、キャメルケース識別子の最初の単語を除いて、PascalCaseとキャメルケースの識別子には3文字以上の頭字語では大文字と小文字を混在させることを推奨しています。したがって、クラス名の場合はXmlDocumentローカル変数に名前を付けることができますhttpRequest。

この規則は、Javaでは常に守られているわけではありません。4文字の頭字語では通常、大文字と小文字が混在するように見えますが、JCLでも3文字の頭字語については一貫性がありません。それらのほとんどは、「URL」、「XML」、「SQL」、「DOM」のようにすべて大文字のように見えますが、「Jar」のようないくつかの例外があります。

結論

Javaの場合：

4文字以上の頭字語の場合は、大/小文字混合を使用してください。標準ライブラリはこれを行い、それはちょうど理にかなっています。

3文字の頭字語の場合は、JCLのようにすべて大文字を使用するか、.NET Frameworkのように大文字と小文字を混在させることができます。いずれにせよ、一貫している。

2文字の頭字語の場合は、すべて大文字を使用します。

2文字の省略形の場合、Javaには実際には標準がありませんが、他の名前との一貫性によってすべての大文字の見栄えがよくなる場合を除き、大文字と小文字を混在させることをお勧めします。

「正しい」答えはありません。他のツールをより効果的に使用するための一連のプラクティスと規則。

したがって、私は好むDvdPlayer。EclipseではCtrl+ Shift+ + できT、各単語の最初の文字でクラスを選択できるため、より便利です。

どちらも野生で使用されているのを見てきましたが、SunはそのDVDPlayerスタイルを好むようです。DvdPlayerただし、のように複数の頭字語が連続している場合でも、単語の境界がどこにあるかは明らかなので、私はを好みHTTPURLConnectionます。

次のようにして、クラスの個々のインスタンスを定義します。

Catalogue catalogue;
Person person;

したがって、を使用しDVDPlayerた場合、そのインスタンスを何と呼びますか？dVDPlayer？したがって、DvdPlayerクラス名を選択するので、インスタンスにのような名前を付けることができますdvdPlayer。

JavaSEクラス、Apache Commons、Springの例：

• HttpURLConnection
• HTTPAddress
• UrlPathHelper
• AopProxy
• ISBNValidator

だから-それは本当に重要ではありません。

効果的なJavaはDvdPlayerを好むようです。

他の人が示したように、それはプロジェクト間で異なるスタイルのものです。GuavaやGWTなどのGoogleプロジェクトは、このDvdPlayerスタイルを好みます。

https://google.github.io/styleguide/javaguide.html#s5.3-camel-case

sun java docsから：

クラス名は名詞であり、大文字と小文字が混在する大文字の各内部単語の最初の文字でなければなりません。クラス名はシンプルでわかりやすいものにしてください。単語全体を避け、頭字語や略語は使用しないでください（略語がURLやHTMLなどの長い形式よりもはるかに広く使用されている場合を除きます）。

DVDPlayer標準ですが、DvdPlayer珍しいことではありません。

あなたはしばしば見ないgetId。これはおそらく、IDが「ID」の短縮形であると考えているためです。これは、実際にはアイデンティティドキュメントのイニシャルです。

HttpURLConnection多くの場合、混合表記の例として示されています。ただし、URLでプロトコル名として使用される「http」は小文字である必要があります（大文字が受け入れられることがよくあります）。

「正しい」というのはなく、ここでの設定のみです。

Sunは、「URL」と「HTML」を含むクラスの命名方法に一貫性がありますが、Javadocでは、すべて大文字とキャメルケースの両方を使用するHTTPを使用しています。

個人的には、DvdPlayerを使用します。