2011-06-29 8 views
6

ग्रूवी 1.8 डॉक्स Javadocs के 3 प्रकार हैं। समझना आसान है।ग्रोवी 1.8 के लिए 3 प्रकार के जावा डॉक्स क्या हैं?</p> <p>API/ gapi/ JDK/</p> <p>JDK/Javadocs शो तरीकों कि ग्रूवी जावा वर्गों को जोड़ता है:

एपीआई/और गैसी/में जावाडॉक्स/भ्रमित हैं। वे एपीआई के अलावा समान हैं/सभी वर्गों का मामला असंवेदनशील प्रदर्शन है जबकि अंतरी/सभी वर्गों का केस-सेंसिटिव डिस्प्ले है। (केस-सेंसिटिव डिस्प्ले चीजों को ढूंढना मुश्किल बनाता है।)

अंतराल/सभी वर्गों की सूची में सूची के अंत में चार genXXX प्रविष्टियां हैं (वह केस-संवेदी सॉर्ट फिर से) जो प्रतीत नहीं होता है एपीआई/सूची।

क्या किसी को पता है कि एपीआई/और गैसी/जावा डॉक्स के बीच क्या अंतर है?

धन्यवाद।

उत्तर

3

Paul King on the Groovy User मेलिंग सूची

से उद्धरित "API" जावा फ़ाइलों के सभी भर में जावाडोक चलाने का परिणाम है।

"गैसी" सभी जावा और ग्रोवी फाइलों में groovydoc चलाने का परिणाम है। (ऐतिहासिक दृष्टि से इस था सिर्फ ग्रूवी फ़ाइलों लेकिन अब यह दोनों में चलाता है। यदि Groovydoc समाप्त हो गया था हम "API" को दूर कर सकता है पूरी तरह लेकिन कम से कम अब तक, जावाडोक उस में अधिक जानकारी नहीं है तो हम दोनों रहते हैं।)

"ग्रूवी-JDK" DefaultGroovyMethods की तरह सिर्फ "श्रेणी" फ़ाइलों के पार चला जाता है और बजाय स्रोत फ़ाइल भर में जावाडोक रिपोर्टिंग उन्हें वर्ग है जो श्रेणी फैली भर में रिपोर्ट करता है। उदाहरण के लिए:

डीजीएम # (संग्रह आत्म, स्ट्रिंग विभाजक) में शामिल होने के

के रूप में सूचित किया जाएगा:

java.util.Collection # में शामिल होने के (स्ट्रिंग विभाजक)

जो है कैसे यह भाषा उपयोगकर्ता के लिए प्रतीत होता है।

+1

उह। हमें डॉक्स के एक सेट की आवश्यकता है जो व्यापक है। GroovyDoc gapi सबसे अच्छा होना चाहिए, लेकिन वह केस-संवेदनशील प्रदर्शन एक समस्या है। –