जावास्क्रिप्ट के लिए एक सी / सी ++ पुस्तकालय पोर्टिंग (xml.js)

यह लेख " HOWTO: पोर्ट ए C / C ++ लाइब्रेरी टू जावास्क्रिप्ट (xml.js) " (लेखक: azakai ) लेख का अद्यतन अनुवाद है। मूल लेख के लेखक के पास सी / सी ++ पुस्तकालयों को जावास्क्रिप्ट में पोर्ट करने का अच्छा अनुभव है। विशेष रूप से, उन्होंने सफलतापूर्वक lzma.js और sql.js. अपने लेख में, वह libxml के उदाहरण का उपयोग करके C / C ++ कोड पोर्ट करने के लिए एक सामान्य योजना का वर्णन करता है, जो XML सत्यापन के लिए एक खुली लाइब्रेरी है।

इसके अलावा, इस लेख में उन चरणों का पूरा क्रम है जो Ubuntu 12.04 वातावरण में libxml को पोर्ट करने के लिए आवश्यक थे। जिसमें आवश्यक पर्यावरण सेटिंग्स और ईम्स्क्रिप्ट शामिल हैं ।

स्थापित करें और Emscripten कॉन्फ़िगर करें

Emscripten जावास्क्रिप्ट में LLVM बाइटकोड से एक संकलक है। C / C ++ कोड को क्लेंग कंपाइलर का उपयोग करके LLVM बायटेकोड में संकलित किया जा सकता है। कुछ अन्य भाषाओं में एलएलवीएम बायटेकोड कंपाइलर भी हैं। बाइटकोड-आधारित ईस्मैप्टेन उपयुक्त जावास्क्रिप्ट कोड उत्पन्न करता है जिसे किसी भी जावास्क्रिप्ट दुभाषिया द्वारा निष्पादित किया जा सकता है, जैसे कि आधुनिक ब्राउज़र। एम्सस्क्रिप्टेन का उपयोग करते हुए, मोज़िला के लोगों ने हाल ही में सफलतापूर्वक डूम को चित्रित किया।

Emscripten प्रदान करता है: emconfigure - पर्यावरण की स्थापना और बाद में लॉन्च के लिए एक उपयोगिता ।/configure; emmake - पर्यावरण को कॉन्फ़िगर करने और फिर रन बनाने के लिए एक उपयोगिता; emcc - जावास्क्रिप्ट में LLVM संकलक;

तो, आइम्सस्क्रिप्ट ( मैनुअल देखें) के साथ काम करने के लिए वातावरण सेट करें।

Clang + llvm स्थापित करें (> = 3.0):

wget llvm.org/releases/3.0/clang+llvm-3.0-i386-linux-Ubuntu-11_10.tar.gz
टेर xfv क्लैंग + llvm-3.0-i386-linux-Ubuntu-11_10.tar.gz

नोड स्थापित करें। (> = 0.5.5):

sudo apt-get install नोडज

Emscripten के वर्तमान संस्करण को उतारें:

git क्लोन क्लोन git: //github.com/kripken/emscripten.git
सीडी emscripten

क्लैंग के स्वास्थ्य की जाँच:

../clang+llvm-3.0-i386-linux-Ubuntu-11_10/bin/clang परीक्षण / hello_world.cpp
./a.out
>> हैलो, दुनिया!

नोड.जेएस के स्वास्थ्य की जाँच:

नोड परीक्षण / hello_world.js
>> हैलो, दुनिया!

कॉन्फ़िगरेशन फ़ाइल ' ~ / .emscripten ' बनाने के लिए पहली बार emcc चलाएँ:

./emcc

कॉन्फ़िगरेशन फ़ाइल में, आपको क्लैंग + llvm निर्देशिका और साथ ही ईमस्क्रिप्टस्क्रिप्ट इंस्टॉलेशन निर्देशिका निर्दिष्ट करने की आवश्यकता है:

EMSCRIPTEN_ROOT = os.path.expanduser (' ~ / path / emscripten ') # यह emscripten का उपयोग करके परियोजनाओं को खोजने में मदद करता है
LLVM_ROOT = os.path.expanduser (' ~ / path / clang + llvm-3.0-i386-linux-Ubuntu-11_10 / bin ')

