make_methodp - عبر الإنترنت في السحابة

برنامج:

اسم

make_method - تحويل كود Perl إلى وصف XML لـ RPC::XML::Server

موجز

make_method --name=system.identification --helptext='سلسلة معرف النظام'
- التوقيع = سلسلة - كود = ident.pl - إخراج = ident.xpl

make_method --base=methods/identification

الوصف

هذه أداة بسيطة لإنشاء ملفات وصفية بتنسيق XML لتحديد الأساليب المطلوبة
نشرت من قبل RPC::XML::الخادمخادم قائم.

إذا تمت كتابة الخادم بحيث تكون الأساليب التي يصدرها (أو ينشر) جزء من
تشغيل التعليمات البرمجية، ليست هناك حاجة لهذه الأداة. ومع ذلك، في الحالات التي يجوز فيها الخادم
تكون منفصلة ومتميزة عن التعليمات البرمجية (مثل خادم RPC المستند إلى Apache)، مع تحديد
يمكن أن تكون الإجراءات الروتينية وملء المعلومات الداعمة مرهقة.

أحد الحلول التي RPC::XML::الخادم عروض الحزمة هي وسيلة التحميل القابلة للنشر
كود من ملف خارجي. الملف مكتوب بلغة XML بسيطة تحذف بوضوح امتداد الملف
الاسم المرئي خارجيًا، وتوقيعات الطريقة، ونص المساعدة، والكود نفسه. هؤلاء
يمكن إنشاء الملفات يدويًا، أو يمكن استخدام هذه الأداة كمساعد.

مطلوبة الحجج

لا توجد وسائط مطلوبة، ولكن إذا لم تكن هناك خيارات كافية، فسيتم تمريرها
يقال من خلال رسالة خطأ.

OPTIONS

تتعرف الأداة على الخيارات التالية:

--مساعدة
يطبع ملخصًا قصيرًا للخيارات.

- الاسم = STRING
يحدد الاسم المنشور للطريقة التي يتم تشفيرها. وهذا هو الاسم الذي به
سوف تكون مرئية لعملاء الخادم.

--مساحة الاسم = STRING
يحدد مساحة الاسم التي سيتم تقييم كود الطريقة فيها ، عندما XPL
يتم تحميل الملف بواسطة مثيل الخادم.

--type=STRING
حدد نوع الملف الناتج. يشير "النوع" هنا إلى ما إذا كانت الحاوية أم لا
ستحدد العلامة المستخدمة في ملف XML الناتج أ الإجراءات أو طريقة. الافتراضي هو
طريقة. يتم التعامل مع السلسلة بشكل مستقل عن حالة الأحرف، ويتم التعامل مع الحرف الأول فقط ("m" أو
"p") يعتبر في الواقع.

--الإصدار=STRING
حدد ختم إصدار لروتين التعليمات البرمجية.

--مختفي
إذا تم تجاوز ذلك، فسيتضمن الملف الناتج علامة تخبر البرنامج الخفي للخادم
لعدم جعل الروتين مرئيًا من خلال أي واجهات استبطان.

--signature=STRING [ --signature=STRING ... ]
حدد توقيعًا واحدًا أو أكثر للطريقة. يجب أن تكون التوقيعات أسماء النوع كما
الموضحة في الوثائق في RPC::XML، مع فصل العناصر بنقطتين. أنت
قد تفصلهم أيضًا بمسافات ، إذا اقتبست الحجة. قد يكون هذا الخيار
تم تحديدها أكثر من مرة، حيث قد تحتوي بعض الطرق على عدة توقيعات.

--helptext=STRING
حدد نص التعليمات الخاص بالأسلوب كسلسلة بسيطة في سطر الأوامر. لا
مناسب لسلاسل المساعدة الطويلة للغاية.

--helpfile = FILE
اقرأ نص التعليمات الخاص بالأسلوب من الملف المحدد.

--code=FILE
اقرأ الكود الفعلي للإجراء من الملف المحدد. إذا لم يكن هذا الخيار
بالنظر إلى ذلك ، تتم قراءة الكود من واصف ملف الإدخال القياسي.

