make_methodp - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

make_method - RPC::XML::Server के लिए पर्ल कोड को XML विवरण में बदलें

SYNOPSIS

make_method --name=system.identification --helptext='सिस्टम आईडी स्ट्रिंग'
--हस्ताक्षर=स्ट्रिंग --कोड=ident.pl --आउटपुट=ident.xpl

make_method --आधार=तरीके/पहचान

वर्णन

तरीकों को निर्दिष्ट करने के लिए XML वर्णनात्मक फ़ाइलें बनाने के लिए यह एक सरल उपकरण है
एक द्वारा प्रकाशित आरपीसी::एक्सएमएल::सर्वर-आधारित सर्वर.

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

एक समाधान यह है कि आरपीसी::एक्सएमएल::सर्वर पैकेज ऑफ़र प्रकाशन योग्य लोड करने का साधन है
किसी बाहरी फ़ाइल से कोड. फ़ाइल एक सरल XML बोली में है जो स्पष्ट रूप से चित्रित करती है
बाहरी रूप से दिखाई देने वाला नाम, विधि हस्ताक्षर, सहायता पाठ और स्वयं कोड। इन
फ़ाइलें मैन्युअल रूप से बनाई जा सकती हैं, या इस टूल का उपयोग सहायक के रूप में किया जा सकता है।

आवश्यक बहस

कोई आवश्यक तर्क नहीं हैं, लेकिन यदि पर्याप्त विकल्प नहीं हैं तो आप पारित कर देंगे
एक त्रुटि संदेश द्वारा बताया जाएगा.

विकल्प

उपकरण निम्नलिखित विकल्पों को पहचानता है:

--मदद
विकल्पों का संक्षिप्त सारांश प्रिंट करता है।

--नाम=स्ट्रिंग
एन्कोड की जा रही विधि का प्रकाशित नाम निर्दिष्ट करता है। यह वह नाम है जिससे यह
सर्वर के ग्राहकों को दिखाई देगा.

--नामस्थान=स्ट्रिंग
एक नामस्थान निर्दिष्ट करता है जिसमें विधि के कोड का मूल्यांकन किया जाएगा, जब XPL
फ़ाइल को सर्वर इंस्टेंस द्वारा लोड किया गया है।

--प्रकार=स्ट्रिंग
परिणामी फ़ाइल के लिए प्रकार निर्दिष्ट करें. यहां "टाइप" का तात्पर्य कंटेनर से है
परिणामी XML में प्रयुक्त टैग निर्दिष्ट करेगा प्रक्रिया या एक तरीका। डिफ़ॉल्ट है
तरीका. स्ट्रिंग को केस-स्वतंत्र माना जाता है, और केवल पहला अक्षर ("एम" या
"पी") वास्तव में माना जाता है।

--संस्करण=स्ट्रिंग
कोड रूटीन के लिए एक संस्करण स्टांप निर्दिष्ट करें।

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

--हस्ताक्षर=स्ट्रिंग [ --हस्ताक्षर=स्ट्रिंग ... ]
विधि के लिए एक या अधिक हस्ताक्षर निर्दिष्ट करें. हस्ताक्षर नाम के प्रकार के होने चाहिए
RPC::XML में दस्तावेज़ में, तत्वों को एक कोलन द्वारा अलग किया गया है। आप
यदि आप तर्क उद्धृत करते हैं, तो उन्हें रिक्त स्थान से भी अलग किया जा सकता है। यह विकल्प हो सकता है
एक से अधिक बार निर्दिष्ट किया गया है, क्योंकि कुछ विधियों में कई हस्ताक्षर हो सकते हैं।

--helptext=STRING
कमांड लाइन पर एक साधारण स्ट्रिंग के रूप में विधि के लिए सहायता टेक्स्ट निर्दिष्ट करें। नहीं
अत्यधिक लंबी सहायता स्ट्रिंग के लिए उपयुक्त।

--helpfile=फ़ाइल
निर्दिष्ट फ़ाइल से विधि के लिए सहायता पाठ पढ़ें।

