जपिकोम्पैट - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

japicompat - बाइनरी बैकवर्ड संगतता के लिए जावा एपीआई का परीक्षण करें।

SYNOPSIS

japicompat [-svqhtjw4] [-ओर आउटफाइल] [-मैं फ़ाइलें अनदेखा करें]

वर्णन

japicompat japitools का हिस्सा है, जिसे जावा एपीआई के बीच अनुकूलता के परीक्षण के लिए डिज़ाइन किया गया है।

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

उपकरण जपाइज़ और जपिकोम्पैट हैं। जैपाइज़ एक जावा प्रोग्राम है जो एक सूची उत्सर्जित करता है
मशीन-पठनीय प्रारूप में एपीआई। इसके बाद Japicompat ऐसी दो सूचियाँ लेता है और तुलना करता है
उन्हें बाइनरी संगतता के लिए, जैसा कि जावा भाषा विशिष्टता में सन द्वारा परिभाषित किया गया है।

विकल्प

-s अतिरिक्त बाइनरी संगतता जांच अक्षम करें (केवल जेएलएस द्वारा परिभाषित जांच करें)।

-v छोटी संगतता समस्याओं के लिए जाँच सक्षम करें।

सीरियलवर्जनयूआईडी जांच: यदि कोई सीरियलाइजेबल क्लास है तो japicompat एक छोटी सी त्रुटि की रिपोर्ट करता है
दोनों रिलीज़ों के बीच एक अलग SerialVersionUID है।

बहिष्करण जाँच: यदि कोई वर्ग या सदस्य था तो japicompat एक छोटी सी त्रुटि की रिपोर्ट करता है
मूल एपीआई में बहिष्कृत किया गया है लेकिन जाँच की जा रही एपीआई में बहिष्कृत नहीं किया गया है।

-q प्रगति रिपोर्ट अक्षम करता है.

-h HTML प्रारूप में आउटपुट उत्पन्न करता है। उत्पादित HTML फ़ाइलें japi.css पर निर्भर करती हैं
आकर्षक प्रस्तुति पाने के लिए फ़ाइल।

-t टेक्स्ट प्रारूप में आउटपुट उत्पन्न करता है। यह डिफ़ॉल्ट है.

-j कच्चे मशीन पठनीय रूप में आउटपुट उत्पन्न करता है। निर्मित प्रारूप को कहा जाता है
"japio" प्रारूप, और परंपरा के अनुसार इसे ".japio" फ़ाइल एक्सटेंशन के साथ सहेजा जाना चाहिए।
इस प्रारूप को परिवर्तित करने के लिए स्टैंडअलोन japiotext और japiohtml उपयोगिताओं का उपयोग किया जा सकता है
HTML या टेक्स्ट में (वास्तव में, japicompat आंतरिक रूप से japiotext या japiohtml को कॉल करता है
-h या -t झंडे का उपयोग किया जाता है)। जैपियो फ़ाइलों का उपयोग -i फ़्लैग के साथ भी किया जा सकता है
जेडीके संस्करणों के बीच असंगतताओं के कारण होने वाली त्रुटियों को अनदेखा करने का समर्थन।

-w पुरानी ख़राब जापी फ़ाइलों के विरुद्ध चलने के लिए चेतावनियाँ अक्षम करें। डिफ़ॉल्ट रूप से japicompat
यदि मूल रूप से पुराने द्वारा उत्पन्न जापी फ़ाइलों के विरुद्ध चलाया जाता है तो चेतावनियाँ उत्पन्न होंगी
japitools के संस्करण जिनमें ज्ञात बग थे जिन्हें japifix समाप्त नहीं कर सकता।

-4 1.4-संगत मोड का उपयोग करें। यह तब तक काम करता है जब तक तुलना करने के लिए एपीआई शामिल नहीं है
1.5-केवल आइटम।

-o
आउटपुट को यहां भेजें स्टडआउट के बजाय। इस फ़ाइल का प्रारूप इस पर निर्भर करता है
-h, -t और -j झंडे।

-i
मान लीजिए आप जावा एपीआई लागू करने का प्रयास कर रहे हैं। आपके पास (बहुत ज्यादा) है
प्रारंभिक जेडीके संस्करणों (1.0 और 1.1) का कवरेज पूरा हो गया है लेकिन अभी भी कुछ है
1.4 की पूर्ण कवरेज प्राप्त करने के लिए दूरी (यह सभी का सटीक विवरण है
लेखन के समय मुफ़्त सॉफ़्टवेयर जावा कार्यान्वयन)। japicompat का उपयोग करना
जेडीके 1.4 के साथ अपने कार्यान्वयन की तुलना करने से सटीक परिणाम मिलते हैं, लेकिन आप भी ऐसा कर सकते हैं
आप पिछले संस्करणों के बारे में अपना कवरेज दिखाना चाहते हैं।

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

जाहिर है कि आप वास्तव में जो चाहते हैं वह इस तरह की त्रुटियों और जपिकोम्पैट को नजरअंदाज करना है
ऐसा करने का एक तरीका प्रदान करता है। सबसे पहले, -j का उपयोग करके 1.1 और 1.4 के बीच तुलना चलाएँ
बदलना। फिर 1.1 और अपने कार्यान्वयन के बीच तुलना चलाएँ, पास करते हुए
पिछले रन के आउटपुट के साथ "-i" विकल्प। उदाहरण के लिए:

$ japicompat -joign-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -i अनदेखा-11-14.japio jdk11.japi.gz
myimpl.japi.gz

आप दौड़कर भी यही प्रभाव प्राप्त कर सकते हैं:

$ japicompat -हो jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz

यह टाइप करने में स्पष्ट रूप से सरल और तेज़ है, लेकिन इसके लिए बीच तुलना की आवश्यकता है
jdk11 और jdk14 को हर बार चलाना होगा। जापियो फ़ाइल को मैन्युअल रूप से बनाने की अनुमति है
इसे सहेजने और अगली बार फिर से उपयोग करने के लिए, जो जपिकोम्पैट को चलने देता है
दोगुनी तेजी से.


एपीआई से संबंधित जापी फाइलों की तुलना की जानी है।

japicompat विशेष रूप से परीक्षण करता है कि दूसरा तर्क पश्चगामी-संगत है
पहले के साथ. इसलिए, JDK 1.1 का सही कार्यान्वयन कोई परिणाम नहीं देगा
तर्कों के क्रम की परवाह किए बिना त्रुटियाँ, लेकिन इसका एक आदर्श कार्यान्वयन
JDK1.1 प्लस JDK1.2 के भागों का परीक्षण निम्नानुसार किया जाना चाहिए:

$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat myimpl.japi.gz jdk12.japi.gz

ऐसा कार्यान्वयन करना संभवतः असंभव है जो इन दोनों परीक्षणों को पास कर सके,
चूँकि Sun का अपना JDK1.2, JDK1.1 के विरुद्ध परीक्षण करने पर अनेक त्रुटियाँ उत्पन्न करता है। देखें
इस स्थिति से निपटने के तरीके के लिए उपरोक्त -i विकल्प पर चर्चा।

या तो संपीड़ित (.japi.gz) या असंपीड़ित (.japi) फ़ाइलें पास की जा सकती हैं
japicompat: फ़ाइल एक्सटेंशन का उपयोग यह निर्धारित करने के लिए किया जाता है कि पाइप इनपुट करना है या नहीं
gzip के माध्यम से या नहीं।

onworks.net सेवाओं का उपयोग करके japicompat का ऑनलाइन उपयोग करें