🚚 🤹🏼 🚶🏼 Zetes: जावा बहु-मंच GUI के साथ लेकिन Oracle JVM के बिना 🤽🏽 👨‍🎓 😿

अमूर्त

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

वास्तव में, आउटपुट पर आपको एक निष्पादन योग्य फ़ाइल मिलेगी जो केवल सिस्टम एपीआई पर निर्भर करती है, जिस पर कोई "जावा में लिखा" स्टैम्प नहीं होगा।

ढांचे के सभी घटकों में उदार लाइसेंस (बीएसडी या अपाचे) हैं, जो आपको किसी भी (वाणिज्यिक सहित) विकास में उनका उपयोग करने की अनुमति देता है।

फ्रेमवर्क सार्वजनिक अल्फा-संस्करण के चरण में है, जिसका अर्थ इसके प्रदर्शन में से कुछ है, लेकिन अप्रमाणित है। उपयोग को प्रोत्साहित किया जाता है (मैं समस्याओं के बारे में शिकायतों को सुनने और उन्हें हल करने में मदद करने की कोशिश करूंगा), लेकिन प्रदर्शन की गारंटी नहीं है।

सभी प्लेटफार्मों के तहत फ्रेमवर्क के काम का प्रदर्शन करने वाले अनुप्रयोगों का एक तैयार-निर्मित, इकट्ठे संस्करण यहां है ।

मैं बिल्ली के नीचे एहसान के विवरण में रुचि रखने वाले सभी लोगों से पूछता हूं।

1. परिचय

एक छोटा गेय परिचय होगा। आप इस अनुभाग को सुरक्षित रूप से छोड़ सकते हैं यदि आप रुचि नहीं रखते हैं कि यह परियोजना क्यों उत्पन्न हुई और यह कैसे विकसित हुई। समस्या का तकनीकी पक्ष धारा 2 से शुरू होता है।

1.1। शीर्षक के बारे में

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

1.2। पहला कदम

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

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

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

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

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

1.3। डोपिंग Android Classpath

बेशक, एंड्रॉइड लिनक्स पर बनाया गया है। और निश्चित रूप से, क्लासपैथ का पूरा मूल भाग पॉज़िक्स में निहित है। मुझे एक गंभीर कार्य का सामना करना पड़ा - एंड्रॉइड क्लासपथ को Win32 में पोर्ट करने के लिए। करीब 3 महीने पहले की बात है। चूँकि पूरी असेंबली MinGW पर आधारित है, इसलिए कुछ बुनियादी Posix फ़ंक्शन मौजूद थे (जो कि विंडोज़ में बिल्कुल दोहराए गए थे)। लेकिन, अफसोस, उनमें से कुछ थोड़े अलग तरीके से काम करते हैं (उदाहरण के लिए, विनसॉक, हालांकि यह बीएसडी सॉकेट्स के साथ मेल खाना चाहता है, लेकिन, अफसोस, कुछ जगहों पर, विशेष रूप से I / O से संबंधित भाग में उनसे काफी भिन्न होता है)। दूसरा भाग पूरी तरह से विंडोज में अनुपस्थित है क्योंकि इसकी जरूरत है। उदाहरण के लिए, विंडोज में अनाम पाइप बहुत सीमित हैं और गैर-अवरोधक I / O का उपयोग करने की अनुमति नहीं देते हैं, जो कि कुछ नए एपीआई कार्यों के लिए आवश्यक है।

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

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

फिलहाल, इसके मुख्य भाग में यह काम पूरा हो गया है और यह बगफिक्स चरण में है। रास्तों के साथ अभी भी कुछ परेशानियां हैं, लेकिन यह सब छोटी चीजें हैं।

परिणामस्वरूप हमें क्या मिला, हम आपका ध्यान प्रदान करते हैं।

2. यह सब क्यों जरूरी है?

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

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

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

दूसरे शब्दों में, फ्रेमवर्क का कार्य लोकप्रिय प्रणालियों के एपीआई को "एक सामान्य भाजक के लिए" लाना है, दूसरों के उपयोगी कार्यों के साथ कुछ के उपयोगी कार्यों को पूरक करना।

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

3. तो Zetes क्या है?

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

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

4. Zetes से क्या बनता है?

कार्यों के सबसे बड़े संभावित वर्ग को कवर करने के लिए, ढांचे को तीन भागों में विभाजित किया गया था:

4.1। ZetesFeet

कोर में ZetesFeet लाइब्रेरी है। इसमें एवियन, साथ ही क्लास लाइब्रेरी के दो वेरिएंट में से एक है - एवियन क्लासपाथ या एंड्रॉइड क्लासपाथ।

प्रत्येक पुस्तकालय के पेशेवरों और विपक्षों को तालिका में दिखाया गया है:

