Ne Kongre alıcıları ve ayarlayıcıları yorum yapmak için kullanıyor musunuz? Bu, örneğin: bir süredir merak ettiğim bir şey

/**
 * (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();

Ben neredeyse hep 1a/b, 2a/b, 1a gibi bir şey) için de aynı şeyi yazıyorum bulmak çalışanın maaş, 1b) Ayarlar çalışanın maaş. Çok gereksiz görünüyor. Şimdi ben görmek için daha karmaşık bir şey olabilir yazma daha fazla (a) parça, ver bağlam, ama çoğunluk alıcı/ayarlayıcı orada ifadeler neredeyse birebir aynı.

Basit alıcılar için/(a) VEYA (b) bölümü bölümünde sadece doldurmak için onun ok belirleyiciler olmadığını merak ediyorum.

Ne düşünüyorsun?

Kesinlikle anlamsız - bu tür saçmalıklar olmasa çok daha iyi kodunuzu yığılan.

/**
 * Sets the foo.
 * 
 * @param foo the foo to set
 */
public void setFoo(float foo);

Gerektiğinde çok yararlı,:

/**
 * Foo is the adjustment factor used in the Bar-calculation. It has a default
 * value depending on the Baz type, but can be adjusted on a per-case base.
 * 
 * @param foo must be greater than 0 and not greater than MAX_FOO.
 */
public void setFoo(float foo);

Özellikle özelliği aslında ne anlama geldiğini açıklama etki alanı modeli önemli olabilir. Fasulye yatırım bankacıları, biyokimyacılar, kuantum fizikçileri ya da sadece anlamak o kadar belirsiz adları ile özelliklerini tam olarak görüyorum, ve yorumlar setGobbledygook anlatayım o zaman() yöntemi "argo ayarlar",. Birini boğmak istiyorum.