कई लोग शिकायत करते हैं कि जावा में कुछ गायब है, कुछ छोटी है, या धीमी है। अच्छी खबर: आपके पास शिकायत करने का नहीं, बल्कि अपने दम पर जावा को बेहतर बनाने का अवसर है। जावा एक OpenJDK परियोजना के रूप में लगभग पूरी तरह से खुला है। इस परियोजना की अपनी विशेषताएं हैं, लेकिन सामान्य तौर पर, कुछ भी आपको समस्याओं को रिपोर्ट करने, उन्हें ठीक करने या यहां तक ​​कि नई कार्यक्षमता विकसित करने से रोकता है। इस लेख में मैं आपको बताऊंगा कि शुरुआत के लिए यह कैसे करना है।

बग की रिपोर्ट कैसे करें?

OpenJDK परियोजना में एक बग ट्रैकर है - JIRA । वहां आप खोज सकते हैं और जांच सकते हैं कि आपकी समस्या ज्ञात है या नई है। हालाँकि, गली का कोई व्यक्ति वहाँ पंजीकरण नहीं कर सकता है और वहाँ लिख सकता है। जावा में समस्या की रिपोर्ट करने का आधिकारिक तरीका (या यहां तक ​​कि सुधार का सुझाव) जावा बग रिपोर्ट फॉर्म का उपयोग करना है। यह फॉर्म JIRA में JI उपसर्ग (Java इश्यू) के साथ टिकट बनाता है, टिकट नंबर आपके निर्दिष्ट ई-मेल पर भेजा जाएगा)। प्री-मॉडरेशन के समय, आपका टिकट prying आँखों से छिपा होता है। यदि पूर्व-मॉडरेशन सफल होता है, तो आपकी समस्या सार्वजनिक परियोजना (उदाहरण के लिए, जेडीके उपसर्ग के साथ) में स्थानांतरित हो जाती है, और हर कोई इसे देख सकता है। इस फॉर्म का लाभ यह है कि यह अपेक्षाकृत सरल है, पंजीकरण की आवश्यकता नहीं है और आमतौर पर किसी भी व्यक्तिगत डेटा। नकारात्मक पक्ष यह है कि इन रूपों को सीधे जावा डेवलपर्स द्वारा नहीं देखा जाता है, लेकिन एक विशेष वेबबग समूह टीम द्वारा। एक जोखिम है कि आपका संदेश लंबे समय तक अनजाने में लटका रहेगा (भले ही यह डेवलपर्स के दृष्टिकोण से महत्वपूर्ण हो)। यह मेरा टिकट एक महीने के लिए प्री-मॉडरेशन में लटका रहा, जब तक कि मैंने ओरेकल के एक अच्छे दोस्त को लोगों को हिला देने के लिए नहीं कहा। ऐसा भी हो सकता है कि अनजाने में, आपके टिकट को पूरी तरह से अस्वीकार कर दिया जाएगा, जैसा कि उदाहरण के लिए, यहां मेरे सहयोगी के साथ हुआ। समस्या केवल OpenJDK में ही प्रकट हुई, लेकिन OracleJDK में स्वयं प्रकट नहीं हुई, और वेबबग समूह ने समस्या को ध्यान देने योग्य नहीं माना। फिर, मैं इसे केवल एक अच्छे दोस्त की बदौलत समझ पाया।

ऐसा भी होता है कि टिकट सफलतापूर्वक पूर्व-मॉडरेशन से गुजर गया और एक सार्वजनिक परियोजना में शामिल हो गया, लेकिन आपको इस बारे में सूचित नहीं किया गया था। इसलिए, आप कभी-कभार https://bugs.openjdk.java.net/browse/JI-xxxxxxx फॉर्म का URL चेक कर सकते हैं, जो आपके पास सबसे अंत में है। यदि पूर्व-मॉडरेशन पूरा हो गया है, तो आपको सार्वजनिक टिकट पर पुनर्निर्देशित किया जाएगा, अन्यथा आपको एक त्रुटि संदेश दिखाई देगा।

किसी भी मामले में, समस्या का स्पष्ट रूप से वर्णन करना सुनिश्चित करें और एक न्यूनतम उदाहरण दें जो इसे पुन: पेश करता है। यह जितना सरल है, उतनी ही अधिक संभावना है कि वे इस पर ध्यान देंगे।