तुलना की कसौटी	एवियन क्लासपथ	Android Classpath
पूर्णता और अनुपालन	इसमें केवल बहुत न्यूनतम शामिल है, हालांकि यह फैलता है। हालाँकि, इस प्लेटफ़ॉर्म पर कम से कम किसी गंभीर प्रोजेक्ट को लॉन्च करना संभव नहीं है	सभी प्रमुख जावा कोर कक्षाओं के कार्यान्वयन में शामिल है। सैद्धांतिक रूप से, इसे किसी भी भ्रमित आवेदन का समर्थन नहीं करना चाहिए। व्यवहार में, लाइब्रेरी को Win32 में पोर्ट करने से जुड़ी जटिलताएं हो सकती हैं। बेशक, इस तरह की सभी त्रुटियों को जल्द से जल्द ठीक किया जाएगा।
निष्पादन योग्य फ़ाइल आकार	एक निष्पादन योग्य फ़ाइल जिसमें SWT कक्षाएं नहीं होती हैं, उनका आकार मेगाबाइट्स से अधिक होता है	निष्पादन योग्य फ़ाइल 25 मेगाबाइट तक फूला हुआ है। यह मुख्य रूप से स्वयं एंड्रॉइड कक्षाओं के कारण नहीं होता है (जो लगभग 5 एमबी पर कब्जा कर लेता है), लेकिन आईसीयू 4 सी में शामिल एन्कोडिंग टेबल के कारण, एंड्रॉइड क्लासपैथ में शामिल भाषा समर्थन पुस्तकालय
लाइसेंस	BSD (GPL संगत)	अपाचे (जीपीएल के साथ खुला, लेकिन असंगत)

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

इसके अलावा, ZetesFeet में सभी Zetes कक्षाएं होनी चाहिए जो किसी भी प्रकार के एप्लिकेशन के लिए विशिष्ट नहीं हैं, लेकिन किसी भी बनाने में उपयोगी हैं।

ZetesFeet के ऊपर, दो वैकल्पिक पुस्तकालय बनाए गए हैं।

4.2। ZetesHands

उनमें से पहला - ZetesHands - आपको कंसोल एप्लिकेशन बनाने की अनुमति देता है। यदि आप एक नई प्रणाली उपयोगिता बनाना चाहते हैं या, उदाहरण के लिए, कुछ डीएसएल दुभाषिया, यहाँ आप हैं। गैर-ग्राफ़िकल एप्लिकेशन ZetesHands का उपयोग करते हैं। विंडोज में, ऐसे एप्लिकेशन को एक कंसोल विंडो मिलती है। ओएस एक्स में, यह एक निष्पादन योग्य फ़ाइल के लिए संकलित करता है, लेकिन इसके लिए एक बंडल नहीं बनाया जाता है।

4.3। ZetesWings

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

Zetes का उपयोग करके एक एप्लिकेशन बनाने के लिए, आपको अपने मेकफाइल में ZetesHands.mk या ZetesWings.mk में से किसी एक लिंक को जोड़ना होगा, जो आपके द्वारा चुने गए ऐड-ऑन पर निर्भर करता है।

5. इसका उपयोग कैसे करें? आइए एक उदाहरण देखें - टिनी व्यूअर छवि दर्शक

यहां मैं सबसे सरल उपयोग के मामले का वर्णन करूंगा। सबसे पहले, हमें Zetes के इकट्ठे संस्करण की आवश्यकता है। आप इसे GitHub पर रिलीज़ पृष्ठ से ले सकते हैं। Zetes के साथ हमारे प्रयोगों के लिए एक फ़ोल्डर बनाएँ। चलो, उसे कहते हैं, zetes-works

। इसे zetes

और zetes

फ़ोल्डर को zetes

बनाएं, और डाउनलोड किए गए संग्रह से target-**

फ़ोल्डर को अनपैक करें। अब zetes-works

वापस जाएं और tinyviewer

एक tinyviewer

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

5.1। makefile

आइए शुरुआत मेकफिल से करें। जैसा कि मैंने वादा किया था, यह सरल और संक्षिप्त होगा।

 ZETES_PATH = ../zetes APPLICATION_NAME = Tiny\ Viewer BINARY_NAME = tinyview ENTRY_CLASS = tinyviewer/TinyViewerApplication include $(ZETES_PATH)/common-scripts/globals.mk include $(ZETES_WINGS_PATH)/ZetesWings.mk all: package

हम लाइन का विश्लेषण लाइन द्वारा करेंगे। पहला कदम ZETES_PATH

चर को परिभाषित करना है, जो प्रोजेक्ट डायरेक्टरी के सापेक्ष Zetes

लाइब्रेरी के लिए रास्ता तय करता है। अगला APPLICATION_NAME

, जो एप्लिकेशन का मानव-पठनीय नाम है। तब - BINARY_NAME

- निष्पादन योग्य फ़ाइल का नाम और ENTRY_CLASS

- "एंट्री पॉइंट" वाले वर्ग का नाम - फ़ंक्शन public static void main(String... args);

। वर्ग नाम स्लैश (/) के माध्यम से निर्दिष्ट किया गया है, और अवधि के माध्यम से नहीं, जैसा कि जावा डेवलपर्स के लिए सामान्य है। यही है, वास्तव में, वर्ग को tinyviewer.TinyViewerApplication

कहा tinyviewer.TinyViewerApplication

।

अगली दो पंक्तियाँ - कनेक्शन, वास्तव में, "मांस" की - असेंबली इंजन को ज़ेटेस में शामिल किया गया और हमें एक छोटा मेकफाइल लिखने की अनुमति दी। शामिल फ़ाइलों में से पहली - globals.mk

- में सामान्य परिभाषाएँ, स्थिरांक और नियम शामिल हैं, ZetesWings.mk

फ़ाइल - ZetesWings के लिए विशिष्ट है। ZetesHands का उपयोग करने के मामले में, हम क्रमशः इसके मेकफाइल को शामिल करेंगे।

