make_methodp - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

make_method - เปลี่ยนโค้ด Perl เป็นคำอธิบาย XML สำหรับ RPC::XML::Server

เรื่องย่อ

make_method --name=system.identification --helptext='System ID string'
--ลายเซ็น=สตริง --code=ident.pl --output=ident.xpl

make_method --base=วิธีการ/การระบุ

DESCRIPTION

นี่เป็นเครื่องมือง่ายๆ ในการสร้างไฟล์อธิบาย XML เพื่อระบุเมธอดที่จะเป็น
จัดพิมพ์โดย an RPC::XML::เซิร์ฟเวอร์เซิร์ฟเวอร์ที่ใช้

หากเซิร์ฟเวอร์ถูกเขียนในลักษณะที่ส่งออก (หรือ เผยแพร่) เป็นส่วนหนึ่งของ
รันโค้ดแล้วไม่จำเป็นต้องใช้เครื่องมือนี้ อย่างไรก็ตาม ในกรณีที่เซิร์ฟเวอร์อาจ
แยกออกจากโค้ด (เช่นเซิร์ฟเวอร์ RPC ที่ใช้ Apache) โดยระบุ
การทำกิจวัตรและการกรอกข้อมูลสนับสนุนอาจเป็นเรื่องยุ่งยาก

ทางออกหนึ่งที่ RPC::XML::เซิร์ฟเวอร์ ข้อเสนอแพ็คเกจเป็นวิธีโหลดที่เผยแพร่ได้
รหัสจากไฟล์ภายนอก ไฟล์นี้ใช้ภาษา XML ธรรมดาที่อธิบาย
ชื่อที่มองเห็นได้จากภายนอก ลายเซ็นเมธอด ข้อความช่วยเหลือ และโค้ดเอง เหล่านี้
ไฟล์อาจถูกสร้างขึ้นด้วยตนเองหรือเครื่องมือนี้อาจใช้เป็นผู้ช่วย

ที่จำเป็น อาร์กิวเมนต์

ไม่มีข้อโต้แย้งที่จำเป็น แต่ถ้าไม่มีตัวเลือกเพียงพอผ่านไปคุณจะ
แจ้งด้วยข้อความแสดงข้อผิดพลาด

OPTIONS

เครื่องมือรู้จักตัวเลือกต่อไปนี้:

--ช่วยด้วย
พิมพ์สรุปสั้น ๆ ของตัวเลือก

--ชื่อ=STRING
ระบุชื่อเผยแพร่ของวิธีการที่ถูกเข้ารหัส นี่คือชื่อโดยที่มัน
จะปรากฏต่อลูกค้าของเซิร์ฟเวอร์

--เนมสเปซ=STRING
ระบุเนมสเปซที่โค้ดของเมธอดจะถูกประเมินเมื่อXPL
ไฟล์ถูกโหลดโดยอินสแตนซ์ของเซิร์ฟเวอร์

--type=STRING
ระบุประเภทของไฟล์ผลลัพธ์ "ประเภท" ในที่นี้หมายถึงว่าตู้คอนเทนเนอร์
แท็กที่ใช้ใน XML ที่ได้จะระบุ a ขั้นตอนการ หรือ วิธี. ค่าเริ่มต้นคือ
วิธี. สตริงได้รับการปฏิบัติโดยไม่ขึ้นกับตัวพิมพ์ และเฉพาะอักขระตัวแรก ("m" หรือ
"p") ถือเป็นจริง

--รุ่น=STRING
ระบุการประทับเวอร์ชันสำหรับรูทีนโค้ด

--ที่ซ่อนอยู่
หากผ่าน ไฟล์ที่ได้จะมีแท็กที่บอกเซิร์ฟเวอร์ daemon
เพื่อไม่ให้มองเห็นรูทีนผ่านอินเทอร์เฟซวิปัสสนาใดๆ

--ลายเซ็น=STRING [ --ลายเซ็น=STRING ... ]
ระบุลายเซ็นอย่างน้อยหนึ่งรายการสำหรับวิธีการ ลายเซ็นควรเป็นชื่อประเภทเป็น
วางไว้ในเอกสารประกอบใน RPC::XML โดยมีองค์ประกอบคั่นด้วยเครื่องหมายทวิภาค คุณ
อาจแยกพวกเขาด้วยช่องว่างถ้าคุณอ้างอาร์กิวเมนต์ ตัวเลือกนี้อาจจะเป็น
ระบุมากกว่าหนึ่งครั้ง เนื่องจากบางวิธีอาจมีหลายลายเซ็น

--ข้อความช่วยเหลือ=STRING
ระบุข้อความวิธีใช้สำหรับเมธอดเป็นสตริงอย่างง่ายในบรรทัดรับคำสั่ง ไม่
เหมาะสำหรับสายช่วยเหลือยาวชะมัด

