SORU
22 HAZİRAN 2009, PAZARTESİ


Basit bir Alıcı/Ayarlayıcı yorumlar

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?

CEVAP
22 HAZİRAN 2009, PAZARTESİ


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.

Bunu Paylaş:
  • Google+
  • E-Posta
Etiketler:

YORUMLAR

SPONSOR VİDEO

Rastgele Yazarlar

  • theavettbrothers

    theavettbrot

    9 ŞUBAT 2007
  • TheTwistedFrequency

    TheTwistedFr

    26 NİSAN 2010
  • Videojug

    Videojug

    25 EKİM 2006