👨‍👦‍👦 🥖 👩🏻‍🤝‍👨🏽 हम Netbeans के लिए एक प्लगइन लिख रहे हैं। एक भाग 💺 🌦️ 🚵🏻

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

ट्रेनिंग

Netbeans के लिए प्लगइन्स लिखने के लिए, हमें सबसे पहले विकास मॉड्यूल को सक्रिय करना होगा। ऐसा करने के लिए, मेनू "टूल्स -> प्लगइन्स" पर जाएं और टैब पर "इंस्टॉल किया गया" सक्रिय "नेटबीन्स को विकसित करना"। इसके बाद, हमें नेटबीन्स प्लेटफॉर्म प्रलेखन की आवश्यकता होगी। यह उपलब्ध प्लगइन्स टैब में एक प्लगइन के रूप में उपलब्ध है और इसे नेटबीन्स एपीआई डॉक्यूमेंटेशन कहा जाता है। शायद यही सब है।

परियोजना निर्माण

एक नया प्रोजेक्ट बनाएं ("फ़ाइल-> नया प्रोजेक्ट-> नेटबींस मॉड्यूल-> मॉड्यूल") और "अगला" पर क्लिक करें।
फ़ील्ड में "प्रोजेक्ट नाम" वांछित नाम दर्ज करें, इसे "पास्टबिन" होने दें, "अगला" पर क्लिक करें।
"कोड नाम आधार" फ़ील्ड में भरें, मान लें कि "com.pastebin.pastebinplugin" - यह प्लगइन का कोड नाम और संसाधनों और कक्षाओं का मार्ग दोनों होगा। "मॉड्यूल प्रदर्शन नाम" फ़ील्ड प्लग-इन परियोजनाओं के दृश्यमान नाम को सेट करती है, हम इसे "Send to Pastebin.com" के रूप में भरते हैं, लेकिन आप वहां अपना कुछ भी दर्ज कर सकते हैं। शेष फ़ील्ड स्पर्श नहीं करते हैं, "समाप्त करें" पर क्लिक करें।
एक नई परियोजना बनाई गई है, जिसकी संरचना में यह रूप है।
परियोजना की संरचना

क्रिया निर्माण

अब हम सीधे प्लगइन के निर्माण के लिए आगे बढ़ते हैं, अर्थात् इसकी कार्रवाई के वर्ग के लिए। "नया-> अन्य-> मॉड्यूल विकास" में "कार्रवाई" चुनें और "अगला" पर क्लिक करें।
एक एक्शन क्लास चुनना

हमें कार्रवाई का प्रकार चुनने के लिए कहा जाता है: "लगातार सक्षम" या "सक्षम प्रदान किया गया।" चूँकि हम संपादक से चयनित कोड लेना चाहते हैं, अर्थात, हमारा प्लग-इन तभी सक्रिय होना चाहिए जब कोड संपादक खुला हो, तब हम दूसरे प्रकार का चयन करेंगे "Condually Enabled"। "कुकी वर्ग" में, हमने "EditorCookie" डाला, क्योंकि हमें संपादक तक पहुंच की आवश्यकता है, और संपूर्ण परियोजना के लिए नहीं। "यूजर सेलेक्ट्स वन नोड" चुना जाता है, क्योंकि हमें कम से कम एक साइट खोलने के लिए प्लग-इन की आवश्यकता होती है जो EditorCookie का समर्थन करती है। "अगला" पर क्लिक करें।

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

वर्ग का नाम "पास्टेबिनएशन" से भरा है। "प्रदर्शन नाम" को यथासंभव स्पष्ट रूप से भरना बेहतर है, उदाहरण के लिए, "pastebin.com पर भेजें", क्योंकि यह मेनू आइटम का प्रदर्शन नाम है। फिर 16x16 आइकन चुनें। यदि आपने पिछले चरण में टूलबार पर जगह का चयन किया है, तो आपको 24x24 के आकार के साथ एक आइकन जोड़ना होगा। उसके बाद “Finish” पर क्लिक करें।

हमारे द्वारा बनाई गई सभी सेटिंग्स जनरेट किए गए कोड में दिखाई देंगी:

@ActionID( category = "Edit", id = "com.pastebin.pastebinplugin.PastebinAction") @ActionRegistration( iconBase = "com/pastebin/pastebinplugin/pastebin.png", displayName = "#CTL_PastebinAction") @ActionReference(path = "Menu/Edit", position = 1250) @Messages("CTL_PastebinAction=Send to pastebin.com")

पहले लॉन्च

यद्यपि हमने वास्तव में अभी तक कुछ भी नहीं लिखा है, लेकिन सत्यापन के लिए प्लगइन चलाना पहले से ही संभव है। "रन" पर क्लिक करें और एक नई नेटबिन विंडो के प्रकट होने की प्रतीक्षा करें। उसके बाद, एक मनमाना पाठ फ़ाइल खोलें और एक समान चित्र देखें:

