2009-02-19 18 views
5

के साथ कवरेज मैं एक परियोजना में शामिल हूं जिसमें सार्वजनिक एपीआई दस्तावेज एक स्पष्ट वितरण योग्य है। यह सुनिश्चित करने के लिए कि रिलीज इस आवश्यकता को पूरा करता है, मैं यह सुनिश्चित करना चाहता हूं कि मेरे एंट बिल्ड फ़ाइल में रिलीज़ लक्ष्य विफल हो जाए यदि दस्तावेज़ कवरेज बहुत कम है।मापना दस्तावेज़ीकरण Javadoc और Ant

न्यूनतम के रूप में, सार्वजनिक या संरक्षित पहुंच वाले प्रत्येक पहचानकर्ता के पास उचित जावाडोक टैग और विवरण होना चाहिए। उदाहरण के लिए, प्रत्येक पैरामीटर के लिए सार्वजनिक विधियों में @param टैग होना चाहिए, @return टैग अगर वापसी का प्रकार void नहीं है, प्रत्येक अपवाद के लिए @throws टैग, और एक पंक्ति विवरण।

वर्तमान में मेरे पास कोबर्टुरा का उपयोग करके जुनीट कोड कवरेज रिपोर्ट और विफलता की स्थिति है, इसलिए दस्तावेज़ीकरण के लिए ऐसा कुछ भी सही होगा। हालांकि, अगर विफलता की स्थिति का पता लगाना उपलब्ध नहीं है, तो एक रिपोर्ट एक उचित विकल्प होगी।

प्रलेखन जवाडोक प्रारूप में होना चाहिए। Doxygen सहित कोई अन्य प्रारूप - स्वीकार्य है।

उत्तर

4

Checkstyle ऐसा कर सकते हैं।

+0

मैंने ऐसा क्यों नहीं सोचा? बहुत बहुत धन्यवाद! –

1

मुझे ऐसा कोई उपकरण नहीं पता है, लेकिन मुझे लगता है कि डॉक्सिजन XML फ़ाइलों को उत्पन्न कर सकता है जो टिप्पणियों के साथ कोड संरचना का वर्णन करते हैं। आप एक ऐसी स्क्रिप्ट लिख सकते हैं जो उस पर कुछ सरल परीक्षण करेगी और अनियंत्रित विधियों/पैरा/वापसी मूल्य/आदि खोजें।

+0

प्रलेखन _must_ जावाडोक में होना चाहिए, इसलिए दुर्भाग्य से Doxygen एक विकल्प नहीं है। –

+0

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

+0

आपका उत्तर तब भी उपयोगी है, +1। –

संबंधित मुद्दे