2011-07-01 9 views
59

मैं उस वर्ग के लिए जावाडोक लिख रहा हूं जिसमें इसके स्वयं के enums शामिल हैं। व्यक्तिगत enums के लिए javadoc उत्पन्न करने का कोई तरीका है?कैसे क्लास के व्यक्तिगत Enums Javadoc करने के लिए

/** 
* This documents "HairColor" 
*/ 
private static enum HairColor { BLACK, BLONDE, BROWN, OTHER, RED }; 

हालांकि, यह केवल दस्तावेजों एक पूरे के रूप enums के सभी:

The generated Javadoc

वहाँ HairColor से प्रत्येक दस्तावेज़ के लिए कोई तरीका है उदाहरण के लिए, अभी मैं इस तरह कुछ है व्यक्तिगत रूप से मूल्य? Enum को अपनी कक्षा में ले जाने या इसे enum से बदलकर?

किसी भी मदद के लिए अग्रिम धन्यवाद।

+0

उत्सुकता से, आप क्यों चाहते हैं? आपके पास एन्हम 'निजी' नेस्टेड एनम के रूप में सूचीबद्ध है, इसलिए आपकी कक्षा के उपयोगकर्ता एनम या उसके मूल्यों का उपयोग नहीं कर सकते हैं। और यदि यह सार्वजनिक रूप से और स्टैंडअलोन होने का मतलब है, तो इसे अपनी इकाई के रूप में दस्तावेज करने में क्या बड़ा सौदा है? –

+1

मेरे वास्तविक कोड में, यह सार्वजनिक है। और आप जानते हैं कि कंपनी के मानक कैसे हो सकते हैं। "यह बेहतर होगा" "बहुत बुरा, हम प्रोग्रामिंग के बारे में कुछ भी नहीं जानते हैं, आपको लगता है कि आपको इसे इस तरह करना चाहिए"। लॉल –

+0

पर्याप्त मेला। बस सुनिश्चित करें कि आप उन्हें बताएं कि रिलीज को एक हफ्ते तक वापस धकेल दिया जाएगा क्योंकि दस्तावेज़ों के लिए अनावश्यक आवश्यकताओं की संभावना शायद कभी नहीं पढ़ी जाएगी। वह आमतौर पर किसी ऐसे व्यक्ति के कान उठाता है जो व्यवसाय की परवाह करता है। –

उत्तर

66

आप इसे किसी अन्य वैरिएबल की तरह करते हैं जो आप javadoc करेंगे।

 

/** 
* Colors that can be used 
*/ 
public enum Color 
{ 
    /** 
    * Red color 
    */ 
    red, 

    /** 
    * Blue color 
    */ 
    blue 

} 
 

संपादित करें:

पाउलो Ebermann से: enum एक अलग वर्ग है। आप संलग्न कक्षा में अपना पूरा दस्तावेज शामिल नहीं कर सकते (कम से कम, मानक डॉकलेट को पैच किए बिना)।

+1

यह वही चीज़ उत्पन्न करता है (स्नैपशॉट पर लिंक देखें)। मैं उन्हें सीधे क्लास जावाडोक में डाल रहा हूं (किसी अन्य जावडोक से जोड़ने के बजाय)। लेकिन धन्यवाद =) समस्या विवरण को आगे बढ़ाने के लिए +1। –

+4

@ राहेल: enum एक अलग वर्ग है। आप संलग्न कक्षा में अपना पूरा दस्तावेज शामिल नहीं कर सकते (कम से कम, मानक डॉकलेट को पैच किए बिना)। –

+0

हाँ। मैं चिंतित था कि लिंकिंग होने पर यह कैसा था। मुझे लगता है कि व्यक्तिगत enums को शामिल करने का एकमात्र तरीका इसे एक आंतरिक वर्ग में बदलना होगा और फिर वस्तुओं को घोषित करना होगा और उन्हें javadoc करना होगा। –

40

आप प्रत्येक enum के आइटम को लिंक बना सकते हैं। सभी वस्तुओं को enum कक्षा में javadocs में सूचीबद्ध किया जाएगा।

/** 
* Colors that can be used 
* <li>{@link #RED}</li> 
* <li>{@link #BLUE}</li> 
*/ 
public enum Color { 

    /** 
    * Red color 
    */ 
    RED, 

    /** 
    * Blue color 
    */ 
    BLUE 
} 
संबंधित मुद्दे