अगला मूल नियम की परिभाषा है। चूंकि एक जटिल उपयोगकर्ता परियोजना के निर्माण में कुछ उन्नत चरण शामिल हो सकते हैं, इसलिए आपको स्वयं के मूल नियम को परिभाषित करना होगा। इस मामले में, हम बस पैकेज को निष्पादित करते हैं - एक नियम जो एप्लिकेशन को संकलित करेगा और इसे एक संग्रह (या ओएस एक्स पर, एक डीएमजी छवि में) में पैक करेगा। यदि आप इसे पैक नहीं करना चाहते हैं, लेकिन केवल एक कामकाजी आवेदन प्राप्त करना चाहते हैं, तो all: app

लिखें all: app

।

5.2। मुख्य वर्ग

चूंकि ZetesWings क्रॉस-प्लेटफ़ॉर्म एप्लिकेशन लिखने के लिए अभिप्रेत है, इसलिए यह आपके एप्लिकेशन के आर्किटेक्चर के हिस्से का ध्यान रखता है। विशेष रूप से, दस्तावेज़-दृश्य मॉडल इसके द्वारा परिभाषित किया गया है। इसलिए, आवेदन करने के लिए, आपको निम्नलिखित सार से विरासत में प्राप्त वर्ग के अनुसार बनाना होगा:

ApplicationBase

का मुख्य वर्ग है जो इसके व्यवहार के वैश्विक मापदंडों को परिभाषित करता है। वास्तव में, यह एक प्रति में बनाया गया है (हालांकि सख्त अर्थ में यह एक सिंगलटन नहीं है)। इसमें एक प्रवेश बिंदु रखना भी वांछनीय है ( main

कार्य)
ViewWindowsManagerBase

एक विंडो-व्यू मैनेजमेंट क्लास है। दस्तावेजों के लिए खिड़कियां बनाता है, उनसे लिंक संग्रहीत करता है। खिड़कियों के बीच संचार इसके माध्यम से होता है।
MenuConstructorBase

- एक वर्ग जो मेनू को नियंत्रित करता है - दोनों वैश्विक (OS X में) और विंडो मेनू। यह हॉट आइटम की सही परिभाषा के लिए मेनू आइटम की उपस्थिति / गायब होने / निष्क्रिय होने के लिए जिम्मेदार है। इस वर्ग को दरकिनार करते हुए मुख्य एप्लिकेशन मेनू के साथ काम करना बेहद अवांछनीय है। सुधार के सभी अनुरोध स्वीकार किए जाते हैं। मुख्य कार्य मंच से मेनू की "सांस्कृतिक स्वतंत्रता" सुनिश्चित करना है
ViewWindowBase

- कुछ दस्तावेज़ की सामग्री दिखाने वाली खिड़की। इस कार्यान्वयन में, यह SWT से Shell

की अवधारणा से निकटता से संबंधित है
Document

- a document। सभी वर्णित संस्थाओं का सबसे सार। getTitle()

फ़ंक्शन के साथ अपना शीर्षक (विंडो शीर्षक और मेनू आइटम बनाने के लिए) रिपोर्ट करने में सक्षम होना चाहिए, और getTitle()

फ़ंक्शन का उपयोग करके अपने संसाधनों को साफ करने के लिए भी बाध्य करना चाहिए

सूचीबद्ध सभी कक्षाएं (सरल Document

इंटरफ़ेस को छोड़कर) टेम्पलेट हैं जो एक दूसरे से जुड़े हुए हैं। और अब हमें उनमें से प्रत्येक से एक वारिस बनाने और इन वारिसों को एक साथ बांधने की आवश्यकता है।

संबंधित टेम्प्लेट बहुत सुविधाजनक हैं - वे एप्लिकेशन के कंकाल को परिभाषित करते हैं, जैसा कि यह था - एक "फ़ॉर्म" जिसमें तैयार-किए गए वर्गों को विघटित किया जा सकता है, और वे एक साथ काम करेंगे। मुझे आशा है कि आप इस दृष्टिकोण का आनंद लेंगे जितना मैं करता हूं।

5.2.1। ImageDocument

हम नीचे-निर्भरता के अनुसार निर्माण का नेतृत्व करेंगे। चलो दस्तावेज़ वर्ग के साथ शुरू करते हैं। हमारे मामले में, यह एक छवि है जिसे SWT का उपयोग करके लोड किया जाना चाहिए और मेमोरी में संग्रहीत किया जाना चाहिए। हमारी कक्षा इस तरह दिखाई देगी:

ImageDocument.java

 package tinyviewer; import java.io.FileInputStream; import java.io.IOException; import java.io.InputStream; import org.eclipse.swt.graphics.Image; import org.eclipse.swt.graphics.ImageData; import org.eclipse.swt.widgets.Display; import zetes.wings.abstracts.Document; public class ImageDocument implements Document { private Image image; private String fileName; private static Image loadImage(InputStream stream) throws IOException { try { Display display = Display.getDefault(); ImageData data = new ImageData(stream); if (data.transparentPixel > 0) { return new Image(display, data, data.getTransparencyMask()); } return new Image(display, data); } finally { stream.close(); } } private static Image loadImage(String fileName) throws IOException { return loadImage(new FileInputStream(fileName)); } public ImageDocument(String fileName) throws IOException { this.fileName = fileName; this.image = loadImage(fileName); } public String getTitle() { return fileName; } public Image getImage() { return image; } public void dispose() { if (image != null && !image.isDisposed()) image.dispose(); } @Override protected void finalize() throws Throwable { dispose(); super.finalize(); } }

