14
シンプルなゲッター/セッターコメント
ゲッターとセッターにコメントするためにどの規則を使用していますか?これは私がかなり長い間疑問に思っていたものです。例えば: /** * (1a) what do you put here? * @param salary (1b) what do you put here? */ public void setSalary(float salary); /* * (2a) what do you put here? * @return (2b) */ public float getSalary(); 1a / bと2a / bでまったく同じものを書いていることにいつも気づきます。1a)従業員の給与を設定します。1b)従業員の給与を設定します。それはとても冗長なようです。今私はあなたがコンテキストを与えるためにあなたが(a)の部分でより多く書くかもしれないもっと複雑な何かを見ることができました、しかしそこにいるゲッター/セッターの大部分にとって言葉遣いはほとんど正確に同じです。 単純なゲッター/セッターについて、(a)部分または(b)部分のいずれかのみを入力してもよいかどうか、私は興味があります。 どう思いますか?