मैं अपने सार वर्ग से विधियों के उत्तराधिकारी के लिए {@inheritDoc}
कक्षा का उपयोग करना चाहता हूं। अमूर्त वर्ग के लिए प्रलेखन में, मैं अमूर्त वर्ग को नाम से संदर्भित करता हूं। मैं इसे कैसे टैग कर सकता हूं जब सबक्लास को सुपर क्लास से दस्तावेज़ प्राप्त होता है, तो यह सार वर्ग के नाम को उपclass के नाम से बदल देता है?जावाडोक {@inheritDoc} टैग क्लास
उत्तर
जो आप वर्णन कर रहे हैं वह जावाडोक जनरेशन टूल द्वारा समर्थित नहीं है।
और मुझे लगता है यह भी के लिए एक अच्छा कारण है कि:
हैं उपवर्ग में अपने विधि केवल एक सार विधि के एक कार्यान्वयन है, तो मुझे लगता है कि अमूर्त वर्ग छोड़ने के लिए सही होगा वहां नाम '
फ्लिप पक्ष पर, यदि उप-वर्ग में आपकी विधि केवल एक साधारण कार्यान्वयन नहीं है, और कुछ और उल्लेखनीय है (जवाडोक में उल्लेख किया जाना पर्याप्त है), तो आपको विधि पर एक नया जावाडोक लिखना चाहिए उत्तराधिकारी का आह्वान करने के बजाय उपclass।
मुझे किसी तरह से पता नहीं है, लेकिन आप यह बता सकते हैं कि आप {@inheritDoc}
ऐसा क्यों करना चाहते हैं। मैं गलत समझ सकता हूं, लेकिन यह भ्रमित लगता है। आप दस्तावेज कर सकते हैं कि आपका ठोस कार्यान्वयन कैसे माता-पिता के रूप में भिन्न होता है और अमूर्त वर्ग में अनुबंध को संदर्भित करने के लिए @see
का उपयोग करता है। नोट "Automatic Copying of Method Comments" एक स्पष्ट {@inheritDoc}
की आवश्यकता को रोक सकता है।
मुझे लगता है कि मैं समझता हूं। धन्यवाद। – LandonSchropp
आप भी, आईआईआरसी, अपनी टिप्पणियों में {@inheritDoc}
टैग के आस-पास अतिरिक्त टेक्स्ट लिख सकते हैं।
- 1. {@inheritDoc} ग्रहण
- 2. क्या Doxygen में एक @inheritDoc समतुल्य है?
- 3. विशिष्ट टैग के लिए जावाडोक चेतावनियां मारना
- 4. जावा प्रलेखन ओवरराइड विधि InheritDoc
- 5. जावाडोक
- 6. जावाडोक
- 7. जावाडोक @link
- 8. किसी विधि के जावाडोक को अन्य विधि के जावाडोक में कैसे कॉपी किया जा सकता है?
- 9. समीकरणों के साथ जावाडोक?
- 10. ग्रैडल के साथ जावाडोक: जावाडोक कार्य
- 11. जावाडोक लिंक कैसे लिखें?
- 12. जावाडोक यूएमएल आरेखण
- 13. जावाडोक: @value अन्य वर्ग
- 14. डॉक्सिजन बनाम जावाडोक
- 15. जावाडोक के लिए होस्टिंग?
- 16. जावाएफएक्स 2.2 जावाडोक?
- 17. एंड्रॉइड (एक्लिप्स) पर जावाडोक
- 18. जावाडोक इंटरफ़ेस टिप्पणियां
- 19. जावाडोक टेम्पलेट जनरेटर
- 20. जावाडोक @see या {@link}?
- 21. ग्रुपिंग जावाडोक विधियों
- 22. जावा जावाडोक में निजी
- 23. बिल्डर क्लास
- 24. स्रोत और जावाडोक जार पीढ़ी
- 25. जावाडोक: package.html या package-info.java
- 26. जावाडोक टिप्पणियां बनाम ब्लॉक टिप्पणियां?
- 27. जावाडोक जब गैर सामान्य वर्ग
- 28. लोकप्रिय जावाडोक टैग के लिए उपयोग करने के लिए एक अच्छा संदर्भ?
- 29. जावाडोक में, टैग @ थ्रो और @ एक्ससेप्शन के बीच क्या अंतर है?
- 30. डिफ़ॉल्ट इंटेलिजे डिफ़ॉल्ट क्लास जावाडोक टिप्पणी गैर-मानक वाक्यविन्यास का उपयोग क्यों करती है?
इसके पीछे मेरा तर्क था कि मेरे कोड का पाठक सामान्य रूप से कार्यान्वयन के पीछे अमूर्त वर्ग को नहीं देखेगा, इसलिए मैं इसे छिपाना चाहता था। हालांकि, ऐसा प्रतीत होता है कि मैं ऐसा नहीं कर सकता। फिर भी धन्यवाद। – LandonSchropp
यदि आपकी कक्षा के उपयोगकर्ता को विधि के लिए दस्तावेज़ीकरण की आवश्यकता है, लेकिन उन्हें अमूर्त बेस क्लास के अस्तित्व के बारे में पता नहीं होना चाहिए, तो विधि परिभाषा को एक इंटरफ़ेस में स्थानांतरित किया जाना चाहिए, साथ ही सार वर्ग पर जावाडोक के साथ। संक्षेप में, इंटरफ़ेस वह है जो उपयोगकर्ता के बारे में होगा। उपर्युक्त उत्तर में दोनों बिंदु अभी भी लागू होंगे। – GreenGiant