अज्ञात कारणों के लिए, नई नेटबींस विंडो रूसी स्थानीयकरण के साथ शुरू हुई थी, लेकिन इससे कोई फर्क नहीं पड़ता, हम जल्द ही अपनी प्लग-इन रूसी भाषा सिखाएंगे, लेकिन अब के लिए, विंडो बंद करें और अंत में कोड लिखना शुरू करें।

सामान्य

यह अनुमान लगाना आसान है कि प्लगइन का निष्पादन एक्शनफार्म विधि के साथ शुरू होगा, इसलिए हम इस पद्धति के शरीर में कोड लिखेंगे। आरंभ करने के लिए, हम EditorCookie के साथ खेलते हैं, जिसे IDE ने स्वयं हमें पेश किया। लेकिन इससे पहले हम आवश्यक पुस्तकालयों को जोड़ते हैं, अन्यथा बाद का कोड बस संकलन नहीं करेगा।
प्रोजेक्ट गुणों में, "लाइब्रेरीज़" टैब चुनें और "ऐड" पर क्लिक करें।
"नोड्स एपीआई" और "संपादक" जोड़ें।
अब यह कोड लिखते हैं:

 public void actionPerformed(ActionEvent ev) { try { JEditorPane pane = context.getOpenedPanes()[0]; pane.setText("// Hello, editor pane!\n"+pane.getText()); context.openDocument().insertString(0, "// Hello, document!\n", null); } catch (Exception ex) { Exceptions.printStackTrace(ex); } }

यह कोड ओपन सोर्स टेक्स्ट में कुछ पंक्तियों को जोड़ता है जब प्लगइन कहा जाता है। यह दो अलग-अलग तरीकों से किया जाता है - JEditorPane के माध्यम से और स्टाइलडेडक्वामेंट के माध्यम से।
प्रोजेक्ट लॉन्च करके, कोई भी फ़ाइल खोलने और प्लगइन को कॉल करने पर, हम देखेंगे कि दो लाइनें कैसे जोड़ी गईं:
// नमस्कार, दस्तावेज़!
// नमस्ते, संपादक फलक!

ठीक है, चलो प्लगइन को लिखना जारी रखें। हमें पाठ के चयनित भाग, साथ ही साथ संपादित स्रोत के प्रारूप को प्राप्त करने की आवश्यकता है, ताकि हम पास्टबिन में हाइलाइटिंग सिंटैक्स को सही ढंग से कॉन्फ़िगर कर सकें। हम पहली विधि - JEditorPane का उपयोग करेंगे, क्योंकि इसमें हमारे लिए आवश्यक सभी विधियाँ हैं। हमें संपादित किए जा रहे दस्तावेज़ के MIME प्रकार के आधार पर सिंटैक्स हाइलाइटिंग प्रारूप मिलेगा।

 public void actionPerformed(ActionEvent ev) { JEditorPane currentPane = context.getOpenedPanes()[0]; final String mimeType = NbEditorUtilities.getMimeType(currentPane); final String code = getSelectedText(currentPane); System.out.println(mimeType + "\n" + code); } private String getSelectedText(JEditorPane currentPane) { String text = currentPane.getSelectedText(); if (text == null) return currentPane.getText(); return text; }

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

इसलिए, कोड और उसका MIME प्रकार हाथ में होने पर, हम क्लाइंट लिखना शुरू कर सकते हैं। यहां आप पास्टबिन एपीआई पर मदद ले सकते हैं और अपनी डेवलपर कुंजी का पता लगा सकते हैं।
कोड: PastebinRequest , PastebinSender ।
एक फ़ील्ड जोड़ें:
निजी अंतिम PastebinRequest अनुरोध;
और इसे कंस्ट्रक्टर में इनिशियलाइज़ करें:
अनुरोध = नया PastebinRequest ();
अगला, क्रियापद्धित विधि अपडेट करें:

 JEditorPane currentPane = context.getOpenedPanes()[0]; final String mimeType = NbEditorUtilities.getMimeType(currentPane); final String code = getSelectedText(currentPane); if (code != null) { RequestProcessor.getDefault().execute(new Runnable() { @Override public void run() { setupRequest(code, mimeType); String pastedUrl = PastebinSender.sendRequest(request.getRequestMessage()); System.out.println(pastedUrl); } }); }

मैंने अपनी आवश्यकताओं को पूरा करने के लिए setupRequest विधि को कॉन्फ़िगर किया है, लेकिन आप अपने लिए पैरामीटर बदल सकते हैं:

 private void setupRequest(String code, String mimeType) { request.initRequest(); request.setSourceCode(code); request.setFormat(mimeType); request.setExpireDate(PastebinRequest.EXPIRE_DATE.ONE_DAY); request.setUnlisted(true); request.setName(""); }

शुरू करने से पहले, आइए इसे सक्रिय करने के लिए हॉटकी जोड़कर अपने प्लगइन की कॉल को सरल करें।
लाइन बदलें:
@ActionReference (पथ = "मेनू / संपादन", स्थिति = 1250)
पर:
@ActionReferences ({
@ActionReference (पथ = "मेनू / संपादन", स्थिति = 1250),
@ActionReference (पथ = "शॉर्टकट", नाम = "OS-P")
})
इस मामले में "OS-P," का अर्थ है "Alt + Shift + P।" यदि मौजूदा गर्म कुंजी के साथ कोई संघर्ष नहीं है, तो परियोजना शुरू करना, हम देखेंगे:

