make_methodp - Online sa Cloud

PROGRAMA:

NAME

make_method - Gawing isang XML na paglalarawan ang Perl code para sa RPC::XML::Server

SINOPSIS

make_method --name=system.identification --helptext='System ID string'
--signature=string --code=ident.pl --output=ident.xpl

make_method --base=methods/identification

DESCRIPTION

Ito ay isang simpleng tool upang lumikha ng mga XML na naglalarawang mga file para sa pagtukoy ng mga paraan upang maging
inilathala ng isang RPC::XML::Server-based na server.

Kung ang isang server ay isinulat na ang mga pamamaraan na ine-export nito (o nagpa-publish) ay bahagi ng
tumatakbong code, pagkatapos ay hindi na kailangan para sa tool na ito. Gayunpaman, sa mga kaso kung saan maaaring ang server
maging hiwalay at naiiba sa code (gaya ng isang Apache-based na RPC server), na tumutukoy
ang mga gawain at pagpuno sa mga sumusuportang impormasyon ay maaaring maging mahirap.

Isang solusyon na ang RPC::XML::Server Ang mga alok ng package ay ang paraan upang mai-load ang mai-publish
code mula sa isang panlabas na file. Ang file ay nasa isang simpleng XML dialect na malinaw na naglalarawan sa
panlabas na nakikitang pangalan, ang mga lagda ng pamamaraan, ang text ng tulong at ang code mismo. Ang mga ito
Ang mga file ay maaaring gawin nang manu-mano, o ang tool na ito ay maaaring gamitin bilang isang aide.

KAILANGAN MGA PANGANGATWIRANG

Walang kinakailangang mga argumento, ngunit kung walang sapat na mga opsyon na naipasa ay gagawin mo
sasabihin sa pamamagitan ng isang mensahe ng error.

Opsyon

Kinikilala ng tool ang mga sumusunod na opsyon:

- Tumulong
Nagpi-print ng maikling buod ng mga opsyon.

--name=STRING
Tinutukoy ang na-publish na pangalan ng paraan na naka-encode. Ito ang pangalan kung saan ito
ay makikita ng mga kliyente ng server.

--namespace=STRING
Tinutukoy ang isang namespace kung saan susuriin ang code ng pamamaraan, kapag ang XPL
Ang file ay na-load ng isang instance ng server.

--type=STRING
Tukuyin ang uri para sa resultang file. Ang "Uri" dito ay tumutukoy sa kung ang lalagyan
Ang tag na ginamit sa nagreresultang XML ay tutukuyin a pamamaraan o isang paraan. Ang default ay
paraan. Ang string ay itinuturing na case-independant, at ang unang character lamang ("m" o
Ang "p") ay talagang itinuturing.

--version=STRING
Tukuyin ang isang bersyon ng selyo para sa code routine.

--nakatago
Kung ito ay passe, ang resultang file ay magsasama ng isang tag na nagsasabi sa server daemon
upang hindi gawing nakikita ang routine sa pamamagitan ng anumang mga interface ng introspection.

--signature=STRING [ --signature=STRING ... ]
Tukuyin ang isa o higit pang mga lagda para sa pamamaraan. Ang mga lagda ay dapat ang uri ng mga pangalan bilang
inilatag sa dokumentasyon sa RPC::XML, na ang mga elemento ay pinaghihiwalay ng isang colon. Ikaw
maaari ring paghiwalayin ang mga ito ng mga puwang, kung sinipi mo ang argumento. Ang pagpipiliang ito ay maaaring
tinukoy ng higit sa isang beses, dahil ang ilang mga pamamaraan ay maaaring may ilang mga lagda.

--helptext=STRING
Tukuyin ang text ng tulong para sa pamamaraan bilang isang simpleng string sa command line. Hindi
angkop para sa napakahabang mga string ng tulong.

--helpfile=FILE
Basahin ang teksto ng tulong para sa pamamaraan mula sa tinukoy na file.

--code=FILE
Basahin ang aktwal na code para sa routine mula sa tinukoy na file. Kung ang pagpipiliang ito ay hindi
ibinigay, ang code ay binabasa mula sa karaniwang input file descriptor.

