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: Interfaces: Names should be in CamelCase. They tend to have a name that describes an operation that a class can do: インタフェース名:インタフェース名にもアルパカ式の名前を付けるべきで、できるだけこのインタフェースを実現するクラスが持つ機能を説明します: Methods: Names should be in mixed case. Use verbs to describe what the method does: メソッド名:メソッド名はハイブリッドネーミングを使用し、このメソッドの役割を記述するために動詞でネーミングする必要があります: Variables: Names should be in mixed case. The names should represent what the value of the variable represents: 変数名:変数名はハイブリッドネーミングを使用するべきで、変数名はこの変数の意味を反映することができるべきである: Constants: Names should be in uppercase. 定数名:定数名大文字フォントを使用する必要があります: ---EOF---
Visiting original tutorial website by click here.
名前の約束は何ですか.
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:
大文字と小文字を正しく使用することは、命名規則に従う鍵です.
標準Java命名規則
The below list outlines the standard Java naming conventions for each identifier type:
次に、異なる識別子の標準Java命名規則を羅列します.
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
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
void calculateTax()
string getSurname()
void calculateTax()
string getSurname()
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
}
static final int DEFAULT_WIDTH
static final int MAX_HEIGHT
static final int DEFAULT_WIDTH
static final int MAX_HEIGHT
Visiting original tutorial website by click here.