MXML फ्लेक्स कंपाइलर में कंस्ट्रक्टर पैरामीटर जोड़ें

26 अप्रैल, 2007। एडोब एक बयान देता है कि फ्लेक्स फ्रेमवर्क का ओपन सोर्स में अनुवाद किया जा रहा है। इस खबर से पूरी दुनिया में फ्लैशर्स के बीच तालियों की गड़गड़ाहट हुई, कि इसके आधार पर मौलिक रूप से नए ढांचे दिखाई देंगे, लेकिन यह एक-दो परियोजनाओं से आगे नहीं बढ़ पाया।

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

प्रस्तावना

मैं SVN रिपॉजिटरी से FlexSDK प्रोजेक्ट की जाँच की प्रक्रिया का विवरण नहीं दूंगा, मैं इस प्रक्रिया के विवरण के लिए एक लिंक छोड़ता हूँ

लेखन के समय, नवीनतम संस्करण फ्लेक्स 4.5.1 (4.5.1.21328) था, इसलिए आपको इस पर निर्माण करना चाहिए।

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

अंदर क्या है

दुर्भाग्य से, एक लेख पूरे संकलक के उपकरण को कवर करने के लिए पर्याप्त नहीं है, इसलिए इसमें मैं केवल इसके एक छोटे हिस्से के बारे में बात करूंगा - एमएक्सएमएल अनुवादक।
इससे संबंधित सभी स्रोत मॉड्यूल / कंपाइलर / src / java / flex2 / compiler / mxml फ़ोल्डर में स्थित हैं:

• विश्लेषक पैकेज, विचित्र रूप से पर्याप्त है, टोकन के रूप में पार्स एक्सएमएल के विश्लेषण के लिए जिम्मेदार है, सिंटैक्सअनालियर सबसे अधिक ध्यान आकर्षित करता है। इस स्तर पर, कोई कोड पीढ़ी नहीं होती है, केवल एमएमएमएल से परिणामी मॉडल का विश्लेषण;
• बिल्डर पैकेज - हमारे लिए सबसे दिलचस्प (इस लेख के ढांचे के भीतर), बिल्डरों का एक सेट है जिसमें प्राप्त टोकन को एएस 3 ऑब्जेक्ट मॉडल में परिवर्तित किया जाता है। आरेख पैकेज घटकों को दिखाता है:
  
  संक्षेप में:
  
  1. AbstractBuilder - बाकी सभी के लिए आधार वर्ग, प्राप्त टोकन से एक वस्तु उत्पन्न करने के लिए तर्क शामिल है;
  2. XMLListBuilder , XMLBuilder , ArrayBuilder , VectorBuilder - एक ही वर्ग AS3 के लिए बिल्डरों;
  3. InlineComponentBuilder प्रक्रियाओं "घटकों के अंदर घटक", अर्थात जो लिखते समय बनता है <fx: घटक> </ fx: घटक>;
  4. PrimitiveBuilder भाषा की प्राथमिकताओं के लिए ज़िम्मेदार है, जैसे स्ट्रिंग, संख्या, int, uint, बूलियन;
  5. ModelBuilder , AnonymousObjectGraphBuilder और ServiceRequestBuilder आपको <fx: मॉडल /> और इस तरह से एक ऑब्जेक्ट बनाने की अनुमति देता है;
  6. ComponentBuilder एक अत्यंत महत्वपूर्ण वर्ग है, क्योंकि इसमें किसी भी MXML टैग से एक ऑब्जेक्ट बनाने का तर्क है जो उपरोक्त श्रेणियों में फिट नहीं होता है। यह हमारे द्वारा सबसे अधिक बार उपयोग किया जाता है, क्योंकि यह वह है जो फॉर्म के निर्माणों से वस्तु बनाता है <s: बटन />, <s: सूची />, <someNamespace: SomeObject />;
  7. DocumentBuilder एक रूट टैग है, जैसे, उदाहरण के लिए, <s: एप्लिकेशन />, या कोई अन्य;
  8. HTTPServiceBuilder , RemoteObjectBuilder और WebServiceBuilder - संबंधित टैग के निर्माता;
