make_methodp - Bulutta Çevrimiçi

Program:

ADI

make_method - Perl kodunu RPC::XML::Server için bir XML açıklamasına dönüştürün

SİNOPSİS

make_method --name=system.identification --helptext='Sistem Kimliği dizesi'
--signature=string --code=ident.pl --output=ident.xpl

make_method --base=yöntemler/tanımlama

TANIM

Bu, kullanılacak yöntemleri belirtmek için XML tanımlayıcı dosyaları oluşturmak için basit bir araçtır.
tarafından yayınlanan RPC::XML::Sunucutabanlı sunucu.

Bir sunucu, dışa aktardığı yöntemler (veya yayınlar) bir parçasıdır
çalışan kod, o zaman bu araca gerek yoktur. Ancak, sunucunun
belirterek, koddan (Apache tabanlı bir RPC sunucusu gibi) ayrı ve farklı olmalıdır.
rutinler ve destekleyici bilgileri doldurmak zahmetli olabilir.

Bir çözüm ki RPC::XML::Sunucu paket teklifleri, yayınlanabilir yükleme aracıdır
harici bir dosyadan kod. Dosya, içeriği açıkça tanımlayan basit bir XML lehçesindedir.
dışarıdan görünen ad, yöntem imzaları, yardım metni ve kodun kendisi. Bunlar
dosyalar manuel olarak oluşturulabilir veya bu araç yardımcı olarak kullanılabilir.

GEREKLİ ARGÜMANLAR

Gerekli argüman yoktur, ancak yeterli seçenek geçmediyse,
bir hata mesajı ile bildirilmelidir.

SEÇENEKLER

Araç aşağıdaki seçenekleri tanır:

--yardım et
Seçeneklerin kısa bir özetini yazdırır.

--isim=STRING
Kodlanan yöntemin yayınlanan adını belirtir. Bu, onun adı
sunucunun istemcileri tarafından görülebilir.

--namespace=STRING
XPL kullanıldığında, yöntemin kodunun değerlendirileceği bir ad alanını belirtir.
dosya bir sunucu örneği tarafından yüklenir.

--type=STRING
Ortaya çıkan dosyanın türünü belirtin. Buradaki "Tip", kapsayıcının olup olmadığını ifade eder.
sonuçtaki XML'de kullanılan etiket, bir prosedür ya da yöntem. Varsayılan,
yöntem. Dize büyük/küçük harften bağımsız olarak ele alınır ve yalnızca ilk karakter ("m" veya
"p") aslında kabul edilir.

--versiyon=STRING
Kod rutini için bir sürüm damgası belirtin.

--gizlenmiş
Bu başarılı ise, ortaya çıkan dosya, sunucu arka plan programına bildiren bir etiket içerecektir.
rutini herhangi bir iç gözlem arayüzü aracılığıyla görünür kılmamak.

--signature=STRING [ --signature=STRING ... ]
Yöntem için bir veya daha fazla imza belirtin. İmzalar tür adları olmalıdır
RPC::XML'deki belgelerde iki nokta üst üste ile ayrılmış öğelerle düzenlenmiştir. Sen
argümanı alıntılarsanız, bunları boşluklarla da ayırabilirsiniz. Bu seçenek olabilir
birden fazla belirtilmiş, çünkü bazı metotlar birkaç imzaya sahip olabilir.

--helptext=STRING
Yöntem için yardım metnini komut satırında basit bir dize olarak belirtin. Olumsuz
çok uzun yardım dizileri için uygundur.

--helpfile=DOSYA
Belirtilen dosyadan yöntem için yardım metnini okuyun.

--code=DOSYA
Belirtilen dosyadan rutinin gerçek kodunu okuyun. Bu seçenek değilse
verilen kod, standart girdi dosyası tanımlayıcısından okunur.

--çıktı=DOSYA
Ortaya çıkan XML temsilini belirtilen dosyaya yazın. Bu seçenek değilse
verildiğinde, çıktı standart çıktı dosyası tanımlayıcısına gider.

--base=AD
Bu, özel bir "hepsi bir arada" seçeneğidir. Geçilirse, diğer tüm seçenekler yoksayılır.

Değer, adlı bir dosyadan bilgi okumak için temel öğe olarak kullanılır.
TABAN.temel. Bu dosya, ad, sürüm, gizli durum bilgilerini içerecektir.
imzalar ve diğer yöntem bilgileri. Dosyanın her satırı şunlardan biri gibi görünmelidir
şu:

Adınız: STRING
Yayınlanmakta olan rutinin adını belirtin. Bu satır görünmezse,
o zaman değeri --temel tüm dizin öğelerinin kaldırıldığı argüman
Kullanılmış.

Sürüm: STRING
İşlev için bir sürüm damgası sağlayın. Bu desenle eşleşen satır yoksa
mevcutsa, hiçbir sürüm etiketi yazılmaz.

Gizli: STRING
Varsa, STRING "evet" veya "hayır" olmalıdır (büyük/küçük harf önemli değil). Eğer öyleyse
"evet", ardından yöntem herhangi bir iç gözlem API'sinden gizlenecek şekilde işaretlenir.

İmza: STRING
Bu çizgi birden fazla görünebilir ve kümülatif olarak işlenir. Diğer seçenekler
birden fazla görünüyorlarsa önceki değerleri geçersiz kılar. Aşağıdaki kısım
"İmza:" kısmı, yöntem için yayınlanmış bir imza olarak alınır,
boşlukla ayrılmış öğeler. Her yöntemin en az bir imzası olmalıdır, bu nedenle
herhangi birinin olmaması bir hataya neden olur.

Yardım dosyası: STRING
Yardım metninin okunacağı dosyayı belirtir. Yardım yoksa hata değildir
metin belirtilir.