यह सही ढंग से कॉन्फ़िगर किया गया है यह सुनिश्चित करने के लिए आपको फिर से emcc चलाने की आवश्यकता है। इस स्थिति में, यह ' emcc: no input files ' संदेश प्रदर्शित करेगा:

./emcc
>> emcc: कोई इनपुट फ़ाइलें नहीं

अब आप सत्यापित कर सकते हैं कि emcc का उपयोग करके hello_wolrd.cpp को संकलित करके सब कुछ सही ढंग से काम करता है:

./emcc परीक्षण / hello_world.cpp
नोड a.out.js
>> हैलो, दुनिया

भाग 1: संकलन सी / सी ++ स्रोत

पोर्टिंग प्रारंभ करने से पहले, आपको यह सुनिश्चित करना चाहिए कि प्रोजेक्ट स्रोत कोड C / C ++ कंपाइलर द्वारा त्रुटियों के बिना संकलित है।

हम भंडार और संकलन से libxml उतार देते हैं:

git क्लोन क्लोन git: //git.gnome.org/libxml2
सीडी libxml2
git चेकआउट v2.7.8
CC = ~ / path / clang + llvm-3.0-i386-linux-Ubuntu-11_10 / / clang ./autogen.sh --without-debug --without-ftp --without-http --without-python - बिना-रेगेक्सप्स - विथआउट-थ्रेड्स - विथआउट-मॉड्यूल
मेकअप

Libxml में xml स्कीमा को मान्य करने के लिए xmllint कंसोल उपयोगिता शामिल है। इसका उपयोग संकलित कोड के सही संचालन को सत्यापित करने के लिए किया जा सकता है। इस तरह के चेक करना आवश्यक है, जिसमें यह सुनिश्चित करना भी शामिल है कि मूल और पोर्ट किए गए संस्करण समान रूप से सही ढंग से काम करते हैं। Xmllint के साथ परीक्षण कुछ इस तरह दिखता है:

$। / xmllint --noout --schema test.xsd test.xml
>> test.xml मान्य करता है

यदि सब कुछ सही ढंग से काम करता है, तो test.xml फ़ाइल में कुछ बदलाव करें और फिर xmllint एक त्रुटि संदेश प्रदर्शित करेगा।

भाग 2: विन्यास

आप कमांड के साथ emscripten का उपयोग करके संकलन के लिए प्रोजेक्ट को कॉन्फ़िगर कर सकते हैं:

~ / पाथ / एम्सस्क्रिप्टेन / इमकॉन्फ़िगर ./autogen.sh --without-debug --without-ftp --without-http --without-python --without-regexps -without-threads --without-मॉड्यूल

emconfigure वातावरण चर को सेट करता है ताकि ./configure gcc या क्लैंग के बजाय emcc कंपाइलर का उपयोग करता है। यह वातावरण सेट करता है ताकि। कॉन्फ़िगरेशन कॉन्फ़िगर किए गए परीक्षणों (जो मूल कोड संकलित करें) सहित सही ढंग से काम करता है।

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

भाग 3: प्रोजेक्ट बनाएँ

विधानसभा कमांड द्वारा किया जाता है:

~ / पथ / एम्सस्क्रिप्टेन / एम्मेक मेक

Emmake emconfigure के समान है: यह पर्यावरण चर भी सेट करता है। ईमेक के लिए धन्यवाद, एलएलवीएम बायटेकोड देशी कोड के बजाय बिल्ड के दौरान उत्पन्न होता है। प्रत्येक ऑब्जेक्ट फ़ाइल और उसके बाद के लेआउट के लिए जावास्क्रिप्ट कोड उत्पन्न करने से बचने के लिए ऐसा किया जाता है। इसके बजाय, एलएलवीएम बायटेकोड बिल्डर का उपयोग किया जाता है।

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

भाग 4: जावास्क्रिप्ट में बदलना