--output=FILE
Isulat ang nagresultang representasyon ng XML sa tinukoy na file. Kung ang pagpipiliang ito ay hindi
ibinigay, pagkatapos ang output ay mapupunta sa karaniwang output file descriptor.

--base=NAME
Isa itong espesyal, "all-in-one" na opsyon. Kung pumasa, ang lahat ng iba pang mga opsyon ay babalewalain.

Ang halaga ay ginagamit bilang batayang elemento para sa pagbabasa ng impormasyon mula sa isang file na pinangalanan
BASE.base. Ang file na ito ay naglalaman ng detalye ng pangalan, bersyon, nakatagong katayuan,
mga lagda at iba pang impormasyon ng pamamaraan. Ang bawat linya ng file ay dapat magmukhang isa sa
ang mga sumusunod:

pangalan: STRING
Tukuyin ang pangalan ng nakagawiang ini-publish. Kung hindi lalabas ang linyang ito,
pagkatapos ay ang halaga ng --base argument na may lahat ng mga elemento ng direktoryo na tinanggal ay
ginagamit.

Bersyon: STRING
Magbigay ng stamp ng bersyon para sa function. Kung walang linyang tumutugma sa pattern na ito ay
kasalukuyan, walang isusulat na tag ng bersyon.

Nakatago: STRING
Kung naroroon, STRING dapat ay alinman sa "oo" o "hindi" (kaso hindi mahalaga). Kung ito ay
"oo", pagkatapos ay minarkahan ang pamamaraan na itago mula sa anumang introspection API.

Lagda: STRING
Maaaring lumitaw ang linyang ito nang higit sa isang beses, at ginagamot nang pinagsama-sama. Iba pang mga pagpipilian
i-override ang mga nakaraang value kung lumalabas ang mga ito nang higit sa isang beses. Ang bahaging sumusunod sa
Ang bahaging "Lagda:" ay itinuturing na isang nai-publish na lagda para sa pamamaraan, na may
mga elemento na pinaghihiwalay ng whitespace. Ang bawat pamamaraan ay dapat magkaroon ng hindi bababa sa isang lagda, kaya
ang kakulangan ng anuman ay magdudulot ng pagkakamali.

Helpfile: STRING
Tinutukoy ang file kung saan babasahin ang text ng tulong. Ito ay hindi isang error kung walang tulong
tinukoy ang teksto.

Codefile: STRING
Tinutukoy ang file kung saan babasahin ang code. Ang code ay ipinapalagay na Perl, at
ay mai-tag bilang tulad sa resultang file.

Codefile[lang]: pisi
Tinutukoy ang file kung saan babasahin ang code, habang tinutukoy din ang wika
na ang code ay nasa. Ito ay nagbibigay-daan para sa paglikha ng a XPL file na kinabibilangan ng
maramihang pagpapatupad ng wika ng ibinigay na pamamaraan o pamamaraan.

Anumang iba pang mga linya kaysa sa mga pattern sa itaas ay binabalewala.

Kung walang nabasang code, lalabas ang tool na may mensahe ng error.

Ang output ay nakasulat sa BASE.xpl, pinapanatili ang impormasyon ng landas upang ang
ang resultang file ay nasa tabi mismo ng mga source file. Pinapayagan nito ang mga konstruksyon tulad ng:

make_method --base=methods/introspection

FILE FORMAT AT DTD

Ang format ng file para sa mga naka-publish na gawain na ito ay isang napakasimpleng XML dialect. Ito ay mas mababa
dahil sa XML na isang perpektong format kaysa sa pagkakaroon ng parser, na ibinigay na ang
RPC::XML::Server class ay magkakaroon na ng parser code sa core. Pagsusulat ng isang ganap na bago
ang format ay hindi magkakaroon ng anuman.

Ang Deklarasyon ng Uri ng Dokumento para sa format ay maaaring ibuod ng:

<!ELEMENT proceduredef (pangalan, namespace?, bersyon?, nakatago?,
lagda+, tulong?, code)>
<!ELEMENT methoddef (pangalan, namespace?, bersyon?, nakatago?,
lagda+, tulong?, code)>
<!ELEMENT functiondef (pangalan, namespace?, bersyon?, nakatago?,
lagda+, tulong?, code)>