यहां सब कुछ लगभग स्पष्ट है। loadImage

फ़ंक्शन छवि को लोड करने के लिए जिम्मेदार है और इसे निर्माता में कहा जाता है। getTitle()

फ़ंक्शन फ़ाइल नाम लौटाता है, और getTitle()

चित्र संसाधन जारी करता है। बस मामले में, finalize()

भी ओवरराइड किया finalize()

है ताकि dispose()

कहा जाता है।

चूँकि हम केवल तस्वीर को देखने के साथ काम कर रहे हैं, हम कोई भी संशोधित तरीके नहीं बनाते हैं।

5.2.2। imageView

यह वर्ग सीधे Zetes से संबंधित नहीं है, लेकिन, फिर भी, हमारे आवेदन इसके बिना नहीं कर सकते। यह एक विशेष रूप से लिखित SWT घटक है जो स्क्रीन पर एक चित्र प्रदर्शित करता है।

ImageView.java

 package tinyviewer; import org.eclipse.swt.events.PaintEvent; import org.eclipse.swt.events.PaintListener; import org.eclipse.swt.graphics.GC; import org.eclipse.swt.graphics.Image; import org.eclipse.swt.graphics.Point; import org.eclipse.swt.graphics.Rectangle; import org.eclipse.swt.widgets.Canvas; import org.eclipse.swt.widgets.Composite; public class ImageView extends Canvas { Image image = null; Image zoomedImage = null; double zoom = 1.0; public ImageView(Composite arg0, int arg1) { super(arg0, arg1); addPaintListener(new PaintListener() { @Override public void paintControl(PaintEvent e) { draw(e.gc); } }); } protected void draw(GC gc) { if (image != null) { checkZoomedImage(); Point viewSize = getSize(); Point imageSize = new Point(zoomedImage.getBounds().width, zoomedImage.getBounds().height); int xpos = viewSize.x > imageSize.x ? viewSize.x / 2 - imageSize.x / 2 : 0; int ypos = viewSize.y > imageSize.y ? viewSize.y / 2 - imageSize.y / 2 : 0; gc.drawImage(zoomedImage, xpos, ypos); } } public Point desiredSize() { if (image == null) return new Point(1, 1); else return new Point((int)(image.getImageData().width * zoom), (int)(image.getImageData().height * zoom)); } protected void checkZoomedImage() { if (zoomedImage == null || zoomedImage.isDisposed()) { Rectangle bounds = image.getBounds(); zoomedImage = new Image(image.getDevice(), (int)(bounds.width * zoom), (int)(bounds.height * zoom)); GC gc = new GC(zoomedImage); gc.drawImage(image, 0, 0, bounds.width, bounds.height, 0, 0, (int)(bounds.width * zoom), (int)(bounds.height * zoom)); gc.dispose(); } } public void setImage(Image image) { this.image = image; if (zoomedImage != null) zoomedImage.dispose(); this.redraw(); } public Image getImage() { return image; } public void setZoom(double zoom) { this.zoom = zoom; if (zoomedImage != null) zoomedImage.dispose(); this.redraw(); } public double getZoom() { return zoom; } }

इसकी सारी जटिलता कई रैखिक अभिव्यक्तियों में निहित है जो छवि को खिड़की के केंद्र में रखती है अगर यह इस खिड़की से छोटा है। ज़ूम से संबंधित सभी चीजें - तस्वीर को ज़ूम इन / आउट करने की क्षमता - वर्तमान में उपयोग नहीं की जाती है। अगर प्रिय पाठकों को इस कक्षा में कोई बकवास लगता है, तो मैं आपसे टिप्पणी में विस्तार से व्याख्या करने की विनती करता हूं जहां मैं गलत हूं। काश, SWT को बहुत खराब तरीके से प्रलेखित किया जाता है, तो कई चीजों का शाब्दिक अर्थ "वैज्ञानिक प्रहार" द्वारा पता लगाना था।

5.2.3। ImageViewWindow

चलिए अगली कक्षा में जाते हैं - व्यू-विंडो क्लास, जो चित्र प्रदर्शित करता है। यह वर्ग ImageView

वर्ग का उपयोग करता है। संक्षेप में, विंडो केवल इस ImageView

चारों ओर एक फ्रेम होगी।