• डोम पैकेज में एमएमएमएल टैग प्रकारों में से प्रत्येक के लिए नोड घोषणाएं शामिल हैं। कौन परवाह करता है, मैं पैकेज संरचना के दृश्य प्रतिनिधित्व के साथ एक तस्वीर पोस्ट करता हूं;
• जीन पैकेज में इसके लिए AS3 कोड जनरेशन + हेल्पर क्लास के लिए वेलोसिटी टेम्प्लेट हैं। केवल तभी उपयोग किया जाता है, यदि प्रशासन-जनरेट-एक्शनस्क्रिप्ट निर्दिष्ट किया जाता है, अन्यथा, Abstract AbstractSyntaxTree में तुरंत होता है;
• लैंग पैकेज में निरंतरता होती है जो भाषा के लिए विशिष्ट होती है, साथ ही विशेषताओं, बाइंडरों और अधिक के लिए हैंडलर भी। मैं आपको StandardDefs पर ध्यान देने की सलाह देता हूं;
• प्रतिबिंबित पैकेज में प्रतिबिंब एपीआई और टाइपटेबल वर्ग शामिल हैं, जिनमें से प्रत्येक के निजी कार्यान्वयन के साथ;
• प्रतिनिधि पैकेज MXML दस्तावेज़ के प्रत्येक नोड के लिए इनिशियलाइज़र है। संरचना:
  

सिद्धांत से अभ्यास करने के लिए!

अपने आप को उम्मीद नहीं थी कि इतना "सिद्धांत" निकल जाएगा, लेकिन यह आपको यह समझने में बहुत मदद करेगा कि कहां, क्या और क्यों। और अब हम सीधे उस पर जाएँगे जो यह सब था - एमएक्सएमएल ऑब्जेक्ट्स के लिए कंस्ट्रक्टर पैरामीटर निर्दिष्ट करने की क्षमता।

AS3 में कई वर्गों के पास अनिवार्य निर्माता पैरामीटर हैं, जिसके कारण इन वर्गों को बिना पैरामीटर वाली वस्तुओं में लपेटना पड़ता है, या <fx: Script /> टैग से बनाया जाता है, जो MXML पर हमारे सामान्य रूप का भी उल्लंघन करता है, इसलिए मैं ऐसा कार्यान्वयन करने का सुझाव देता हूं :

<?xml version="1.0"?> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Declarations> <Timer xmlns="flash.utils.*" new="1000, 1" /> </fx:Declarations> </s:Application> 

नए कीवर्ड की पसंद इस तथ्य के कारण है कि एएस 3 में हम कभी भी नए नाम के साथ एक संपत्ति नहीं बना सकते, क्योंकि यह आरक्षित है। हमारी वस्तु को आरम्भ करने पर, इस मामले में, नए में पारित किए गए कोष्ठक में डाल दिया जाएगा,

 new Timer(1000, 1); 

हम सत्यापन पास करते हैं

सत्यापनकर्ता के लिए हमारी नई विशेषता को छोड़ने के लिए, हमें उसे उसी में जोड़ना होगा (उदाहरण के लिए, शामिल, बहिष्कृत, और इसी तरह)। एक पाठ खोज से पता चला है कि इस विशेषता को पहले lang / StandardDefs.java में घोषित किया गया है, और फिर बिल्डर / ComponentBuilder.java (isSpecialAttribute विधि) में सत्यापित किया गया है

StandardDefs में जोड़ें

 public static final String PROP_NEW = "new"; 

310 लाइनों के बाद:

 public static final String PROP_ID = "id"; 

कम्पोनेंटबुर्टल में भी (isSpecialAttribute विधि)

 if (namespace.length() == 0 || namespace.equals(document.getLanguageNamespace())) { if (StandardDefs.PROP_ID.equals(localPart) || StandardDefs.PROP_NEW.equals(localPart) || StandardDefs.PROP_INCLUDE_STATES.equals(localPart) || StandardDefs.PROP_EXCLUDE_STATES.equals(localPart) || StandardDefs.PROP_ITEM_CREATION_POLICY.equals(localPart) || StandardDefs.PROP_ITEM_DESTRUCTION_POLICY.equals(localPart)) { isSpecial = true; } } 

अब सत्यापनकर्ता MXML टैग की नई विशेषता की कसम नहीं खाता है।