--कोड=फ़ाइल
निर्दिष्ट फ़ाइल से रूटीन के लिए वास्तविक कोड पढ़ें। यदि यह विकल्प नहीं है
दिया गया है, कोड मानक इनपुट फ़ाइल डिस्क्रिप्टर से पढ़ा जाता है।

--आउटपुट=फ़ाइल
परिणामी XML प्रस्तुतिकरण को निर्दिष्ट फ़ाइल में लिखें। यदि यह विकल्प नहीं है
दिया गया है, तो आउटपुट मानक आउटपुट फ़ाइल डिस्क्रिप्टर में चला जाता है।

--आधार=नाम
यह एक विशेष, "ऑल-इन-वन" विकल्प है। यदि पारित हो जाता है, तो अन्य सभी विकल्पों को नजरअंदाज कर दिया जाता है।

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

नाम STRING है
प्रकाशित होने वाली दिनचर्या का नाम निर्दिष्ट करें. यदि यह पंक्ति प्रकट नहीं होती है,
फिर का मान --आधार हटाए गए सभी निर्देशिका तत्वों के साथ तर्क होगा
उपयोग किया गया।

संस्करण: STRING है
फ़ंक्शन के लिए एक संस्करण स्टाम्प प्रदान करें. यदि इस पैटर्न से कोई रेखा मेल नहीं खाती है
वर्तमान, कोई संस्करण टैग नहीं लिखा जाएगा.

छिपा हुआ: STRING है
अगर मौजूद है, STRING है या तो "हाँ" या "नहीं" होना चाहिए (मामला महत्वपूर्ण नहीं है)। अगर यह है
"हाँ", तो विधि को किसी भी आत्मनिरीक्षण एपीआई से छिपाए जाने के रूप में चिह्नित किया जाता है।

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

हेल्पफ़ाइल: STRING है
उस फ़ाइल को निर्दिष्ट करता है जिससे सहायता पाठ पढ़ा जाना है। यदि कोई सहायता नहीं तो यह कोई त्रुटि नहीं है
पाठ निर्दिष्ट है.

कोडफ़ाइल: STRING है
उस फ़ाइल को निर्दिष्ट करता है जिससे कोड पढ़ना है। कोड को पर्ल माना जाता है, और
परिणामी फ़ाइल में इस प्रकार टैग किया जाएगा।

कोडफ़ाइल[लैंग]: स्ट्रिंग
उस फ़ाइल को निर्दिष्ट करता है जिससे कोड पढ़ना है, साथ ही भाषा की पहचान भी करता है
वह कोड अंदर है। यह एक के निर्माण की अनुमति देता है एक्सपीएल फ़ाइल जिसमें शामिल है
दी गई विधि या प्रक्रिया का एकाधिक भाषा कार्यान्वयन।

उपरोक्त पैटर्न के अलावा किसी भी अन्य पंक्ति को नजरअंदाज कर दिया जाता है।

यदि कोई कोड नहीं पढ़ा गया है, तो टूल एक त्रुटि संदेश के साथ बाहर निकल जाएगा।

आउटपुट को लिखा गया है आधार.xpl, पथ जानकारी को संरक्षित करता है ताकि
परिणामी फ़ाइल स्रोत फ़ाइलों के ठीक बगल में है। यह ऐसे निर्माणों की अनुमति देता है:

make_method --आधार=विधियाँ/आत्मनिरीक्षण

फ़ाइल FORMAT और DTD

इन प्रकाशित रूटीनों के लिए फ़ाइल स्वरूप एक बहुत ही सरल XML बोली है। ये कम है
XML एक आदर्श प्रारूप होने के कारण पार्सर की उपलब्धता है, यह देखते हुए
आरपीसी::एक्सएमएल::सर्वर क्लास के कोर में पहले से ही पार्सर कोड होगा। बिल्कुल नया लिख ​​रहा हूँ
प्रारूप से कुछ हासिल नहीं होगा।