क्या कोई बेहतर तरीका है?

जैसा कि आप देख सकते हैं, इस फॉर्म के साथ समस्याएं हैं। उचित मेलिंग-सूची में किसी समस्या की रिपोर्ट करना अक्सर बेहतर होता है। OpenJDK कई मेलिंग सूचियों का समर्थन करता है, और आपको निश्चित रूप से अपने हित के क्षेत्रों की सूचियों की सदस्यता लेनी चाहिए। सूची अभिलेखागार के माध्यम से ब्राउज़ करें यह देखने के लिए कि वे मृत हैं या नहीं। उदाहरण के लिए, यदि आपको लैम्ब्डा के साथ किसी प्रकार की समस्या है, तो शायद ही अब लैम्ब्डा-देव में लिखने लायक है, क्योंकि लैम्ब्डा परियोजना जावा -8 के साथ पूरी हो चुकी है और सूची निष्क्रिय है। सबसे अधिक संभावना संकलक देव आपको सूट करेगा, क्योंकि आमतौर पर लैम्ब्डा के साथ समस्याएं एक जावा संकलक समस्या हैं।

कोई भी व्यक्ति सूची की सदस्यता ले सकता है और उसे लिख सकता है, कोई समस्या नहीं है। संलग्नक से सावधान रहें: अधिकांश फ़ाइल प्रकार काटे जाते हैं। विश्वसनीयता के लिए, मैं *.txt अलावा कुछ भी नहीं भेजता हूं और संग्रह से जांचें कि क्या संदेश वास्तव में सूची में मिला है (सामान्य स्थिति में, इसे भेजने के तुरंत बाद संग्रह में प्रदर्शित किया जाता है)। इन सूचियों को वास्तविक डेवलपर्स द्वारा पढ़ा जाता है, इसलिए यदि आप एक दिलचस्प समस्या का सामना करते हैं, तो इसे हल करने का मार्ग छोटा होगा।

और अधिक विदेशी तरीके?

एक विकल्प व्यक्तिगत रूप से कुछ जावा डेवलपर के लिए एक पत्र हो सकता है, जो आपकी राय में, आपकी समस्या में रुचि रखेगा। कई डेवलपर्स के मेलिंग पते आसानी से एक ही मेलिंग सूची अभिलेखागार में पाए जा सकते हैं, लेकिन, निश्चित रूप से, यह विधि जोखिम भरा है और इसके लिए बहुत सोच-विचार की आवश्यकता है। आपके पत्र को आसानी से अनदेखा किया जा सकता है। हालाँकि, मैं JMH टूल के लिए एक सरल सुविधा अनुरोध प्रदान करने में कामयाब रहा।

एक अधिक विदेशी विकल्प स्टैकऑवरफ्लो के साथ आपकी समस्या के बारे में शिकायत करना है। ओपनजेडके डेवलपर्स और यहां तक ​​कि ओरेकल कर्मचारी हैं, लेकिन, निश्चित रूप से, वे सब कुछ नहीं पढ़ते हैं और यह बहुत संभव है कि उन्होंने आपके संदेश को नोटिस नहीं किया है। और अगर वे नोटिस करते हैं, तो वे ऐसा नहीं करना चाहेंगे। इसने मेरे लिए एक बार और फिर इनाम की घोषणा के बाद ही काम किया। ब्रायन गोएट्ज ने एक बग के रूप में मेरी समस्या को पहचानते हुए मुझे जवाब दिया। डेवलपर्स ने खुद एक टिकट शुरू किया और इसे तय किया। बेशक, इस मामले में सफलता पर भरोसा करना इसके लायक नहीं है।

एक और भी अधिक विदेशी विकल्प एक जावा सम्मेलन में समस्या के बारे में शिकायत करना है। अंतिम जेपोट में, केरेमिन ने भागने के विश्लेषण के बारे में बात की और Arrays.asList साथ एक दिलचस्प मामले का उदाहरण दिया, जहां यह टूटता है ( प्रस्तुति , स्लाइड 69 और नीचे)। उनकी रिपोर्ट सुनने के बाद, मैं इस समस्या को ठीक करने के लिए बहुत आलसी नहीं था। बेशक, कोई भी इस मामले में सफलता की गारंटी नहीं देता है।