ऑब्जेक्ट मॉडल के लिए एक नई संपत्ति रजिस्टर करें

तो, हमारी विशेषता होती है, लेकिन इसके मूल्य को कहीं बचाना आवश्यक है? इसके लिए हमारे पास Model.java है।
हम रेपो / Model.java में निर्माता मापदंडों के लिए गेटटर / सेटर बनाते हैं और एक संपत्ति और दो तरीकों को वर्ग में जोड़ते हैं:

 protected String constructorParams; public void setConstructorParams(String value) { constructorParams = value; } public String getConstructorParams() { return constructorParams; } 

हम इस संपत्ति का उपयोग AbstractBuilder.java वर्ग (लाइन 1617) के रजिस्टरमॉडल (नोड नोड, मॉडल, बूलियन टॉपलेवल) विधि में करेंगे:

 protected void registerModel(Node node, Model model, boolean topLevel) { String id = (String)getLanguageAttributeValue(node, StandardDefs.PROP_ID); String newValue = (String)getLanguageAttributeValue(node, StandardDefs.PROP_NEW); // get the comment from the node and store in the model if(node.comment != null) { // if generate ast if false, lets not scan the tokens here because they will be scanned later in asc scanner. // we will go the velocity template route if(!mxmlConfiguration.getGenerateAbstractSyntaxTree()) { model.comment = node.comment; } else { model.comment = MxmlCommentUtil.commentToXmlComment(node.comment); } } if(newValue != null) { model.setConstructorParams(newValue); } registerModel(id, model, topLevel); } 

हम कोड पीढ़ी में विशेषता का उपयोग करते हैं

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

प्रतिनिधि / init / ValueInitializer.java वर्ग, getDefinitionBody () विधि, लाइन 467 पर Adobe TODO के तुरंत बाद:

 else { // TODO confirm the availability of a 0-arg ctor!! but do it upstream from here, like when Model is built stringBuilder.append("new " + selfTypeName + "("); if(self.getConstructorParams() != null) { stringBuilder.append(self.getConstructorParams()); } stringBuilder.append(")"); } 

संकलन

अब, ढांचे के मूल फ़ोल्डर में कंसोल पर जा रहा है (ट्रंक, यदि आपने संपूर्ण रिपॉजिटरी डाउनलोड की है), तो यह बिल्ड प्रोजेक्ट को चलाने के लिए रहता है, जिसके लिए हम दर्ज करते हैं (आपके पास चींटी होनी चाहिए):

 BSiDeUp-Mac-mini:trunk bsideup$ ant build 

आप जा सकते हैं और अपने आप को कॉफी बना सकते हैं / एक कुर्सी पर वापस सूखा / दुबला करने के लिए पटाखे रख सकते हैं (आवश्यक के रूप में रेखांकित करें), जैसा कि प्रक्रिया में लगभग 5 मिनट लगेंगे।
(संकेत: 1 निर्माण के बाद, केवल चींटी संकलक लॉन्च किया जा सकता है, तब केवल संकलक मॉड्यूल बनाया जाएगा)

इस शिलालेख की तरह कुछ इंतजार करने के बाद:

  main: [echo] ant main target completed on 09/16/2011 11:54:25 AM BUILD SUCCESSFUL Total time: 5 minutes 33 seconds 

हम आनन्दित होते हैं और आनन्दित होते हैं, अन्यथा - हम ज़ैन के मैनुअल को फिर से पढ़ते हैं और जो हमने याद किया है उसे देखें।

निष्कर्ष

अब आप अपने पसंदीदा आईडीई में हमारे ढांचे को फ्लेक्स फ्रेमवर्क लोकेशन के रूप में निर्दिष्ट कर सकते हैं, जिससे एक संशोधित संकलक का उपयोग करना शुरू हो जाता है जो नए का समर्थन करता है!

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

जो लोग परिणाम में रुचि रखते हैं, इस प्रक्रिया के लिए नहीं, मैं तैयार mxmlc.jar फ़ाइल के लिए एक लिंक प्रदान करूंगा , बस फ्लेक्स एसडीके 4.5 डाउनलोड करें और इसके साथ $ {FLEX_SDK_DIR} /lib.mxmlc.jar फ़ाइल बदलें।

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