How to Naming in Java(翻訳)


What Is a Naming Convention?
名前の約束は何ですか.
A naming convention is a rule to follow as you decide what to name your identifiers (e.g. class, package, variable, method, etc..).
ネーミング・ルールは、識別子のネーミングを準備するためのルールです(クラス名、パッケージ名、変数名、メソッド名など)
Why Use Naming Conventions?
なぜ命名規則を採用するのですか?
Different Java programmers can have different styles and approaches to the way they program. By using standard Java naming conventions they make their code easier to read for themselves and for other programmers. Readability of Java code is important because it means less time is spent trying to figure out what the code does, leaving more time to fix or modify it.
異なるJavaプログラマーには異なるコードスタイルがあるかもしれませんが、コードの約束を使用することで、作者自身に対しても他のプログラマーに対してもJavaコードを読みやすくすることができます.可読性の良いプログラムコードは非常に重要であり、これは私たちがこれらのコードの役割を理解するのに少ない時間を費やし、これらのコードを修正し、改善するためにより多くの時間を残すことができることを意味します.
To illustrate the point it's worth mentioning that most software companies will have a document that outlines the naming conventions they want their programmers to follow. A new programmer who becomes familiar with those rules will be able to understand code written by a programmer who might have left the company many years before hand.
多くのソフトウェア会社には、従業員に従うように要求される命名規則のドキュメントがあります.新しく来たプログラマーは、これらの命名規則を熟知すると、先輩たちが書いたコードを簡単に理解することができます.これらのコードのオリジナル作者はこの会社を何年も離れているかもしれませんが.
Picking a Name for Your Identifier
あなたの識別子に名前を付けます
When choosing a name for an identifier make sure it's meaningful. For instance, if your program deals with customer accounts then choose names that make sense to dealing with customers and their accounts (e.g., customerName, accountDetails). Don't worry about the length of the name. A longer name that sums up the identifier perfectly is preferable to a shorter name that might be quick to type but ambiguous.
識別子に名前を付けるときは、名前が意味があることを確認します.たとえば、プログラムが顧客アカウントと付き合っている場合は、customerName、accountDetailsのような識別子を名前にする必要があります.識別子の長さに注意しないでください.長い識別子は、叩くのが遅いが、叩くのが速いが意味があいまいな短い識別子よりも明確な意味を持つことができます.
A Few Words About Cases
アルファベットの大文字と小文字の規則について
Using the right letter case is the key to following a naming convention:
大文字と小文字を正しく使用することは、命名規則に従う鍵です.
  • Lowercase is where all the letters in a word are written without any capitalization (e.g., while, if, mypackage).
  • 小文字フォントは、指標識別子に大文字がない(例えば、while,if,mypackage).
  • Uppercase is where all the letters in a word are written in capitals. When there are more than two words in the name use underscores to separate them (e.g., MAX_HOURS, FIRST_DAY_OF_WEEK).
  • 大文字フォントは指標識別子の中ですべて大文字であり、1つの識別子の中で1つ以上の単語がある場合、私たちは下線でこれらの単語(例えばMAX_HOURS、FIRST_DAY_OF_WEEK)を分離すべきである.
  • CamelCase (also known as Upper CamelCase) is where each new word begins with a capital letter (e.g., CamelCase, CustomerAccount, PlayingCard).
  • アルパカ式命名(大アルパカ式とも呼ばれる)とは、新しい単語ごとに大文字で始まるが、他の場所では小文字(例えば、CamelCass、CustomAccount、PlayingCard)である.
  • Mixed case (also known as Lower CamelCase) is the same as CamelCase except the first letter of the name is in lowercase (e.g., hasChildren, customerFirstName, customerLastName).
  • ハイブリッドネーミング(アルパカ式とも呼ばれる)はアルパカ式と同様に、最初のアルファベットが小文字(hasChildren、customerFirstName、customerLastNameなど)にすぎない.
  • Standard Java Naming Conventions
    標準Java命名規則
    The below list outlines the standard Java naming conventions for each identifier type:
    次に、異なる識別子の標準Java命名規則を羅列します.
  • Packages: Names should be in lowercase. With small projects that only have a few packages it's okay to just give them simple (but meaningful!) names:
     package pokeranalyzer
     package mycalculator 
    In software companies and large projects where the packages might be imported into other classes, the names will normally be subdivided. Typically this will start with the company domain before being split into layers or features:
     package com.mycompany.utilities
     package org.bobscompany.application.userinterface 
  •          ,                    (      ),  :
     package pokeranalyzer
     package mycalculator 
  •                ,                 ,          。               ,       ,  :
     package com.mycompany.utilities
     package org.bobscompany.application.userinterface 
  • Classes: Names should be in CamelCase. Try to use nouns because a class is normally representing something in the real world:
     class Customer
     class Account 
  •            ,          ,                    :
     class Customer
     class Account 
  • Interfaces: Names should be in CamelCase. They tend to have a name that describes an operation that a class can do:
     interface Comparable
     interface Enumerable 
    Note that some programmers like to distinguish interfaces by beginning the name with an "I":
     interface IComparable
     interface IEnumerable 
  • インタフェース名:インタフェース名にもアルパカ式の名前を付けるべきで、できるだけこのインタフェースを実現するクラスが持つ機能を説明します:
     interface Comparable
     interface Enumerable 
    一部のプログラマーはインタフェース名の前に「I」を加えてクラス名と区別するのが好きです:
     interface IComparable
     interface IEnumerable 
  • Methods: Names should be in mixed case. Use verbs to describe what the method does:
     void calculateTax()
     string getSurname() 
  • メソッド名:メソッド名はハイブリッドネーミングを使用し、このメソッドの役割を記述するために動詞でネーミングする必要があります:
     void calculateTax()
     string getSurname() 
  • Variables: Names should be in mixed case. The names should represent what the value of the variable represents:
     string firstName
     int orderNumber 
    Only use very short names when the variables are short lived, such as in for loops:
     for (int i=0; i<20;i++)
     {    //i only lives in here
     } 
  • 変数名:変数名はハイブリッドネーミングを使用するべきで、変数名はこの変数の意味を反映することができるべきである:
     string firstName
     int orderNumber 
    変数の役割ドメインが小さい場合にのみ短い変数名を使用し、例えば循環文:
     for (int i=0; i<20;i++)
     {    //i only lives in here
     } 
  • Constants: Names should be in uppercase.
     static final int DEFAULT_WIDTH
     static final int MAX_HEIGHT 
  • 定数名:定数名大文字フォントを使用する必要があります:
     static final int DEFAULT_WIDTH
     static final int MAX_HEIGHT 
  • ---EOF---
    Visiting original tutorial website by click here.