पाठ का चयन करें, निर्दिष्ट संयोजन पर क्लिक करें और कंसोल पर पोस्ट किए गए कोड का लिंक देखें। हुर्रे, कॉमरेड्स, हमने यह किया! यह केवल इस लिंक के साथ एक संवाद बॉक्स प्रदर्शित करने के लिए बनी हुई है। चलिए शुरू करते हैं।
एक नया वर्ग बनाएं और इसे "UrlDialog" कहें। इस वर्ग का स्रोत कोड यहाँ है । PastebinAction वर्ग में एक विधि जोड़ें:

 private void showUrlDialog(final String pastedUrl) { SwingUtilities.invokeLater(new Runnable() { @Override public void run() { Frame frame = WindowManager.getDefault().getMainWindow(); UrlDialog dialog = new UrlDialog(frame, pastedUrl); dialog.setLocation(frame.getWidth() / 2, frame.getHeight()/2); dialog.setVisible(true); } }); }

क्रियापद्धित विधि में, पंक्ति को प्रतिस्थापित करें:
System.out.println (pastedUrl);
पर:
showUrlDialog (pastedUrl);
आपको एक और पुस्तकालय भी जोड़ना होगा, इसके लिए, प्रोजेक्ट गुणों में, "लाइब्रेरीज़" टैब को फिर से खोलें और "विंडो एप्लिकेशन एपीआई" जोड़ें।
और अंत में, आपको बंडल को खोलने की आवश्यकता है। स्थानीयकरण फ़ाइल को जोड़े और कुछ पंक्तियों को जोड़ें:
UrlDialog.title = पिछले यूआरएल
UrlDialog.copyButton.text = कॉपी करें

अब आप प्रोजेक्ट शुरू कर सकते हैं। कोड का चयन करें, प्लगइन को सक्रिय करें और विंडो देखें:
डायलॉग बॉक्स

जब आप "कॉपी" बटन पर क्लिक करते हैं, तो लिंक क्लिपबोर्ड पर कॉपी किया जाता है। आप इस विंडो को कॉपी करने के तुरंत बाद बना सकते हैं, आप आम तौर पर विंडो को नहीं दिखा सकते हैं, लेकिन इसे तुरंत क्लिपबोर्ड पर कॉपी कर सकते हैं। कृपया अपनी कल्पना दिखाएं और जैसा आप चाहते हैं वैसा करें।

स्थानीयकरण

लेख के बीच में, मैंने वादा किया था कि हम प्लगइन को रूसी भाषा सिखाएंगे। यह मुश्किल नहीं है। PastebinAction वर्ग से पहले नवीनतम एनोटेशन पर एक नज़र डालें। वहाँ लाइन flaunts:
@ संदेश ("CTL_PastebinAction = pastebin.com पर भेजें")
इसे हटाने के लिए स्वतंत्र महसूस करें, फिर बंडल खोलें।
CTL_PastebinAction = pastebin.com पर भेजें
अब, प्रोजेक्ट ब्राउज़र विंडो में, बंडल.प्रॉपीटी फ़ाइल पर राइट-क्लिक करें और "Add-> लोकेल" चुनें। पूर्वनिर्धारित स्थानीयकरणों की सूची से, रूसी का चयन करें और ठीक पर क्लिक करें।

एक नई फ़ाइल जोड़ी जाएगी, जिसे खोला और संशोधित किया जाना चाहिए। आप पहली पंक्ति का अनुवाद नहीं कर सकते हैं, अन्यथा यह प्रोजेक्ट ब्राउज़र विंडो में अनुवादित किया जाएगा और खराब दिखेगा:
OpenIDE-Module-Name = Send to Pastebin.com
UrlDialog.title = लिंक
UrlDialog.copyButton.text = कॉपी करें
CTL_PastebinAction = pastebin.com पर भेजें
खैर, यह काम की जांच करने का समय है। हम शुरू करते हैं और देखते हैं:

एक NBM मॉड्यूल बनाना

तो, आखिरी चीज जो हमें करने के लिए बनी हुई है वह है प्लगइन को नेटबीन्स से कनेक्ट करना। प्रोजेक्ट के शीर्षक पर राइट-क्लिक करें और "एनबीएम बनाएं" चुनें। Netbeans कृपया हमारी गतिविधि के उत्पाद को उस फ़ाइल में एकत्रित करेगा, जो उसके लिए समझ में आता है, जो केवल "टूल्स-> प्लगइन्स-> डाउनलोड किए गए" से "प्लग इन जोड़ें" पर क्लिक करके और हमारे nbm-file का चयन करने से जुड़ा होगा।

परिणाम

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

नेटबीन्स प्लेटफॉर्म पर बहुत अधिक जानकारी नहीं है, लेकिन यहां एक लिंक है जहां आप कम से कम कुछ पता लगा सकते हैं।

हम Netbeans के लिए एक प्लगइन लिख रहे हैं। एक भाग