コメントでプログラムを詳細に解説しなくてはいけません。

Question

前提・実現したいこと

プログラムがなにをするのか一行ずつコメントで説明するという課題です
自分はJavaはやったことがなく全くわかりません

発生している問題・エラーメッセージ

該当のソースコード

ソースコード
class Drink {
	String name; //商品名
	int price;   //単価
	int count;   //数量
	
	
	
	Drink(String n, int p, int c) {
		name = n;
		price = p;
		count = c;
	}
	
	
	int getTotalPrice() {  //金額を計算
		return count * price;//処理結果を戻り値として返す
	}
	
	
	static void printTitle() {
		System.out.println("商品名\t\t単価\t数量\t金額");
	}
	
	
	void printData() {
		System.out.println(name + "\t" + price + "\t" + count + "\t" + getTotalPrice());
	}
}


class Alcohol extends Drink {
	float alcper;  //アルコールの度数
	
	
	//コンストラクタ
	Alcohol(String n, int p, int c, float a) {
		super(n, p, c);  //スーパークラスのコンストラクタを呼び出す
		alcper = a;
	}
	
	
	//メゾットのオーバーライド
	static void printTitle() {
		System.out.println("商品名(度数[%])\t単価\t数量\t金額");
	}
	
	
	
	void printData() {
		System.out.println(name + "(" + alcper + ")" + "\t" + price + "\t" + count + "\t" + getTotalPrice());
	}
}



class Payment {
	public static void main(String[] args) {
		Drink coffee = new Drink("コーヒー", 200, 3);
		Drink oolongtea = new Drink("ウーロン茶", 150, 2);
		Alcohol wine = new Alcohol("ワイン", 300, 2, 15);
		
		
		Drink.printTitle();
		coffee.printData();
		oolongtea.printData();
		System.out.println();
		
		
		Alcohol.printTitle();
		wine.printData();
		int sum = coffee.getTotalPrice() + oolongtea.getTotalPrice() + wine.getTotalPrice();
		System.out.println("\n*** 合計金額 " + sum + "円 ***");
	}
}

試したこと

補足情報（FW/ツールのバージョンなど）

ここにより詳細な情報を記載してください。

Answer 1

コメントでプログラムを詳細に解説してはいけません。

解説しなくてもわかるようなプログラムの記述を心がけてください。

Answer 2

• 前提・実現したいこと ⇒ 「プログラムがなにをするのか一行ずつコメントで説明するという課題です。自分はJavaはやったことがなく全くわかりません」
• 発生している問題・エラーメッセージ ⇒ 「何も書いてない」

なるほど。つまりは、この質問をした時点ではあなたが実現したいことも特になくて、発生している問題もないってことだね？
ただあなたの書いたソースコードを私たちに見てもらって「よく自分で調べて限界まで頑張ったね、お疲れさま」ってねぎらってほしいってことなんだね？

もしそういうことなら、よく自分で調べて限界まで頑張ったね、お疲れさま。

Answer 3

どのようなコメントを求めるのかは、状況によって異なってきます。先生に確認しましょう。

たとえば、Railsのコードではコメントとしてソースコードにドキュメントを埋め込んでいますが（実例）、このようなものが先生の求める「コメントによるプログラムの詳細な解説」なのかは、第三者には判断できません。

Answer 4

Javaを勉強しましょう、そして理解しましょう
としか言えませんねー

Answer 5

ステートメントをコメントで詳細に説明するのはやめましょう。

super(n, p, c);  //スーパークラスのコンストラクタを呼び出す

特に、上みたいなのは無意味なのでやってはいけません。

変数の説明も不要で、変数名の名前の付け方で分かりやすくするべきだと思います。

コメントによる説明が必要なのは、プログラム、クラス、メソッド単位で用途や目的をjavadocなどで説明するぐらいでしょうか。

/**
 * [getTotalPrice description]
 * 合計金額：単価×数量を計算する
 * @return [合計金額]
 */
int getTotalPrice() {
        return count * price;
}