xmllint xmllint.o और libxml2.a पर निर्भर है। एलएलवीएम लिंकर डायनेमिक लिंकिंग (लेट बाइंडिंग) का समर्थन नहीं करता है और एमसीसी इसे अनदेखा करता है। इसलिए, आपको लिंक करने के लिए libxml2.a स्थिर लाइब्रेरी को मैन्युअल रूप से निर्दिष्ट करना होगा।

लिबास पर निर्भरता (संपीड़न के लिए खुला पुस्तकालय) थोड़ा कम स्पष्ट है। यदि आप libz.a के बिना निर्माण करते हैं, तो निष्पादन के दौरान एक त्रुटि तब होगी जब आप gzopen फ़ंक्शन को कॉल करने का प्रयास करेंगे। तदनुसार, आपको libz.a बनाने की आवश्यकता है:

सीडी ~ / पथ
wget zlib.net/zlib-1.2.7.tar.gz
tar xfv zlib-1.2.7.tar.gz
सीडी ज़्लिब-1.2.7
~ / पथ / emscripten / emconfigure ./configure --static
~ / पथ / एम्सस्क्रिप्टेन / एम्मेक मेक

अब आप जावास्क्रिप्ट कोड संकलित कर सकते हैं:

सीडी ~ / पथ / libxml2
~ / path / emscripten / emcc -O2 xmllint.o .libs / libxml2.a ../zlib-1.2.7/libz.a -o xmllint.test.js-embed-file test.xml --embed-file test.xsd

जहां:

• emcc - gcc या clang के लिए प्रतिस्थापन (ऊपर देखें);
• -O2 अनुकूलन ध्वज है। LLVM और अतिरिक्त अनुकूलन जावास्क्रिप्ट स्तर पर किए जाते हैं, जिसमें क्लोजर कंपाइलर (उन्नत मोड में) शामिल हैं;
• संकलित की जाने वाली फाइलें
• -o परिणामस्वरूप xmllint.test.js फ़ाइल है। प्रत्यय "जेएस" उत्पन्न कोड के प्रारूप को इंगित करता है, इस मामले में जावास्क्रिप्ट;
• --embed-file - emcc को निर्दिष्ट कोड में निर्दिष्ट फ़ाइल की सामग्री को शामिल करने और वर्चुअल फ़ाइल सिस्टम को कॉन्फ़िगर करने के लिए कहता है ताकि ये फाइलें मानक stdio कॉल (fopen, fread, आदि) के माध्यम से सुलभ हों। संकलित कोड से फ़ाइलों तक पहुंचने का यह सबसे आसान तरीका है।

भाग 5: परीक्षण जावास्क्रिप्ट

इस कोड को चलाने के लिए Node.js, SpiderMonkey या V8 द्वारा दिए गए जावास्क्रिप्ट कंसोल का उपयोग किया जा सकता है:

नोड xmllint.test.js --noout --schema test.xsd test.xml
>> test.xml मान्य करता है

परिणाम मूल कोड के समान होना चाहिए। इसी तरह, यदि आप xml स्कीमा में त्रुटियों का परिचय देते हैं, तो xmllint को उनका पता लगाना चाहिए।

महत्वपूर्ण : देशी और जावास्क्रिप्ट बिल्ड के लिए उपयोग किए जाने वाले सभी तर्क बिल्कुल समान होने चाहिए।

भाग 6: रिफैक्टिंग और पुन: उपयोग

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

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

यहाँ --pre-js विकल्प का उपयोग करने के लिए स्क्रिप्ट है:

  मॉड्यूल ['पूर्व'] = फ़ंक्शन () {
     FS.createDataFile (
       '/'
       'Test.xml',
       मॉड्यूल ['intArrayFromString'] (मॉड्यूल ['xml'])
       सच है,
       true);
     FS.createDataFile (
       '/'
       'Test.xsd',
       मॉड्यूल ['intArrayFromString'] (मॉड्यूल ['स्कीमा'])
       सच है,
       true);
   };
   मॉड्यूल ['तर्क'] = ['- noout', '--schema', 'test.xsd', 'test.xml'];
   मॉड्यूल ['वापसी'] = '';
   मॉड्यूल ['प्रिंट'] = फ़ंक्शन (पाठ) {
     मॉड्यूल ['वापसी'] + = पाठ + '\ n';
   }; 

इस लिपि पर विचार करें:

• मॉड्यूल - एक वस्तु जिसके माध्यम से emscripten का उपयोग करके उत्पन्न कोड अन्य जावास्क्रिप्ट कोड के साथ इंटरैक्ट करता है।
• मॉड्यूल तक पहुंचने के लिए स्ट्रिंग नामों का उपयोग करना महत्वपूर्ण है, उदाहरण के लिए मॉड्यूल.नाम के बजाय मॉड्यूल ['नाम']। इस स्थिति में, क्लोजर नाम अपरिवर्तित छोड़ देगा।
• पहली बात यह है कि Module.preRun को बदलना है, जो उत्पन्न कोड से ठीक पहले चलता है (लेकिन पर्यावरण को स्थापित करने के बाद)। PreRun फ़ंक्शन में, फ़ाइल सिस्टम API ( Emscripten FileSystem API ) का उपयोग करके दो फाइलें बनाई जाती हैं। सादगी के लिए, पिछले परीक्षणों (test.xml और test.xsd) के समान फ़ाइल नामों का उपयोग किया जाता है। इन फ़ाइलों की सामग्री मॉड्यूल ['xml'] और मॉड्यूल [these xsd]] पर सेट है। इन चरों में XML और XML स्कीमा होना चाहिए। स्ट्रिंग्स को intArrayFromString का उपयोग करके एक सरणी में परिवर्तित किया जाता है।
• मॉड्यूल स्थापित करें। तर्क - कंसोल कमांड के लिए तर्क सूची के बराबर। तर्क बिल्कुल वही होने चाहिए जो हमने पहले परीक्षण में इस्तेमाल किए थे। अंतर केवल इतना है कि test.xml और test.xsd फ़ाइलों में उपयोगकर्ता डेटा होगा।
• जब कोड stdio से किसी ऑपरेशन को लागू करने का प्रयास करता है, तो Module.print को कहा जाता है। हम सभी आउटपुट को बफर में सहेजते हैं ताकि इसे बाद में पढ़ा जा सके।

इस प्रकार, हमने यह हासिल किया है कि इनपुट फाइलें test.xml और test.xsd में उपयोगकर्ता द्वारा दर्ज की गई जानकारी होगी, और सत्यापन परिणाम बफर में सहेजे जाएंगे।

हालाँकि, यह सब नहीं है। कोड संकलित करें:

~ / पाथ / ईमस्क्रिप्टीन / ईमेक -O2 xmllint.o .libs / libxml2.a ../zlib-1.2.7/libz.a -o xmllint.raw.js-pre-js pre.js

संकलन कमांड पहले की तरह दिखता है, सिवाय इसके कि हमें फ़ाइलों को शामिल करने की आवश्यकता नहीं है। इसके बजाय, pre.js. को शामिल करने के लिए --pre-js ध्वज का उपयोग करें

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

  फ़ंक्शन वैलिडेटएक्सएमएल (xml, स्कीमा) {
     var मॉड्यूल = {
       xml: xml,
       स्कीमा: स्कीमा
     };
     {{{GENERATED_CODE}}}
     वापसी मॉड्यूल।
   } 

GENERATED_CODE को संकलन परिणाम (xmllint.raw.js) से बदला जाना चाहिए। वैलिडेटएक्सएमएल फ़ंक्शन xml और स्कीमा फ़ील्ड के लिए उपयुक्त तर्क प्रदान करता है। इस प्रकार, हम यह सुनिश्चित करते हैं कि test.xml और test.xsd फ़ाइलों में उपयोगकर्ता डेटा हो। उत्पन्न कोड निष्पादित होने के बाद, फ़ंक्शन सत्यापन परिणाम लौटाएगा।

वह सब है! xml.js का नियमित जावास्क्रिप्ट कोड से उपयोग किया जा सकता है। जरूरत है कि बस js फ़ाइल को शामिल करने और xml और स्कीमा के साथ validateXML फ़ंक्शन को कॉल करने के लिए।