ImageViewWindow.java

 package tinyviewer; import java.util.HashSet; import org.eclipse.swt.SWT; import org.eclipse.swt.custom.ScrolledComposite; import org.eclipse.swt.dnd.DND; import org.eclipse.swt.dnd.DropTarget; import org.eclipse.swt.dnd.DropTargetAdapter; import org.eclipse.swt.dnd.FileTransfer; import org.eclipse.swt.dnd.Transfer; import org.eclipse.swt.events.ControlEvent; import org.eclipse.swt.events.ControlListener; import org.eclipse.swt.graphics.Image; import org.eclipse.swt.graphics.Point; import org.eclipse.swt.layout.FillLayout; import org.eclipse.swt.widgets.Shell; import org.eclipse.wb.swt.SWTResourceManager; import zetes.wings.base.ViewWindowBase; public class ImageViewWindow extends ViewWindowBase<ImageDocument> { private ScrolledComposite scrolledComposite; private DropTarget scrolledCompositeDropTarget, imageViewDropTarget; private ImageView imageView; private HashSet<DropTargetAdapter> dropTargetAdapters = new HashSet<DropTargetAdapter>(); public void addDropTargetListener(DropTargetAdapter dropTargetAdapter) { dropTargetAdapters.add(dropTargetAdapter); if (imageViewDropTarget != null && !imageViewDropTarget.isDisposed()) { scrolledCompositeDropTarget.addDropListener(dropTargetAdapter); imageViewDropTarget.addDropListener(dropTargetAdapter); } } public void removeDropTargetListener(DropTargetAdapter dropTargetAdapter) { dropTargetAdapters.remove(dropTargetAdapter); if (imageViewDropTarget != null && !imageViewDropTarget.isDisposed()) { scrolledCompositeDropTarget.removeDropListener(dropTargetAdapter); imageViewDropTarget.removeDropListener(dropTargetAdapter); } } /** * Create contents of the window. * * @wbp.parser.entryPoint */ @Override protected Shell constructShell() { Shell shell = new Shell(SWT.TITLE | SWT.CLOSE | SWT.MIN | SWT.MAX | SWT.RESIZE | SWT.BORDER | SWT.DOUBLE_BUFFERED); shell.setBackground(SWTResourceManager.getColor(SWT.COLOR_BLACK)); shell.setMinimumSize(new Point(150, 200)); shell.setImages(new Image[] { SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos16.png"), // Necessary in Windows (for taskbar) SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos64.png"), // Necessary in Windows (for Alt-Tab) SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos512.png") // Necessary in OS X }); shell.setLayout(new FillLayout(SWT.HORIZONTAL)); scrolledComposite = new ScrolledComposite(shell, SWT.H_SCROLL | SWT.V_SCROLL | SWT.NO_BACKGROUND); scrolledComposite.setExpandHorizontal(true); scrolledComposite.setExpandVertical(true); imageView = new ImageView(scrolledComposite, SWT.NONE); imageView.setBounds(0, 0, 200, 127); imageView.setVisible(false); imageView.setBackground(shell.getDisplay().getSystemColor(SWT.COLOR_BLACK)); // Drop targets scrolledCompositeDropTarget = new DropTarget(scrolledComposite, DND.DROP_MOVE); scrolledCompositeDropTarget.setTransfer(new Transfer[] { FileTransfer.getInstance() }); imageViewDropTarget = new DropTarget(imageView, DND.DROP_MOVE); imageViewDropTarget.setTransfer(new Transfer[] { FileTransfer.getInstance() }); for (DropTargetAdapter adapter : dropTargetAdapters) { scrolledCompositeDropTarget.addDropListener(adapter); imageViewDropTarget.addDropListener(adapter); } scrolledComposite.setContent(imageView); scrolledComposite.setMinSize(imageView.desiredSize()); scrolledComposite.setBackground(shell.getDisplay().getSystemColor(SWT.COLOR_BLACK)); scrolledComposite.addControlListener(new ControlListener() { @Override public void controlResized(ControlEvent arg0) { updateImageViewSize(); } @Override public void controlMoved(ControlEvent arg0) { } }); return shell; } private void updateImageViewSize() { Point desired = imageView.desiredSize(); Point clientAreaSize = new Point(scrolledComposite.getClientArea().width, scrolledComposite.getClientArea().height); int width = Math.max(clientAreaSize.x, desired.x); int height = Math.max(clientAreaSize.y, desired.y); Point newSize = new Point(width, height); Point oldSize = imageView.getSize(); if (!oldSize.equals(newSize)) { imageView.setSize(newSize); } } @Override public void setDocument(ImageDocument document) { super.setDocument(document); imageView.setImage(getDocument().getImage()); scrolledComposite.setMinSize(imageView.desiredSize()); updateImageViewSize(); imageView.setVisible(true); getShell().forceActive(); } @Override public boolean supportsFullscreen() { return true; } @Override public boolean supportsMaximizing() { return true; } }

सबसे पहले, आपको इस तथ्य पर ध्यान देना चाहिए कि वर्ग ViewWindowBase

टेम्पलेट से विरासत में मिला है, जिसके लिए हमारे दस्तावेज़ वर्ग को एक पैरामीटर के रूप में पारित किया गया है। यही है, खिड़की इस प्रकार के एक दस्तावेज के साथ जुड़ा हुआ है। वर्गों के बीच संबंध स्पष्ट रूप से दिखाया गया है।

विंडो के कार्य अत्यंत सरल हैं: लोड की गई छवि दिखाते हैं (यह अतिभारित setDocument

फ़ंक्शन में किया जाता है)। तब तक उपयोगकर्ता को उसकी उपस्थिति से प्रसन्न करें जब तक कि वह इसे बंद नहीं करता। इसके अलावा, जैसा कि DropTarget

ऑब्जेक्ट्स DropTarget

, विंडो एक निर्दिष्ट प्रकार की फ़ाइल "फेंकने" की घटना पर प्रतिक्रिया देती है। फ़ाइल एक ही विंडो में नहीं खुलेगी (यह केवल निर्बाध होगी), इसे एक नए दस्तावेज़ के रूप में डाउनलोड किया जाएगा और इसके लिए एक अलग विंडो बनाई जाएगी। ध्यान दें कि यह वर्ग नई विंडो खोलने के लिए ज़िम्मेदार नहीं है, इसलिए यह addDropTargetListener

और removeDropTargetListener

साथ एक श्रोता प्रदर्शित करता है। इन विधियों का उपयोग बाद में दिखाया जाएगा।

मैं आपका ध्यान एक विशिष्ट कार्यान्वयन पर केंद्रित नहीं करूंगा, खासकर जब से यह एकदम सही है। मैं केवल यह कह सकता हूं कि मूल ओवरराइड विधियां क्या हैं:

constructShell()

उस समय कहा जाता है जब SWT से Shell

ऑब्जेक्ट बनाने के लिए एक विंडो बनाई जाती है। यह वस्तु हमारी खिड़की है। एक विधि पर एनोटेशन @wbp.parser.entryPoint

- ग्रहण में SWF विंडो के दृश्य ड्राफ्ट्समैन के लिए एक निर्देश जब इस पद्धति को संपादित करने के लिए डिज़ाइन-समय में इसके चित्रमय प्रतिनिधित्व के माध्यम से संशोधित किया जाता है। तो, सैद्धांतिक रूप से, आप माउस के साथ एक विंडो और बटन खींच सकते हैं;) (हालांकि मैं खुद कोड लिखना पसंद करता हूं - यह बेहतर है)। यह यहां है कि आंतरिक घटनाओं को सौंपा गया है। setDocument()

बारे में मैंने पहले ही कहा था। और SupportFullscreen supportsFullscreen()

और SupportMaximizing supportsMaximizing()

विधियाँ Zetes में संबंधित सुविधाओं को नियंत्रित करती हैं। उदाहरण के लिए, false

supportsFullscreen()

पर false

लौटने वाली विंडो में ओएस एक्स पर तीर के साथ एक तैनाती बटन नहीं होगा, और किसी भी प्लेटफ़ॉर्म पर "फुलस्क्रीन" मेनू आइटम नहीं बनाएगा।

5.2.4। ImageViewWindowsManager

यह वर्ग विंडो प्रबंधन से संबंधित है। वह उन्हें बनाता और नष्ट करता है।

ImageViewWindowsManager.java

 package tinyviewer; import java.io.IOException; import org.eclipse.swt.dnd.DropTargetAdapter; import org.eclipse.swt.dnd.DropTargetEvent; import org.eclipse.swt.dnd.FileTransfer; import zetes.wings.base.ViewWindowsManagerBase; public class ImageViewWindowsManager extends ViewWindowsManagerBase<ImageDocument, ImageViewWindow> { private DropTargetAdapter viewWindowDropTargetAdapter = new DropTargetAdapter() { public void drop(DropTargetEvent event) { String fileList[] = null; FileTransfer ft = FileTransfer.getInstance(); if (ft.isSupportedType(event.currentDataType)) { fileList = (String[]) event.data; for (int i = 0; i < fileList.length; i++) { ImageDocument document; try { document = new ImageDocument(fileList[i]); openWindowForDocument(document); } catch (IOException e) { e.printStackTrace(); } } } } }; @Override protected ImageViewWindow createViewWindow() { ImageViewWindow vw = new ImageViewWindow(); vw.addDropTargetListener(viewWindowDropTargetAdapter); return vw; } public DropTargetAdapter getViewWindowDropTargetAdapter() { return viewWindowDropTargetAdapter; } }

यह ImageViewWindow

विंडो क्लास और ImageDocument

डॉक्यूमेंट ImageDocument

दोनों से जुड़े जेनरिक क्लास ViewWindowsManagerBase

से विरासत में मिला है।

हमारे मामले में, खिड़कियां पूरी तरह से मानक तरीके से प्रबंधित की जाती हैं। केवल एक चीज जो हमने जोड़ी थी वह पिक्चर विंडो में DropTarget

लिए एक श्रोता की नियुक्ति थी (याद रखें, हमने पिछले अनुभाग में इस पर DropTarget

थी?)। यहाँ, हमने createViewWindow()

फ़ैक्टरी createViewWindow()

परिभाषित किया ताकि नई विंडो बनाते समय ड्रैग-एन-ड्रॉप हैंडलर तुरंत इसमें शामिल हो जाए।

5.2.5। TinyViewerMenuConstructor

यह वर्ग एप्लिकेशन के मुख्य मेनू का प्रबंधन करता है। मेनू (ओएस एक्स में वैश्विक दोनों, और अन्य प्लेटफार्मों में विंडो) के लिए सभी जिम्मेदारी उस पर है। इसलिए, Zetes का उपयोग करते समय, SWT के माध्यम से सीधे मेनू कक्षाओं का प्रबंधन अत्यधिक अवांछनीय है । बेशक, यहाँ, अफसोस, एक छिद्रपूर्ण अमूर्तता है, लेकिन कई स्पष्ट कारणों के बाद से SWT को पूरी तरह से घेरना असंभव है, कम से कम इस स्तर पर हमारे पुस्तकालय के विकास में, हम इसके साथ मजबूर हैं।

TinyViewerMenuConstructor.java

 package tinyviewer; import zetes.wings.HotKey; import zetes.wings.base.MenuConstructorBase; import zetes.wings.actions.Action; import zetes.wings.actions.Handler; public class TinyViewerMenuConstructor extends MenuConstructorBase<ImageViewWindow> { private Handler<ImageViewWindow> fileOpenHandler; private Action<ImageViewWindow> openAction; public TinyViewerMenuConstructor(ImageViewWindowsManager viewWindowsManager) { super(viewWindowsManager); openAction = new Action<>("&Open"); openAction.setHotKey(new HotKey(HotKey.MOD1, 'O')); getFileActionCategory().addFirstItem(openAction); } public Handler<ImageViewWindow> getFileOpenHandler() { return fileOpenHandler; } public void setFileOpenHandler(Handler<ImageViewWindow> fileOpenHandler) { this.fileOpenHandler = fileOpenHandler; if (openAction.getHandlers().get(null) == null) { openAction.getHandlers().put(null, fileOpenHandler); } } }

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

फ़ंक्शन, जिसे मेनू हैंडलर को कॉल करना चाहिए। यही है, एक बार फिर: मेनू स्वयं कुछ नहीं करता है, यह हमेशा इसके लिए एक खिड़की या एक खिड़की प्रबंधक (हमारे मामले में, ImageViewWindowsManager

) के लिए पूछता है ।

ZetesWings में मेनू उपकरणों के बारे में अधिक जानें।

यहाँ कुछ शब्दों के बारे में कहना आवश्यक है कि मेनू को ZetesWings में कैसे व्यवस्थित किया जाता है। मुख्य स्तंभ Action

क्लास है। यह वर्ग एक मेनू आइटम लागू करता है। इसमें एक शीर्षक ("शीर्षक"), एक गर्म कुंजी संयोजन ("हॉटकेय") और हैंडलर ("हैंडलर") शामिल हैं, बाद वाले को एक Map

रूप में सौंपा जा रहा है, जहां कुंजियां ViewWindow

। बात सरल है। जब यह या उस विंडो को बनाया जाता है, तो यह अपने हैंडलर को उन कार्यों में जोड़ता है जो इसे रुचि रखते हैं। इसके अलावा, एक हैंडलर है जो किसी भी विंडोज़ ( null

कुंजी वाले) के साथ जुड़ा नहीं है। यह हैंडलर तब कहा जाता है जब कोई सक्रिय विंडो नहीं होती है (ओएस एक्स में यह संभव है कि एक मेनू है, लेकिन कोई विंडो नहीं है)।

प्राथमिकता यही है। जब उपयोगकर्ता एक मेनू आइटम का चयन करता है, तो दिए गए विंडो के हैंडलर को पहले खोजा जाता है। यदि नहीं, तो एक वैश्विक हैंडलर खोजा जाता है।

यदि दोनों हैंडलर अनुपस्थित हैं, तो मेनू आइटम बस छिपा हुआ है (उदाहरण के लिए, एक विंडो में जिसमें संपादन तत्व नहीं हैं, "कॉपी" कमांड अर्थहीन है, जैसे कि कोई विंडो न होने पर यह अर्थहीन है, इसके विपरीत, "ओपन")। उसी समय, एक "हैंडलर" (यानी Handler

क्लास का एक ऑब्जेक्ट) केवल एक श्रोता नहीं है। इसमें विकल्प जैसे कि isEnabled()

, isVisible()

, isChecked()

। इसके अलावा, यह अपने आप के साथ एक्शन हेडर को ओवरलैप करने में सक्षम है (एक संदर्भ-संवेदनशील हेडर के मामले के लिए)। इस मामले के लिए, इसका अपना getTitle()

।

TinyViewerMenuConstructor

बनाते समय मुख्य मेनू के लिए Action

ऑब्जेक्ट बनाता है। हमारे मामले में, केवल एक गैर-मानक तत्व है - "ओपन"। हम इसे बनाते हैं और इसे HotKey(HotKey.MOD1, 'O')

असाइन करते हैं। MOD1

एक संशोधक है जो OS X के तहत कमांड कुंजी से मेल खाता है, और अन्य प्लेटफार्मों के तहत नियंत्रण। दोनों परंपराओं के उपयोगकर्ता जानते हैं कि विंडोज में Ctrl के साथ अधिकांश कीबोर्ड शॉर्टकट, सीएमडी के साथ ओएस एक्स में दबाए जाते हैं।

5.2.6। TinyViewerApplication

हमारी पदानुक्रम में अंतिम (और मुख्य) TinyViewerApplication

अनुप्रयोग TinyViewerApplication

। यह उपरोक्त सभी वर्गों से जुड़ा हुआ है। साथ ही, यह AboutBox

उत्तराधिकारी (हमारे मामले में, DefaultAboutBox

) के साथ जुड़ा हुआ है, जो "एप्लिकेशन के बारे में" विंडो को लागू करता है।

TinyViewerApplication.java

 package tinyviewer; import java.io.IOException; import java.util.ArrayList; import org.eclipse.swt.SWT; import org.eclipse.swt.graphics.Point; import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.FileDialog; import org.eclipse.swt.widgets.Shell; import zetes.wings.base.ApplicationBase; import zetes.wings.DefaultAboutBox; import zetes.wings.actions.Handler; public class TinyViewerApplication extends ApplicationBase<DefaultAboutBox, ImageDocument, ImageViewWindow, TinyViewerMenuConstructor, ImageViewWindowsManager> { @Override public String getTitle() { return "Tiny Viewer"; } @Override public DefaultAboutBox createAboutBox(ImageViewWindow window) { DefaultAboutBox res = new DefaultAboutBox(window); res.setApplicationName(getTitle()); res.setIconResourceName("/tinyviewer/wingphotos64.png"); res.setDescriptionText("A simple image file viewer.\nThis application shows the power of Avian + SWT"); res.setCopyrightText("Copyright \u00a9 2013, Ilya Mizus"); res.setWindowSize(new Point(370, 180)); return res; } @Override public ImageDocument loadFromFile(String fileName) { try { return new ImageDocument(fileName); } catch (IOException e) { e.printStackTrace(); return null; } } private Handler<ImageViewWindow> fileOpenHandler = new Handler<ImageViewWindow>() { @Override public void execute(ImageViewWindow window) { Shell dummyShell = new Shell(Display.getDefault()); FileDialog fileDialog = new FileDialog(dummyShell, SWT.OPEN | SWT.MULTI); fileDialog.setText("Open image"); fileDialog.setFilterNames(new String[] { "Image (*.png; *.bmp; *.jpg; *.jpeg)", "All files" }); fileDialog.setFilterExtensions(new String[] { "*.png; *.bmp; *.jpg; *.jpeg", "*.*" }); String firstFile = fileDialog.open(); if (firstFile != null) { String[] names = fileDialog.getFileNames(); ArrayList<ImageDocument> documents = new ArrayList<ImageDocument>(); // Creating documents for files for (int i = 0; i < names.length; i++) { String fileName = fileDialog.getFilterPath() + "/" + names[i]; try { documents.add(new ImageDocument(fileName)); } catch (IOException e) { // TODO Show a message box here e.printStackTrace(); } } getViewWindowsManager().openWindowsForDocuments(documents.toArray(new ImageDocument[] {})); } dummyShell.dispose(); } }; public TinyViewerApplication() { } @Override public ImageViewWindowsManager createViewWindowsManager() { return new ImageViewWindowsManager(); } @Override public TinyViewerMenuConstructor createMenuConstructor(ImageViewWindowsManager viewWindowsManager) { TinyViewerMenuConstructor menuConstructor = new TinyViewerMenuConstructor(viewWindowsManager); menuConstructor.setFileOpenHandler(fileOpenHandler); return menuConstructor; } @Override public boolean needsAtLeastOneView() { return false; } public static void main(String... args) { new TinyViewerApplication().run(args); } }

यह वर्ग दस्तावेजों को लोड करने के लिए जिम्मेदार है। हमारे आवेदन में, वह वह है जिसमें वस्तु शामिल है fileOpenHandler

, जो "ओपन" मेनू आइटम का एक वैश्विक हैंडलर है। इसके अलावा, इसमें हमारे "वैश्विक" ऑब्जेक्ट्स (मेनू डिज़ाइनर, विंडो मैनेजर और "प्रोग्राम के बारे में" विंडो) के लिए कई फ़ैक्टरी विधियाँ हैं। इसने एक मनोरंजक तरीका भी घोषित किया needsAtLeastOneView()

, जिसे विशेष रूप से थोड़ा कहा जा सकता है।

आवश्यकताओं के बारे में अधिक जानें

, Windows Linux . — , , . OS X — , . — . , .

ZetesWings. needsAtLeastOneView()

false

, OS X .

OS X , / (, ). needsAtLeastOneView()

, true

. , . , OS X , .

इसके साथ, इस परियोजना के लिए स्रोत कोड की हमारी समीक्षा को पूर्ण माना जा सकता है।

5.3। सहायक फाइलें और संसाधन

हमें केवल कुछ अतिरिक्त फ़ाइलों के साथ छोड़ दिया गया था, जिसके बिना परियोजना नहीं कर सकती। ये फ़ाइलें - संसाधन फ़ाइलें - 4 फ़ोल्डरों में स्थित हैं:

src/res

— src/java

— Java Java-. 3 SWT :

 shell.setImages(new Image[] { SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos16.png"), SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos64.png"), SWTResourceManager.getImage(ImageViewWindow.class, "/tinyviewer/wingphotos512.png") });

win-res

— , Windows EXE. , , win.rc

win.rc

 MainIcon ICON "win-res/wingphotos.ico" 1 VERSIONINFO FILEVERSION 0,1,0,0 PRODUCTVERSION 0,1,0,0 BEGIN BLOCK "StringFileInfo" BEGIN BLOCK "040904E4" BEGIN VALUE "CompanyName", "bigfatbrowncat\0" VALUE "FileDescription", "A tiny multi document photo viewer app" VALUE "FileVersion", "0.1\0" VALUE "InternalName", "TinyViewer\0" VALUE "LegalCopyright", "Ilya Mizus\0" VALUE "OriginalFilename", "tinyviewer.exe\0" VALUE "ProductName", "TinyViewer\0" VALUE "ProductVersion", "0.1\0" END END BLOCK "VarFileInfo" BEGIN VALUE "Translation", 0x409, 1251 END END

osx-bundle

— .app, OS X «application bundle» . bundle
resources

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

। यह फ़ोल्डर इस परियोजना में अनुपस्थित है, लेकिन यह अन्य ज़ेटेस-उदाहरण परियोजनाओं में मौजूद है ।

5.4। असेंबली और लॉन्च

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

6. निष्कर्ष

सबसे पहले, मैं अपने हृदय के नीचे से उन सभी को धन्यवाद देना चाहता हूं जिनके पास धैर्य है (और जिनके पास पर्याप्त रुचि है) इस स्थान पर पढ़ने के लिए। मुझे बहुत खुशी है कि यह विषय न केवल मेरे लिए दिलचस्प है। जितना अधिक आपके पास है, उतना ही अधिक उत्साह है।

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

किसी भी सुझाव / सलाह / आलोचना को स्वीकार किया जाता है और निश्चित रूप से माना जाएगा।

7. सन्दर्भ

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

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

आपका ध्यान के लिए धन्यवाद!

Zetes: जावा बहु-मंच GUI के साथ लेकिन Oracle JVM के बिना