लेकिन बग्स को कैसे ठीक किया जाए?

अब आपके पास बग की रिपोर्ट करने के कई तरीके हैं। लेकिन क्या होगा अगर हाथ खुद को कोड लिखने के लिए खुजली करते हैं? पहले आपको बुनियादी ढांचे से निपटने की जरूरत है।

सभी OpenJDK प्रोजेक्ट यहाँ उपलब्ध मर्क्यूरियल रिपॉजिटरी में संग्रहीत हैं । Jdk9 वर्तमान में विकास के अधीन है, और आमतौर पर आपको देव भंडार की आवश्यकता होती है। Jdk (क्लास लाइब्रेरी), हॉटस्पॉट (वर्चुअल मशीन), आदि जैसे कई अलग-अलग रिपॉजिटरी से एक और चयन होता है। यदि जावा के वर्तमान संस्करण में समस्या का पता लगाया जाता है (उदाहरण के लिए, java8 में), लेकिन java9 में रहता है, तो उन्हें पहले ठीक किया जाएगा। java9, और फिर इसे java8 अपडेट में पोर्ट करें (यदि परिवर्तन करने के जोखिम को पोर्ट करने के इच्छित लाभ हैं)। आठ की अधिकांश समस्याएं अभी भी केवल नौ में ही सही हैं, लेकिन उन्हें आठ में स्थानांतरित नहीं किया जा सकता है। आपको जिस रिपॉजिटरी की ज़रूरत है उसे डाउनलोड करें और उसके डिवाइस का अध्ययन करने में समय व्यतीत करें। यदि आप क्लास लाइब्रेरी को ठीक करने की योजना बना रहे हैं, तो आपको jdk9/dev/jdk एक पथ की आवश्यकता होगी जैसे /src/<jigsaw-module>/share/classes/ jdk9/dev/jdk /src/<jigsaw-module>/share/classes/ ।