- الإخراج = FILE
اكتب تمثيل XML الناتج إلى الملف المحدد. إذا لم يكن هذا الخيار
معين، ثم ينتقل الإخراج إلى واصف ملف الإخراج القياسي.

--base=NAME
هذا خيار خاص "الكل في واحد". إذا تم تمريره، فسيتم تجاهل كافة الخيارات الأخرى.

يتم استخدام القيمة كعنصر أساسي لقراءة المعلومات من ملف مسمى
الفئة الأساسية.قاعدة. سيحتوي هذا الملف على مواصفات الاسم والإصدار والحالة المخفية،
التوقيعات ومعلومات الطريقة الأخرى. يجب أن يبدو كل سطر من الملف كواحد من
ما يلي:

الاسم: STRING
حدد اسم الروتين الذي يتم نشره. إذا لم يظهر هذا السطر
ثم قيمة --يتمركز ستكون الوسيطة مع إزالة جميع عناصر الدليل
مستخدم.

الاسم: STRING
قم بتوفير ختم إصدار للوظيفة. إذا لم يكن هناك خط مطابق لهذا النمط
الحالية، لن يتم كتابة علامة الإصدار.

مخفي: STRING
إذا كان موجودا، STRING يجب أن تكون إما "نعم" أو "لا" (الحالة ليست مهمة). اذا كانت
"نعم"، ثم تم وضع علامة على الطريقة لتكون مخفية من أي واجهة برمجة تطبيقات للاستبطان.

التوقيع: STRING
قد يظهر هذا الخط أكثر من مرة ، ويتم التعامل معه بشكل تراكمي. خيارات أخرى
تجاوز القيم السابقة إذا ظهرت أكثر من مرة. الجزء الذي يلي
يعتبر جزء "التوقيع:" بمثابة توقيع منشور للطريقة، مع
العناصر مفصولة بمسافة بيضاء. يجب أن يكون لكل طريقة توقيع واحد على الأقل، لذلك
سيؤدي عدم وجود أي منها إلى حدوث خطأ.

ملف المساعدة: STRING
يحدد الملف الذي سيتم قراءة نص التعليمات منه. إنه ليس خطأ إذا لم يكن هناك مساعدة
تم تحديد النص.

ملف التعليمات البرمجية: STRING
يحدد الملف الذي سيتم قراءة التعليمات البرمجية منه. من المفترض أن يكون الرمز هو Perl، و
سيتم وضع علامة على هذا النحو في الملف الناتج.

ملف التعليمات البرمجية [اللغة الإنجليزية]: سلسلة
يحدد الملف الذي سيتم قراءة التعليمات البرمجية منه، مع تحديد اللغة أيضًا
أن الكود موجود. وهذا يسمح بإنشاء ملف XPL الملف الذي يتضمن
تطبيقات لغة متعددة للطريقة أو الإجراء المحدد.

يتم تجاهل أي خطوط أخرى غير الأنماط المذكورة أعلاه.

إذا لم تتم قراءة أي رمز، فستخرج الأداة برسالة خطأ.

تتم كتابة الإخراج إلى الفئة الأساسية.xpl، مع الحفاظ على معلومات المسار بحيث
الملف الناتج موجود بجانب الملفات المصدر مباشرة. وهذا يسمح بإنشاءات مثل:

make_method --base=methods/introspection

FILE FORMAT لأي لبس DTD

تنسيق الملف لهذه الإجراءات المنشورة هو لهجة XML بسيطة جدًا. هذا أقل
نظرًا لكون XML تنسيقًا مثاليًا أكثر من توفر المحلل اللغوي، نظرًا لأن
RPC::XML::الخادم سيكون للفئة بالفعل رمز المحلل اللغوي في النواة. كتابة جديدة تماما
لن يكون الشكل اكتسب أي شيء.

يمكن تلخيص إعلان نوع المستند للتنسيق من خلال:

<!ELEMENT proceduredef (name, namespace?, version?, hidden?,
التوقيع+، المساعدة؟، الكود)>
<!ELEMENT methoddef (name, namespace?, version?, hidden?,
التوقيع+، المساعدة؟، الكود)>
<!ELEMENT functiondef (name, namespace?, version?, hidden?,
التوقيع+، المساعدة؟، الكود)>