Ang file na "rpc-method.dtd" na kasama ng pamamahagi ay may ilang komento bilang karagdagan
sa aktwal na detalye.

Ang isang file ay (sa ngayon) ay limitado sa isang kahulugan. Ito ay sinimulan ng isa sa pagbubukas
mga tag" "," "o" ". Sinundan ito ng eksaktong isa
" " container na tumutukoy sa pangalan ng pamamaraan, isang opsyonal na bersyon ng selyo, isang opsyonal
watawat ng hide-from-introspection, isa o higit pa " " mga lalagyan na tumutukoy sa mga lagda,
isang opsyonal" " lalagyan na may text ng tulong, pagkatapos ay ang " " container with the
aktwal na code ng programa. Ang lahat ng teksto ay dapat gumamit ng entity encoding para sa mga simbolo:

& C<&> (ampersand)
E C<<> (mas mababa sa)
E C<>> (mas malaki kaysa sa)

Ang proseso ng pag-parse sa loob ng klase ng server ay magde-decode ng mga entity. Upang gumawa ng mga bagay
mas madali, ini-scan ng tool ang lahat ng elemento ng teksto at ine-encode ang mga entity sa itaas bago isulat ang
file.

Ang detalye of kodigo
Hindi ito "Pagprograma 101 ", hindi rin ito "Perl para ang Medyo Dim". Ang code na
ipinasa sa pamamagitan ng isa sa mga "*.xpl" na file ay naipapasa sa "eval" nang walang pagbabago
(tingnan sa ibaba). Kaya, ang maling pagkakasulat o malisyosong code ay maaaring makapinsala sa iyo
server. Hindi ito kasalanan ng server code. Ang presyo ng flexibility ng system na ito
ang mga alok ay ang responsibilidad sa bahagi ng developer upang matiyak na ang code ay
sinubukan at ligtas.

Ang code mismo ay itinuturing bilang verbatim hangga't maaari. Ang ilang mga pag-edit ay maaaring mangyari sa server-side,
dahil ginagawa nitong angkop ang code para sa paglikha ng hindi kilalang subroutine mula sa. Ang gumawa_paraan
susubukan ng tool na gumamit ng seksyong "CDATA" upang i-embed ang code sa loob ng XML na dokumento, kaya
na hindi na kailangang mag-encode ng mga entity o katulad nito. Ito ay nagbibigay-daan para sa resulta *.xpl
file na syntax-testable na may "perl -cx". Maaari mong tulungan ito sa pamamagitan ng pagtiyak na ang code
ay hindi naglalaman ng alinman sa dalawang sumusunod na pagkakasunud-sunod ng character:

]]>

__DATA__

Ang una ay ang "CDATA" terminator. Kung natural itong nangyayari sa code, magti-trigger ito
ang end-of-section sa parser. Ang pangalawa ay ang pamilyar na Perl token, na ipinasok
upang ang natitira sa XML na dokumento ay hindi makalat sa Perl parser.

HALIMBAWA

Ang RPC::XML ang pamamahagi ay may ilang mga default na pamamaraan sa isang subdirectory na tinatawag
(cryptically enough) "mga pamamaraan". Ang bawat isa sa mga ito ay ipinahayag bilang isang set ng ("*.base",
"*.code", "*.help") na mga file. Kino-configure ng Makefile.PL file ang nagresultang Makefile tulad nito
na ang mga ito ay ginagamit upang lumikha ng "*.xpl" na mga file gamit ang tool na ito, at pagkatapos ay i-install ang mga ito.

DIAGNOSTICS

Karamihan sa mga problema ay lumalabas sa anyo ng mga mensahe ng error na sinusundan ng isang biglaang paglabas.

EXIT STATUS

Lalabas ang tool na may status na 0 kapag nagtagumpay, at 255 kung hindi.

MGA CAVEATS

Hindi ko masyadong gusto ang diskarteng ito sa pagtukoy ng mga pamamaraan, ngunit nagustuhan ko ang aking iba pang mga ideya kahit na
mas mababa.

Gumamit ng make_methodp online gamit ang mga serbisyo ng onworks.net