यदि आपने कोड तय किया है, तो यह सुनिश्चित करना अच्छा होगा कि आपका पैच काम करना चाहिए। मुझे ईमानदारी से समझ नहीं आया कि ओपनजेडके को खरोंच से ठीक से कैसे इकट्ठा किया जाए। इसके बजाय, मैं Kenai परियोजना से जावा -9 का नवीनतम निर्माण स्थापित करता हूं। मैं केवल परिवर्तित जावा फ़ाइलों को एक अलग निर्देशिका में कॉपी करता हूं, फिर उन्हें किसी तरह इस तरह संकलित करता हूं (उदाहरण के लिए java/util में उपयोग के लिए java/util java.base मॉड्यूल से उपयोग java/util ):

 $ javac -Xmodule:java.base -d out/java.base src/java/util/*.java 

और फिर मैं निम्नलिखित कमांड का उपयोग करके कुछ परीक्षण एप्लिकेशन लॉन्च करता हूं:

 $ java -Xpatch:out MyTest.java 

-Xmodule और -Xpatch आरा परियोजना में दिखाई दिए। इससे पहले, -Xbootclasspath/p: काम किया, जावा -9 में यह विकल्प नहीं है।

और टेस्ट कैसे लिखें?

हालांकि, एक सामान्य इकाई परीक्षण लिखना सही होगा, रिपॉजिटरी में सही होगा। OpenJDK परीक्षण चलाने के लिए विशेष jtreg टूल का उपयोग करता है। दुर्भाग्य से, तैयार किए गए बिल्ड को आधे साल तक अपडेट नहीं किया गया है, और यह महत्वपूर्ण है, क्योंकि आरा से संबंधित परिवर्तन jtreg के पुराने संस्करणों में समस्याएं पैदा करते हैं। तो आपको यह पता लगाना होगा कि jtreg का निर्माण कैसे करें।

सामान्य तौर पर, परीक्षण स्वयं आमतौर पर अब TestNG का उपयोग करते हुए लिखे जाते हैं, लेकिन जब एक निश्चित main विधि के साथ एक कक्षा शुरू की जाती है, तो इसमें पुराने और कई पुराने परीक्षण होते हैं, जो एक अपवाद के साथ विफल नहीं होना चाहिए। Jtreg टूल आपको पूरे चिड़ियाघर को सार करने की अनुमति देता है और इसमें कई उपयोगी सेटिंग्स होती हैं।

पैच तैयार है! कहां भेजें?

यदि आप अभी भी जावा में योगदान करने का निर्णय लेते हैं, तो आप OpenJDK पदानुक्रम के नीचे हैं। आप उस पर असाधारण साधारण पैच भेज सकते हैं (कहते हैं, प्रलेखन में एक मामूली टाइपो)। ऐसा करने के लिए, आप एक पैच फ़ाइल एकत्र करते हैं (उदाहरण के लिए, hg diff -g का उपयोग करके) और इसे विषय में शब्द [PATCH] साथ उपयुक्त मेलिंग सूची में भेजें। एक छोटे से पैच को स्पष्टीकरण के साथ पत्र के शरीर में सीधे भेजा जाता है। यदि आपके पैच के लिए JIRA में टिकट है, तो टिकट संख्या को विषय पंक्ति में भी इंगित किया जाना चाहिए। इसके बाद, प्रतीक्षा करें जब तक कि डेवलपर्स में से एक पैच को प्रायोजित करने के लिए सहमत न हो। यदि आपको बिल्कुल भी जवाब नहीं दिया जाता है, तो आप हर दो सप्ताह में एक बार विनम्रता से लोगों को लात मार सकते हैं। आपको मेलिंग सूची द्वारा गलत किया गया होगा, लेकिन तब आपको सबसे अधिक संभावना बताई जाएगी कि पैच वास्तव में कहां भेजा जाना चाहिए।

यदि आपका पैच पूरी तरह से तुच्छ नहीं है, तो आप उसी तरह से जा सकते हैं, लेकिन जब तक आप ओरेकल योगदानकर्ता समझौते पर हस्ताक्षर नहीं करते, वे इसे नहीं कर सकते। स्वाभाविक रूप से, चूंकि एक बड़ा निगम परियोजना के पीछे है, कानूनी मुद्दे अपरिहार्य हैं। आप सहमत हैं कि आप अपने व्यक्तिगत लेखक का कोड भेजते हैं और इसे ओरेकल के सह-स्वामित्व में स्थानांतरित कर देते हैं (लेकिन साथ ही साथ अपने अधिकारों को नहीं खोते हैं और आप इसके साथ जो चाहते हैं वह कर सकते हैं, और ओरेकल वही करेगा जो वह चाहता है)। आप समझौते को प्रिंट करते हैं, इसे पढ़ते हैं (बहुत कुछ नहीं है), हस्ताक्षर करें, स्कैन करें और निर्दिष्ट ई-मेल पर भेजें। तैयार रहें कि प्रसंस्करण में कम से कम एक सप्ताह लगता है। सफल होने पर, आपको ई-मेल द्वारा सूचित किया जाएगा, और आपका नाम एक लंबी सूची में दिखाई देगा। इस बिंदु पर, आपको OpenJDK योगदानकर्ता का दर्जा मिलता है, और आपके पैच प्रायोजक हो सकते हैं।

एक स्तर आठ योगिनी कैसे बनें?

जब आप सफलतापूर्वक 2-3 गैर-तुच्छ पैच धक्का देते हैं, तो आप OpenJDK लेखक की स्थिति पूछ सकते हैं। ऐसा करने के लिए, आप प्रोजेक्ट लीडर को एक पत्र लिखते हैं (jdk9 में यह मार्क रेनहोल्ड है) और अपने पैच को कमिट के लिंक के साथ सूचीबद्ध करें। सफल होने पर आपके लिए नए अवसर खुलते हैं। सबसे पहले, सर्वर cr.openjdk.java.net (SSh सार्वजनिक कुंजी) के लिए sftp एक्सेस की आवश्यकता होती है, जहां आप कोड समीक्षा के लिए अनुरोध प्रकाशित कर सकते हैं। दूसरे, आपको अंततः JIRA खाता मिलता है। अब आप आनन्दित हो सकते हैं और लेख के पहले भाग के बारे में भूल सकते हैं: आप अपने आप को ठीक से कीड़े की रिपोर्ट कर सकते हैं, और न केवल उस घटक में जिसमें आपने पैच भेजे थे। आप बग के लिए वोट कर सकते हैं, सूचनाओं की सदस्यता ले सकते हैं, और इसी तरह। अब से, आपका नाम इस सूची में दिखाई देगा। यहां आप विभिन्न परियोजनाओं में लोगों की स्थिति देख सकते हैं।

हालाँकि, OpenJDK लेखक स्तर पर, आपको अभी भी अपने पैच के लिए प्रायोजकों की आवश्यकता है। अब आपको पैच को मेलिंग सूची में नहीं भेजना चाहिए, लेकिन webrev टूल का उपयोग करके HTML- e-cs का एक विशेष सेट जनरेट करें (यह एक ksh-script है और मुझे इसके लिए उबंटू से एक वर्चुअल मशीन स्थापित करनी थी, विंडोज के तहत मैं इसे पिन नहीं कर सकता था)। यह कुछ इस तरह दिखता है। वेबरेव जनरेट करके, आप इसे कोड-समीक्षा मेलिंग सूची पर लिंक भेजते हैं और टिप्पणियों के लिए तैयार हो जाते हैं। किसी को अभी भी अपना कोड करने के लिए सहमत होना होगा, लेकिन आप खुद कमिट के लेखक होंगे।

अगला स्तर OpenJDK कमेटी है। एक बनने के लिए, आपको इस शीर्षक के लिए परियोजना की मुख्य सूची में कुछ कमेंट द्वारा नामित किया जाना चाहिए (उदाहरण के लिए, jdk9-dev )। इसके लिए, एक नियम के रूप में, परियोजना में कम से कम 8 गैर-तुच्छ परिवर्तन होना आवश्यक है। मतदान बहुत सरल है - किसी के खिलाफ नहीं होना चाहिए। इस शीर्षक के साथ आपको प्रायोजक की आवश्यकता नहीं होगी। आप अपने बदलाव खुद कर सकते हैं और दूसरों को प्रायोजित भी कर सकते हैं। लेकिन, ज़ाहिर है, यह कोड समीक्षा को रद्द नहीं करता है।

अंत में, आप OpenJDK समीक्षक के स्तर तक पहुँच सकते हैं। यहाँ यह एक ही बात के बारे में है - नामांकन, मतदान, लेकिन आवश्यकताएं पहले से ही सख्त हैं। केवल समीक्षक नामांकन कर सकते हैं और वोट कर सकते हैं, वोट के अभाव में पक्ष में न्यूनतम तीन वोट की आवश्यकता होती है। यह स्थिति आपको अन्य लोगों के परिवर्तनों की औपचारिक रूप से समीक्षा करने की अनुमति देगी। आप यहां स्थितियां और उनके अधिग्रहण की प्रक्रिया के बारे में अधिक पढ़ सकते हैं।

निष्कर्ष

जावा में फिक्सिंग बग, सिद्धांत रूप में, बहुत मुश्किल नहीं है यदि आप सब कुछ से निपटने के लिए पर्याप्त धैर्य और दृढ़ता दिखाते हैं। सार्वजनिक API को बदलने वाली नई सुविधाओं को बढ़ावा देना बहुत कठिन है। यहां आपके शानदार विचारों को आसानी से लपेटा जा सकता है। अधिक वजनदार दिखने के लिए, मैं सुविधाओं के साथ शुरू नहीं करने की सलाह देता हूं, लेकिन कुछ सरल बगों पर कम से कम एक लेखक बन जाता हूं। आप सिर्फ JIRA में खुले टिकटों में खुदाई कर सकते हैं और कुछ ऐसा पा सकते हैं जो आपको सरल लगे। इसमें से बहुत सारे हैं, उन्नत डेवलपर्स के पास हमेशा छोटी चीज़ों को रेक करने का समय नहीं होता है। यदि आप अभी भी एक सुविधा प्रदान करते हैं, तो मुद्दे के इतिहास का अध्ययन करने के लिए बहुत आलसी न हों: मेलिंग सूचियों के अभिलेखागार में देखें। शायद इस पर चर्चा की गई थी और किसी कारण से इसे नहीं करने का फैसला किया। इस बारे में सोचें कि क्या आपके पास नए कारण हैं।

खुशी के साथ कार्यक्रम और जावा को बेहतर बनाएं!