--helpfile=ไฟล์
อ่านข้อความวิธีใช้สำหรับวิธีการจากไฟล์ที่ระบุ

--code=ไฟล์
อ่านรหัสจริงสำหรับรูทีนจากไฟล์ที่ระบุ ถ้าตัวเลือกนี้ไม่ใช่
กำหนด รหัสจะถูกอ่านจากตัวอธิบายไฟล์อินพุตมาตรฐาน

--output=ไฟล์
เขียนการแทนค่า XML ที่เป็นผลลัพธ์ไปยังไฟล์ที่ระบุ ถ้าตัวเลือกนี้ไม่ใช่
ให้แล้วเอาต์พุตไปที่ตัวอธิบายไฟล์เอาต์พุตมาตรฐาน

--base=ชื่อ
นี่เป็นตัวเลือกพิเศษ "รวมทุกอย่าง" หากผ่าน ตัวเลือกอื่นๆ ทั้งหมดจะถูกละเว้น

ค่านี้ใช้เป็นองค์ประกอบพื้นฐานสำหรับการอ่านข้อมูลจากไฟล์ชื่อ
BASE.ฐาน. ไฟล์นี้จะมีสเปคของชื่อ รุ่น สถานะที่ซ่อนอยู่
ลายเซ็นและข้อมูลวิธีการอื่นๆ แต่ละบรรทัดของไฟล์ควรมีลักษณะเหมือนหนึ่งใน
ต่อไปนี้:

ชื่อ: STRING
ระบุชื่อของรูทีนที่จะเผยแพร่ หากบรรทัดนี้ไม่ปรากฏขึ้น
แล้วค่าของ --ฐาน อาร์กิวเมนต์ที่ลบองค์ประกอบไดเร็กทอรีทั้งหมดออกจะเป็น
มือสอง

เวอร์ชัน: STRING
ระบุตราประทับเวอร์ชันสำหรับฟังก์ชัน หากไม่มีเส้นตรงกับรูปแบบนี้คือ
ปัจจุบันจะไม่มีการเขียนแท็กเวอร์ชัน

ซ่อนอยู่: STRING
ถ้ามี STRING ควรเป็น "ใช่" หรือ "ไม่ใช่" (ตัวพิมพ์ไม่สำคัญ) ถ้ามันเป็น
"ใช่" จากนั้นเมธอดจะถูกทำเครื่องหมายให้ซ่อนจาก API การวิปัสสนาใดๆ

ลายเซ็น: STRING
บรรทัดนี้อาจปรากฏขึ้นมากกว่าหนึ่งครั้ง และได้รับการปฏิบัติแบบสะสม ตัวเลือกอื่น
แทนที่ค่าก่อนหน้าหากปรากฏมากกว่าหนึ่งครั้ง ส่วนต่อจาก
"ลายเซ็น:" ส่วนหนึ่งนำไปเป็นลายเซ็นเผยแพร่สำหรับวิธีการด้วย
องค์ประกอบที่คั่นด้วยช่องว่าง แต่ละวิธีต้องมีลายเซ็นอย่างน้อยหนึ่งรายการ ดังนั้น
ขาดสิ่งใดจะทำให้เกิดข้อผิดพลาด

ไฟล์ช่วยเหลือ: STRING
ระบุไฟล์ที่จะอ่านข้อความวิธีใช้ ไม่ใช่ข้อผิดพลาดหากไม่มีความช่วยเหลือ
มีการระบุข้อความ

ไฟล์โค้ด: STRING
ระบุไฟล์ที่จะอ่านโค้ด รหัสจะถือว่าเป็น Perl และ
จะถูกแท็กเช่นนี้ในไฟล์ผลลัพธ์

ไฟล์โค้ด[lang]: เชือก
ระบุไฟล์ที่จะอ่านโค้ดในขณะที่ระบุภาษา
ว่ามีรหัสอยู่ ซึ่งช่วยให้สร้าง a XPL ไฟล์ที่มี
การใช้งานหลายภาษาของวิธีการหรือขั้นตอนที่กำหนด

บรรทัดอื่นนอกเหนือจากรูปแบบข้างต้นจะถูกละเว้น

หากไม่มีการอ่านรหัส เครื่องมือจะออกมาพร้อมกับข้อความแสดงข้อผิดพลาด

ผลลัพธ์ถูกเขียนถึง BASE.xpl รักษาข้อมูลเส้นทางเพื่อให้
ไฟล์ผลลัพธ์จะอยู่เคียงข้างไฟล์ต้นฉบับ สิ่งนี้ช่วยให้สร้างเช่น:

make_method --base=methods/วิปัสสนา

ไฟล์ FORMAT AND DTD

