این دستور make_methodp است که می تواند در ارائه دهنده هاست رایگان OnWorks با استفاده از یکی از چندین ایستگاه کاری آنلاین رایگان ما مانند Ubuntu Online، Fedora Online، شبیه ساز آنلاین ویندوز یا شبیه ساز آنلاین MAC OS اجرا شود.
برنامه:
نام
make_method - تبدیل کد پرل به یک توضیح XML برای RPC::XML::سرور
خلاصه
make_method --name=system.identification --helptext='string ID سیستم'
--signature=string --code=ident.pl --output=ident.xpl
make_method --base=methods/identification
شرح
این یک ابزار ساده برای ایجاد فایل‌های توصیفی XML برای تعیین روش‌ها است
منتشر شده توسط an RPC::XML::سرورسرور مبتنی بر
اگر سروری طوری نوشته شده باشد که متدهایی که صادر می کند (یا منتشر) بخشی از
کد در حال اجراست، پس نیازی به این ابزار نیست. با این حال، در مواردی که سرور ممکن است
جدا و متمایز از کد (مانند یک سرور RPC مبتنی بر آپاچی)، مشخص
روال ها و پر کردن اطلاعات پشتیبانی می تواند دست و پا گیر باشد.
یک راه حل که RPC::XML::سرور پیشنهادات بسته وسیله ای برای بارگیری قابل انتشار است
کد از یک فایل خارجی فایل به یک گویش ساده XML است که به وضوح آن را مشخص می کند
نام قابل مشاهده خارجی، امضاهای روش، متن راهنما و خود کد. اینها
ممکن است فایل ها به صورت دستی ایجاد شوند یا از این ابزار به عنوان کمکی استفاده شود.
مورد نیاز ادله
هیچ آرگومان مورد نیازی وجود ندارد، اما اگر گزینه های کافی وجود نداشته باشد، این کار را خواهید کرد
با یک پیغام خطا گفته شود
OPTIONS
این ابزار گزینه های زیر را تشخیص می دهد:
--کمک
خلاصه کوتاهی از گزینه ها را چاپ می کند.
--name=STRING
نام منتشر شده روش در حال کدگذاری را مشخص می کند. این نامی است که با آن است
برای مشتریان سرور قابل مشاهده خواهد بود.
--namespace=STRING
فضای نامی را مشخص می کند که کد متد در زمانی که XPL در آن ارزیابی می شود
فایل توسط یک نمونه سرور بارگیری می شود.
--type=STRING
نوع فایل حاصل را مشخص کنید. "نوع" در اینجا به این اشاره دارد که آیا ظرف
تگ استفاده شده در XML حاصل، a را مشخص می کند روش یا یک روش. پیش فرض است
روش. رشته مستقل از حروف کوچک و بزرگ و فقط کاراکتر اول ("m" یا
"p") در واقع در نظر گرفته می شود.
--نسخه=STRING
یک مهر نسخه برای روال کد مشخص کنید.
-- پنهان
اگر این مورد قبول باشد، فایل به دست آمده شامل یک برچسب است که به سرور سرور می گوید
تا روال از طریق هر رابط درون نگری قابل مشاهده نباشد.
--signature=STRING [ --signature=STRING ... ]
یک یا چند امضا برای روش مشخص کنید. امضاها باید با نام نوع باشند
در اسناد در RPC::XML گذاشته شده است، با عناصر جدا شده توسط یک دو نقطه. شما
اگر استدلال را نقل کنید، ممکن است آنها را با فاصله از هم جدا کنید. این گزینه ممکن است
بیش از یک بار مشخص شده است، زیرا برخی از روش ها ممکن است چندین امضا داشته باشند.
--helptext=STRING
متن راهنما را برای متد به عنوان یک رشته ساده در خط فرمان مشخص کنید. نه
برای رشته های کمک بسیار طولانی مناسب است.
--helpfile=FILE
متن راهنمای روش را از فایل مشخص شده بخوانید.
--code=FILE
کد واقعی روال را از فایل مشخص شده بخوانید. اگر این گزینه نیست
داده شده، کد از توصیفگر فایل ورودی استاندارد خوانده می شود.
--output=FILE
نمایش XML حاصل را در فایل مشخص شده بنویسید. اگر این گزینه نیست
داده شده، سپس خروجی به توصیفگر فایل خروجی استاندارد می رود.
--base=NAME
این یک گزینه ویژه و "همه در یک" است. در صورت تصویب، همه گزینه های دیگر نادیده گرفته می شوند.
مقدار به عنوان عنصر پایه برای خواندن اطلاعات از یک فایل به نام استفاده می شود
BASE.پایه. این فایل حاوی مشخصات نام، نسخه، وضعیت مخفی،
امضاها و سایر اطلاعات روش هر خط از فایل باید شبیه یکی از آنها باشد
به شرح زیر است:
نام: STRING
نام روال در حال انتشار را مشخص کنید. اگر این خط ظاهر نشد،
سپس ارزش --پایه آرگومان با حذف تمام عناصر دایرکتوری خواهد بود
استفاده شده.
نسخه: STRING
یک مهر نسخه برای عملکرد ارائه دهید. اگر هیچ خطی با این الگو مطابقت نداشته باشد
در حال حاضر، هیچ تگ نسخه ای نوشته نخواهد شد.
پنهان: STRING
در صورت وجود ، STRING باید "بله" یا "خیر" باشد (حرف مهم نیست). اگر هست
"بله"، سپس روش علامت گذاری می شود که از هر API درون نگری پنهان باشد.
امضا: STRING
این خط ممکن است بیش از یک بار ظاهر شود و به صورت تجمعی درمان می شود. گزینه های دیگر
اگر مقادیر قبلی بیش از یک بار ظاهر شوند، لغو شوند. بخش زیر
قسمت "Signature:" به عنوان امضای منتشر شده برای روش گرفته می شود، با
عناصر جدا شده با فضای خالی هر روش باید حداقل یک امضا داشته باشد، بنابراین
فقدان هر کدام باعث خطا می شود.
فایل راهنما: STRING
فایلی را مشخص می کند که از آن متن راهنما خوانده شود. در صورت عدم کمک، خطا نیست
متن مشخص شده است.
کد فایل: STRING
فایلی را مشخص می کند که کد را از آن بخواند. کد Perl و
در فایل حاصل به این صورت برچسب گذاری می شود.
کد فایل[زبان]: رشته
فایلی را که از آن کد بخواند، مشخص می کند، در حالی که زبان را نیز شناسایی می کند
این امکان ایجاد a را فراهم می کند XPL فایلی که شامل
پیاده سازی چند زبانه متد یا رویه داده شده.
هر خط دیگری غیر از الگوهای بالا نادیده گرفته می شود.
اگر هیچ کدی خوانده نشده باشد، ابزار با پیغام خطا خارج می شود.
خروجی در نوشته می شود BASExpl. اطلاعات مسیر را حفظ می کند تا
فایل حاصل درست در کنار فایل های منبع قرار دارد. این اجازه می دهد تا سازه هایی مانند:
make_method --base=روش ها/درون نگری
فایل 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<&> (امپرسند)
E C<<> (کمتر از)
E C<>> (بیشتر از)
فرآیند تجزیه در کلاس سرور، موجودیت ها را رمزگشایی می کند. برای ساختن چیزها
آسان تر، ابزار تمام عناصر متن را اسکن می کند و موجودیت های فوق را قبل از نوشتن کدگذاری می کند
فایل.
La مشخصات of رمز
این است که "برنامه نويسي 101 "و اینطور نیست "پرل برای la تاحدی اذعان". کدی که هست
ارسال شده از طریق یکی از فایل های "*.xpl" به "eval" بدون هیچ تغییری منتقل می شود.
(پایین را ببینید). بنابراین، کدهای بد نوشته یا مخرب می توانند به خوبی شما را خراب کنند
سرور این تقصیر کد سرور نیست. قیمت انعطاف پذیری این سیستم
این مسئولیت بر عهده توسعه دهنده است تا اطمینان حاصل کند که کد موجود است
تست شده و ایمن
خود کد تا حد امکان به طور کلمه به کلمه در نظر گرفته می شود. برخی از ویرایش ها ممکن است در سمت سرور رخ دهد،
زیرا کد را برای ایجاد یک زیربرنامه ناشناس از آن مناسب می کند. در make_method
ابزار سعی خواهد کرد از بخش "CDATA" برای جاسازی کد در سند XML استفاده کند، بنابراین
که نیازی به کدگذاری موجودیت ها یا موارد مشابه نیست. این اجازه می دهد تا در نتیجه *.xpl
فایل هایی که با دستور "perl -cx" قابل آزمایش باشند. شما می توانید با اطمینان از اینکه کد به این امر کمک کنید
هیچ یک از دو دنباله کاراکتر زیر را شامل نمی شود:
]]>
__داده ها__
اولین ترمیناتور "CDATA" است. اگر به طور طبیعی در کد رخ دهد، باعث می شود
انتهای بخش در تجزیه کننده دومی توکن آشنای پرل است که درج شده است
به طوری که باقیمانده سند XML تجزیه کننده پرل را به هم نریزد.
مثال ها
La RPC::XML توزیع با تعدادی روش پیش فرض در یک زیر شاخه به نام ارائه می شود
(به اندازه کافی رمزآلود) "روش ها". هر یک از اینها به عنوان مجموعه ای از ("*.base"، بیان می شود.
فایل های "*.code"، "*.help"). فایل Makefile.PL فایل Makefile به دست آمده را پیکربندی می کند
که از اینها برای ایجاد فایل های "*.xpl" با استفاده از این ابزار و سپس نصب آنها استفاده می شود.
عیب یابی
بیشتر مشکلات به صورت پیام های خطا و به دنبال آن خروج ناگهانی ظاهر می شوند.
خروج وضعیت
این ابزار در صورت موفقیت با وضعیت 0 و در غیر این صورت 255 خارج می شود.
هشدارها
من این رویکرد را برای مشخص کردن روش‌ها دوست ندارم، اما حتی ایده‌های دیگرم را دوست داشتم
کمتر
از make_methodp به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید
