コメント
Javaのコメントは３種類の書き方ができます．
一行コメント
// 以降改行までがコメントとして扱われます．
例
Integer answer = 1 + 1; // この部分がコメント．
// 改行すると別のコメントとして扱われるため，再度コメント記号が必要．
通常コメント
/* と */ で囲まれた部分がコメントとして扱われます．
C言語と同じスタイルです．
このコメントを入れ子にすることはできません．
例
/* この部分がコメントです． */
/* この部分がコメントです．
複数行に分かれていてもOK！ */
Integer answer = 1 + 1;
/* この部分がコメントです．
Integer answer = 1 + 1; // 途中に１行コメントが含まれていてもOK
*/
Javadoc コメント
/** と */ で囲まれた部分がコメントとして扱われます．
通常コメントと同じような書き方ですが，このコメントが書ける場所は次の３つに限られています．
次の3つ以外の場所にJavadocコメントが書かれると通常コメントとして扱われます．
- クラス宣言の前，
- メソッド宣言の前．
- フィールド宣言の前．
- フィールド宣言とは，クラス宣言の内側，かつ，メソッド宣言の外側で定義された変数を指します．
javadoc コマンドにより，ソースファイルからドキュメントを生成できますが，その時にドキュメントに掲載する文章をこのコメントで記します．
この授業では扱いません．
例
/**
* クラスに対するJavadocコメント．
* このクラスの役割などを書く．
*/
public class SampleClass{
/**
* フィールドに対するJavadocコメント．
* このフィールドの役割などを書く．
*/
String stringField = "string"; // フィールドの宣言
/**
* メソッドに対するJavadocコメント．
* このメソッドの役割などを書く．
*/
public static void main(String[] args){
// 何らかの処理．
}
}