يحتوي الملف "rpc-method.dtd" الذي يأتي مع التوزيع على بعض التعليقات بالإضافة إلى ذلك
للمواصفات الفعلية.

يقتصر الملف (في الوقت الحالي) على تعريف واحد. يبدأ هذا بإحدى الفتحات
العلامات " "،" " أو " ". ويتبع ذلك واحد بالضبط
" "حاوية تحدد اسم الطريقة، وختم الإصدار الاختياري، واختياري
علامة الإخفاء من الاستبطان، واحدة أو أكثر " "حاويات تحدد التوقيعات،
اختياري " " الحاوية التي تحتوي على نص المساعدة، ثم " container with the
كود البرنامج الفعلي يجب أن يستخدم كل النص ترميز الكيان للرموز:

& C<&> (علامة الضم)
ه ج<<> (أقل من)
ه ج<>> (أكبر من)

ستقوم عملية التحليل داخل فئة الخادم بفك تشفير الكيانات. لصنع الأشياء
بشكل أسهل، تقوم الأداة بمسح جميع عناصر النص وترميز الكيانات المذكورة أعلاه قبل كتابة الملف
ملف.

• المواصفات الخاصه of رمز
هذه ليست "برمجة 101 "، ولا هو "بيرل For ال قليلا خافت". الكود الذي هو
يتم تمريره عبر أحد ملفات "*.xpl" إلى "eval" دون أي تعديل تقريبًا
(انظر أدناه). وبالتالي، يمكن أن تؤدي التعليمات البرمجية الضارة أو المكتوبة بشكل سيئ إلى إحداث ضرر كبير بجهازك
الخادم. هذا ليس خطأ رمز الخادم. ثمن مرونة هذا النظام
تقع مسؤولية العروض على عاتق المطور للتأكد من أن الكود
مجربة وآمنة.

يتم التعامل مع الكود نفسه حرفيًا قدر الإمكان. قد تحدث بعض التعديلات من جانب الخادم،
لأنه يجعل الكود مناسبًا لإنشاء روتين فرعي مجهول من. ال make_method
ستحاول الأداة استخدام قسم "CDATA" لتضمين الكود في مستند XML، لذلك
أنه ليست هناك حاجة لتشفير الكيانات أو ما شابه. وهذا يسمح للنتيجة *.xpl
الملفات التي يمكن اختبار تركيبها باستخدام "Perl -cx". يمكنك المساعدة في ذلك عن طريق التأكد من أن الكود
لا يحتوي على أي من تسلسل الأحرف التاليين:

]]>

__بيانات__

الأول هو فاصل "CDATA". إذا حدث ذلك بشكل طبيعي في الكود، فسيتم تشغيله
نهاية القسم في المحلل اللغوي. والثاني هو رمز Perl المألوف، والذي يتم إدراجه
بحيث لا يؤدي باقي مستند XML إلى تشويش محلل Perl.

أمثلة

• آر بي سي::XML يأتي التوزيع مع عدد من الطرق الافتراضية في دليل فرعي يسمى
(بشكل غامض بما فيه الكفاية) "الأساليب". يتم التعبير عن كل منها كمجموعة من ("*.base"،
ملفات "*.code"، "*.help"). يقوم ملف Makefile.PL بتكوين ملف Makefile الناتج
يتم استخدامها لإنشاء ملفات "*.xpl" باستخدام هذه الأداة، ثم قم بتثبيتها.

DIAGNOSTICS

معظم المشاكل تأتي في شكل رسائل خطأ يتبعها خروج مفاجئ.

EXIT الوضع

يتم إنهاء الأداة بالحالة 0 عند النجاح، و255 بخلاف ذلك.

تحفظات

لا أحب هذا الأسلوب كثيرًا في تحديد الطرق، لكني أحببت أفكاري الأخرى أيضًا
أقل.

استخدم make_methodp عبر الإنترنت باستخدام خدمات onworks.net