Kod dosyası: STRING
Kodun okunacağı dosyayı belirtir. Kodun Perl olduğu varsayılır ve
sonuçtaki dosyada bu şekilde etiketlenecektir.

Kod dosyası[lang]: dizi
Kodun okunacağı dosyayı belirtirken aynı zamanda dili de tanımlar.
kodun içinde olduğunu. Bu, bir Ç.N. içeren dosya
verilen yöntem veya prosedürün çoklu dil uygulamaları.

Yukarıdaki kalıplar dışındaki tüm satırlar yok sayılır.

Herhangi bir kod okunmamışsa, araç bir hata mesajıyla çıkacaktır.

çıktıya yazılır TABAN.xpl, yol bilgilerini koruyarak
sonuçta ortaya çıkan dosya, kaynak dosyaların hemen yanındadır. Bu, aşağıdaki gibi yapılara izin verir:

make_method --base=yöntemler/iç gözlem

DOSYA FORMAT VE DTD

Bu yayınlanan rutinler için dosya formatı çok basit bir XML lehçesidir. bu daha az
XML'in ideal bir format olması nedeniyle, ayrıştırıcının kullanılabilirliği olduğundan,
RPC::XML::Sunucu sınıf zaten çekirdekte ayrıştırıcı koduna sahip olacak. Tamamen yeni yazmak
format hiçbir şey kazandırmazdı.

Format için Belge Türü Beyanı şu şekilde özetlenebilir:

<!ELEMENT prosedürdef (ad, ad alanı?, sürüm?, gizli?,
imza+, yardım?, kod)>
<!ELEMENT methoddef (ad, ad alanı?, sürüm?, gizli?,
imza+, yardım?, kod)>
<!ELEMENT functiondef (ad, ad alanı?, sürüm?, gizli?,
imza+, yardım?, kod)>









Dağıtımla birlikte gelen "rpc-method.dtd" dosyası ek olarak bazı açıklamalara sahiptir.
gerçek şartnameye.

Bir dosya (şimdilik) bir tanımla sınırlıdır. Bu, açılışlardan biri tarafından başlatılır.
etiketler " ", " " veya " ". Bunu tam olarak bir tane takip eder.
" " yöntem adını, isteğe bağlı bir sürüm damgasını, isteğe bağlı bir
iç gözlemden saklanma bayrağı, bir veya daha fazla " " imzaları belirten kapsayıcılar,
isteğe bağlı" " yardım metnini içeren kapsayıcı, ardından " " container with the
gerçek program kodu Tüm metinler, semboller için varlık kodlamasını kullanmalıdır:

& C<&> (ve işareti)
E C<<> (küçüktür)
E C<>> (büyüktür)

Sunucu sınıfı içindeki ayrıştırma işlemi, varlıkların kodunu çözecektir. şeyler yapmak
daha kolay, araç tüm metin öğelerini tarar ve metni yazmadan önce yukarıdaki varlıkları kodlar.
dosyası.

The Özellikler of Kod
Bu değil "Programlama 101 ", Ne de "Perl için the Biraz karart". olduğu kod
"*.xpl" dosyalarından biri aracılığıyla iletilen, hiçbir değişiklik yapılmadan "değerlendirme"ye aktarılır
(aşağıya bakınız). Bu nedenle, kötü yazılmış veya kötü niyetli kodlar, bilgisayarınıza çok iyi zarar verebilir.
sunucu. Bu, sunucu kodunun hatası değildir. Bu sistemin esnekliğinin bedeli
teklifler, kodun eksiksiz olduğundan emin olmak için geliştiricinin sorumluluğundadır.
test edilmiş ve güvenli.

Kodun kendisi mümkün olduğunca kelimesi kelimesine ele alınır. Sunucu tarafında bazı düzenlemeler olabilir,
kodu anonim bir alt yordam oluşturmaya uygun hale getirdiği için. NS make_method
araç, kodu XML belgesine gömmek için bir "CDATA" bölümü kullanmayı deneyecektir, bu nedenle
varlıkları veya benzerlerini kodlamaya gerek yoktur. Bu, sonucun elde edilmesini sağlar *.xpl
dosyaların "perl -cx" ile sözdizimi açısından test edilebilir olması. Kodun doğru olduğundan emin olarak buna yardımcı olabilirsiniz.
aşağıdaki iki karakter dizisinden birini içermez:

]]>

__VERİ__

Birincisi "CDATA" sonlandırıcıdır. Kodda doğal olarak meydana gelirse, tetiklenir
ayrıştırıcıdaki bölümün sonu. İkincisi, eklenen tanıdık Perl belirtecidir.
böylece XML belgesinin geri kalanı Perl ayrıştırıcısını karıştırmaz.

ÖRNEKLER

The RPC::XML dağıtım adlı bir alt dizinde bir dizi varsayılan yöntemle birlikte gelir.
(şifreli olarak yeterince) "yöntemler". Bunların her biri ("*.base",
"*.code", "*.help") dosyaları. Makefile.PL dosyası, elde edilen Makefile'ı aşağıdaki gibi yapılandırır:
bunların, bu aracı kullanarak "*.xpl" dosyaları oluşturmak için kullanıldığını ve ardından bunları yükleyin.

TANI

Çoğu sorun, hata mesajları ve ardından ani bir çıkış şeklinde ortaya çıkar.

EXIT DURUMU

Araç, başarı durumunda 0, aksi takdirde 255 durumuyla çıkar.

UYARILAR

Yöntemleri belirtmek için bu yaklaşımı pek sevmiyorum, ancak diğer fikirlerimi bile sevdim.
az.

onworks.net hizmetlerini kullanarak make_methodp'u çevrimiçi kullanın