2010-01-06 16 views
129

Sun'ın sitesindeki javadoc belgelerine bakarak, bir sınıfı veya yöntemin jenerik tip imzasını belgelemek için kullanılabilecek bir javadoc etiketi olup olmadığını araştırıyorum.Genel tip parametrelerini belgelemek için bir javadoc etiketi var mı?

Her zamanki gibi @param benzeri @typeparam gibi bir şey, ancak yöntemlerin yanı sıra, uygulanabilir. Her yerde onun sözünü bulabilirsiniz ve JavaSE API dosyaları herhangi bir belirtisi göstermezler, ama garip bir eksiklik gibi görünüyor -

/** 
* @typeparam T This describes my type parameter 
*/ 
class MyClass<T> { 
} 

Öyle bir etiket yoktur sanıyorum. Birisi beni doğru yapabilir mi?

+7

uygun javadocs yazmak için? –

+2

* Çoğu * sınıf için gerçekten tip parametresi hakkında söylenecek ilginç bir şey olmadığını unutmayın, çünkü tip parametresi esas olarak nesnenin yöntemlerinde nasıl göründüğü ile tanımlanır. Çoğu zaman @param 'yi atlardım ve sadece gerçekten net olmadığında onu kullanırdım. –

+3

Ne dediğini görüyorum, ama bu mantıkla, aynı yöntem parametreleri için '@ param 'kullanımı için de geçerlidir. Sun'ın kodlama standartları, yöntem parametresinin anlamı açık olsa bile 'param' kullanılmalıdır. – skaffman

cevap

178

Sadece böyle yapılmalıdır:

/** 
* @param <T> This describes my type parameter 
*/ 
class MyClass<T>{ 

} 

Source

+4

Doh .... Tamam, bu utanç verici bir şekilde açık ... JavaSE sınıflarının (örn. 'Koleksiyon') neden kullanılmadığı sorusu dileniyor. – skaffman

+0

Garip bu, standart belgelerde belgelenmemiş. –

+5

LinkedList şunu kullanır: http://java.sun.com/j2se/1.5.0/docs/api/java/util/LinkedList.html –

21

Evet. Sadece @param etiketini kullanın ve tip parametresi etrafında açılı ayraçlar ekleyin. Bunun gibi

:

/** 
* @param <T> This describes my type parameter 
*/ 
İlgili konular