รูปแบบไฟล์สำหรับกิจวัตรที่เผยแพร่เหล่านี้เป็นภาษา XML ที่ง่ายมาก น้อยกว่านี้
เนื่องจาก XML เป็นรูปแบบในอุดมคติมากกว่าความพร้อมใช้งานของ parser เนื่องจาก
RPC::XML::เซิร์ฟเวอร์ คลาสจะมีรหัส parser ในคอร์อยู่แล้ว เขียนใหม่หมด
รูปแบบจะไม่ได้รับอะไร

การประกาศประเภทเอกสารสำหรับรูปแบบสามารถสรุปได้โดย:

<!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<&> (เครื่องหมายและ)
อี C<<> (น้อยกว่า)
อี C<>> (มากกว่า)

กระบวนการแยกวิเคราะห์ภายในคลาสเซิร์ฟเวอร์จะถอดรหัสเอนทิตี เพื่อทำสิ่งต่างๆ
ง่ายขึ้น เครื่องมือจะสแกนองค์ประกอบข้อความทั้งหมดและเข้ารหัสเอนทิตีด้านบนก่อนเขียน
ไฟล์

พื้นที่ สเปค of รหัส
นี้ไม่ได้ "การเขียนโปรแกรม 101 "ไม่เป็น "เพิร์ล for ค่อนข้าง ติ่มซำ". รหัสที่เป็น
ส่งผ่านไฟล์ "*.xpl" ไฟล์ใดไฟล์หนึ่งไปยัง "eval" โดยไม่มีการดัดแปลงใดๆ
(ดูด้านล่าง). ดังนั้น โค้ดที่เขียนไม่ดีหรือเป็นอันตรายสามารถสร้างความหายนะให้กับ . ของคุณได้เป็นอย่างดี
เซิร์ฟเวอร์ นี่ไม่ใช่ความผิดของรหัสเซิร์ฟเวอร์ ราคาของความยืดหยุ่นของระบบนี้
ข้อเสนอเป็นความรับผิดชอบในส่วนของนักพัฒนาเพื่อให้แน่ใจว่ารหัสนั้น
ผ่านการทดสอบและปลอดภัย

รหัสจะถือว่าเป็นคำต่อคำมากที่สุด การแก้ไขบางอย่างอาจเกิดขึ้นที่ฝั่งเซิร์ฟเวอร์
เนื่องจากทำให้รหัสเหมาะสำหรับการสร้างรูทีนย่อยที่ไม่ระบุชื่อ NS make_method
เครื่องมือจะพยายามใช้ส่วน "CDATA" เพื่อฝังโค้ดภายในเอกสาร XML ดังนั้น
ว่าไม่จำเป็นต้องเข้ารหัสเอนทิตีหรืออย่างอื่น นี้จะช่วยให้ผลลัพธ์ *.xpl
ไฟล์ที่จะทดสอบไวยากรณ์ด้วย "perl -cx" คุณสามารถช่วยสิ่งนี้ได้โดยตรวจสอบให้แน่ใจว่ารหัส
ไม่มีลำดับอักขระอย่างใดอย่างหนึ่งต่อไปนี้:

]]>

__ข้อมูล__

อย่างแรกคือเทอร์มิเนเตอร์ "CDATA" ถ้ามันเกิดขึ้นตามธรรมชาติในโค้ด มันจะทริกเกอร์
ส่วนท้ายของส่วนใน parser อันที่สองคือโทเค็น Perl ที่คุ้นเคยซึ่งถูกแทรก
เพื่อให้ส่วนที่เหลือของเอกสาร XML ไม่เกะกะ Parser Perl

ตัวอย่าง

พื้นที่ RPC::XML การแจกจ่ายมาพร้อมกับวิธีการเริ่มต้นจำนวนหนึ่งในไดเร็กทอรีย่อยที่เรียกว่า
(พอเป็นความลับ) "วิธีการ" แต่ละรายการเหล่านี้แสดงเป็นชุดของ ("*.base",
ไฟล์ "*.code", "*.help") ไฟล์ Makefile.PL กำหนดค่าผลลัพธ์ของ Makefile เช่น
ที่ใช้ในการสร้างไฟล์ "*.xpl" โดยใช้เครื่องมือนี้ แล้วติดตั้ง

วินิจฉัย

ปัญหาส่วนใหญ่ออกมาในรูปแบบของข้อความแสดงข้อผิดพลาดตามด้วยการออกอย่างกะทันหัน

EXIT สถานภาพ

เครื่องมือจะออกโดยมีสถานะเป็น 0 เมื่อสำเร็จ และมิฉะนั้น 255

คำเตือน

ฉันไม่ค่อยชอบแนวทางนี้ในการระบุวิธีการ แต่ฉันก็ชอบความคิดอื่นๆ ของฉันเหมือนกัน
น้อยกว่า

ใช้ make_methodp ออนไลน์โดยใช้บริการ onworks.net