प्रारूप के लिए दस्तावेज़ प्रकार घोषणा को संक्षेप में प्रस्तुत किया जा सकता है:

<!तत्व प्रक्रियाडीफ़ (नाम, नामस्थान?, संस्करण?, छिपा हुआ?,
हस्ताक्षर+, सहायता?, कोड)>
<!एलिमेंट मेथडडेफ़ (नाम, नेमस्पेस?, संस्करण?, छिपा हुआ?,
हस्ताक्षर+, सहायता?, कोड)>
<!एलिमेंट फ़ंक्शनडिफ़ (नाम, नेमस्पेस?, संस्करण?, छिपा हुआ?,
हस्ताक्षर+, सहायता?, कोड)>









वितरण के साथ आने वाली फ़ाइल "rpc-method.dtd" में इसके अलावा कुछ टिप्पणी भी है
वास्तविक विशिष्टता के लिए.

एक फ़ाइल (अभी के लिए) एक परिभाषा तक सीमित है। इसकी शुरुआत एक उद्घाटन से हुई है
टैग " ", " " या " "। इसके बाद ठीक एक आता है
" "कंटेनर विधि का नाम निर्दिष्ट करता है, एक वैकल्पिक संस्करण स्टाम्प, एक वैकल्पिक
आत्मनिरीक्षण से छिपाएँ ध्वज, एक या अधिक " "हस्ताक्षर निर्दिष्ट करने वाले कंटेनर,
एक वैकल्पिक " सहायता पाठ के साथ " कंटेनर, फिर " " container with the
वास्तविक प्रोग्राम कोड. सभी पाठ को प्रतीकों के लिए इकाई एन्कोडिंग का उपयोग करना चाहिए:

और सी<&> (एम्परसेंड)
इ सी<<> (इससे कम)
इ सी<>> (इससे अधिक)

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

RSI विशिष्टता of कोड
यह नहीं है "प्रोग्रामिंग 101 ", न ही यह है "पर्ल एसटी la कुछ हद तक मंद". जो कोड है
"*.xpl" फ़ाइलों में से एक के माध्यम से पारित होने पर यह बिना किसी संशोधन के "eval" में चला जाता है
(नीचे देखें)। इस प्रकार, बुरी तरह से लिखा गया या दुर्भावनापूर्ण कोड आपके लिए बहुत विनाशकारी हो सकता है
सर्वर. यह सर्वर कोड की गलती नहीं है. इस प्रणाली के लचीलेपन की कीमत
ऑफ़र डेवलपर की ज़िम्मेदारी है कि वह कोड सुनिश्चित करे
परीक्षण किया गया और सुरक्षित।

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

]]>

__आंकड़े__

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

उदाहरण

RSI आरपीसी::एक्सएमएल वितरण नामक उपनिर्देशिका में कई डिफ़ॉल्ट विधियाँ आती हैं
(गुप्त रूप से पर्याप्त) "तरीके"। इनमें से प्रत्येक को ("*.आधार" के सेट के रूप में व्यक्त किया गया है।
"*.कोड", "*.सहायता") फ़ाइलें। Makefile.PL फ़ाइल परिणामी Makefile को इस प्रकार कॉन्फ़िगर करती है
इनका उपयोग इस टूल का उपयोग करके "*.xpl" फ़ाइलें बनाने और फिर उन्हें इंस्टॉल करने के लिए किया जाता है।

निदान

अधिकांश समस्याएँ त्रुटि संदेशों के रूप में सामने आती हैं और उसके बाद अचानक बाहर निकल जाते हैं।

बाहर निकलें स्थिति

सफल होने पर टूल 0 की स्थिति के साथ बाहर निकलता है, और अन्यथा 255 की स्थिति के साथ।

चेतावनियां

मुझे तरीकों को निर्दिष्ट करने का यह तरीका ज्यादा पसंद नहीं है, लेकिन मुझे अपने अन्य विचार भी पसंद आए
कम से।

onworks.net सेवाओं का उपयोग करके ऑनलाइन make_methodp का उपयोग करें