Java 1.6 uygulamamda bulunan tüm sınıflar için API oluşturmak istiyorum. Normal Java 1.5 API belgelerine benzemelidir.Kaynak kodum bulunmayan bir .jar dosyasındaki sınıflar için JavaDoc belgeleri nasıl oluşturulur?
Kaynak kodum yok. Bir kavanoz dosyasında sınıf dosyalarım var.
Sen sınıf dosyaları, hatta ilkel Javadoc koşuşturmaca Javadoc üretemezler. Javadoc'u yalnızca kaynak dosyalardan üretebilirsiniz, çünkü Javadoc'un yaşadığı yerdir.
sorumu değişiyor? Kaynak kodum yok. Bir kavanoz dosyasında sınıf dosyalarım var. Purushotham 47 dakika önce
herhangi kaynak dosyaları yok mu? O zaman muhtemelen şansın yok demektir. Eclipse'nin sınıf veritabanından yapabilecekleri devasa veritabanında gömülü bazı eklentiler olabilir, ancak o zaman bile herhangi bir yorum yapmadan sadece yöntem imzaları alacaksınız.
Ancak, bu sizin yazdığınız projenizse, IDE'nize JavaDoc oluşturabilirsiniz. Eclipse için Proje Yap> JavaDoc Oluştur. NetBeans'da projenize sağ tıklayın ve JavaDoc Oluştur'u seçin.
size bağımlılıkları dahil etmek isteyen konum, sonra bu çok kötü bir fikir. Bağımlılıklarınızın JavaDocs'larına her zaman bağlantı verin, asla kendinize eklemeyin. Büyük Overly Framework X'den büyük bir sınıf duvarını görerek aklınızı kaybetmemek için, onları ayrı tutmak gerekir. JavaDoc'u projenizde okumak istersem, sadece projenizde okumak istiyorum, slf4j'de değil.
ben kullanmadım, ama bu opensource proje java sınıf veya kavanoz dosyalarından dokümanlar oluşturmak iddia: Sınıfyolu herhangi sınıfında javap komutunu kullanabilirsiniz
ama bu sadece java 1.3 için java 1,6,1,7,1,8 – Pratswinz
için destekleyen başka bir seçenek önerebilirsin Hey! Gördüğüm diğer tek çözüm (ama kullanmadı) [muhtemelen budur] (http://stackoverflow.com/q/24500845/26510) –
. Bu Javadoc dosyaları üretmeyecektir, ancak sınıfın ne sunduğunu görmenize izin verecektir.
Ex ...
javap java.lang.String şu çıktıyı
public final class java.lang.String implements java.io.Serializable, java.lang.Comparable<java.lang.String>, java.lang.CharSequence {
public static final java.util.Comparator<java.lang.String> CASE_INSENSITIVE_ORDER;
public java.lang.String();
public java.lang.String(java.lang.String);
public java.lang.String(char[]);
public java.lang.String(char[], int, int);
üretir ... ve kurucular bir demet sonra başka yöntemler de vardır ...
public int length();
public boolean isEmpty();
public char charAt(int);
public int codePointAt(int);
Ve yapabilirsiniz size başka şeyleri de göstersin, ama bu muhtemelen en yararlı olanı.
Tam olarak aradığınız, ama sadece sınıfların bir grup ile bir kavanoz varsa bu en iyi seçenek ne olabileceğini.
* "... o zaman bile senin tek yöntem imzaları alacağım" *, ve imzalar belki de orijinal argüman isimlerini içermez! –
Evet, tabiki. Ama eğer sahip olduğun tek şey varsa, hiç yoktan iyidir. – fool4jesus