make_methodp - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

make_method - Biến mã Perl thành mô tả XML cho RPC :: XML :: Server

SYNOPSIS

make_method --name = system.identification --helptext = 'Chuỗi ID hệ thống'
--signature = string --code = Id.pl --output = Id.xpl

make_method --base = các phương pháp / nhận dạng

MÔ TẢ

Đây là một công cụ đơn giản để tạo các tệp mô tả XML để chỉ định các phương thức
được xuất bản bởi một RPC :: XML :: Máy chủ-dựa trên máy chủ.

Nếu một máy chủ được viết sao cho các phương thức nó xuất ra (hoặc xuất bản) là một phần của
chạy mã, thì không cần công cụ này. Tuy nhiên, trong trường hợp máy chủ có thể
tách biệt và khác biệt với mã (chẳng hạn như máy chủ RPC dựa trên Apache), chỉ định
các quy trình và điền thông tin hỗ trợ có thể rườm rà.

Một giải pháp mà RPC :: XML :: Máy chủ gói cung cấp là phương tiện để tải có thể xuất bản
mã từ một tệp bên ngoài. Tệp ở dạng phương ngữ XML đơn giản phân định rõ ràng
tên hiển thị bên ngoài, chữ ký phương thức, văn bản trợ giúp và chính mã. Này
tệp có thể được tạo theo cách thủ công hoặc công cụ này có thể được sử dụng như một công cụ hỗ trợ.

YÊU CẦU TRANH LUẬN

Không có đối số bắt buộc, nhưng nếu không có đủ tùy chọn được chuyển, bạn sẽ
được thông báo bởi một thông báo lỗi.

LỰA CHỌN

Công cụ nhận dạng các tùy chọn sau:

--Cứu giúp
In một bản tóm tắt ngắn về các tùy chọn.

--name = STRING
Chỉ định tên đã xuất bản của phương thức được mã hóa. Đây là tên mà nó
sẽ được hiển thị cho các khách hàng của máy chủ.

- không gian tên = STRING
Chỉ định một không gian tên mà mã của phương thức sẽ được đánh giá, khi XPL
tệp được tải bởi một phiên bản máy chủ.

--type = STRING
Chỉ định loại cho tệp kết quả. "Loại" ở đây đề cập đến việc liệu vùng chứa
được sử dụng trong XML kết quả sẽ chỉ định một thủ tục hoặc một phương pháp. Mặc định là
phương pháp. Chuỗi được xử lý không phân biệt chữ hoa chữ thường và chỉ ký tự đầu tiên ("m" hoặc
"p") thực sự được coi là.

--version = STRING
Chỉ định một tem phiên bản cho quy trình mã.

--ẩn giấu
Nếu điều này được thông qua, tệp kết quả sẽ bao gồm một thẻ thông báo cho daemon máy chủ
để không làm cho quy trình hiển thị thông qua bất kỳ giao diện nội quan nào.

--signature = STRING [--signature = STRING ...]
Chỉ định một hoặc nhiều chữ ký cho phương thức. Chữ ký phải là tên loại như
được trình bày trong tài liệu bằng RPC :: XML, với các phần tử được phân tách bằng dấu hai chấm. Bạn
cũng có thể ngăn cách chúng bằng dấu cách, nếu bạn trích dẫn đối số. Tùy chọn này có thể là
được chỉ định nhiều hơn một lần, vì một số phương thức có thể có nhiều chữ ký.

--helptext = STRING
Chỉ định văn bản trợ giúp cho phương thức dưới dạng một chuỗi đơn giản trên dòng lệnh. Không
phù hợp với các chuỗi trợ giúp dài khủng khiếp.

--helpfile = FILE
Đọc văn bản trợ giúp cho phương thức từ tệp được chỉ định.

--code = FILE
Đọc mã thực tế cho quy trình từ tệp được chỉ định. Nếu tùy chọn này không
đã cho, mã được đọc từ bộ mô tả tệp đầu vào tiêu chuẩn.

--output = FILE
Viết biểu diễn XML kết quả vào tệp được chỉ định. Nếu tùy chọn này không
cho trước, sau đó đầu ra chuyển đến bộ mô tả tệp đầu ra tiêu chuẩn.

--base = NAME
Đây là một tùy chọn đặc biệt, "tất cả trong một". Nếu được thông qua, tất cả các tùy chọn khác sẽ bị bỏ qua.

Giá trị được sử dụng làm phần tử cơ sở để đọc thông tin từ tệp có tên
CƠ SỞ.cơ sở. Tệp này sẽ chứa thông số kỹ thuật về tên, phiên bản, trạng thái ẩn,
chữ ký và thông tin phương pháp khác. Mỗi dòng của tệp phải giống như một trong các dòng
sau đây:

Tên: STRING
Chỉ định tên của quy trình đang được xuất bản. Nếu dòng này không xuất hiện,
thì giá trị của --cơ sở đối số với tất cả các phần tử thư mục bị xóa sẽ là
đã sử dụng.

Phiên bản: STRING
Cung cấp tem phiên bản cho chức năng. Nếu không có dòng nào phù hợp với mẫu này là
hiện tại, không có thẻ phiên bản nào sẽ được viết.

Ẩn: STRING
Nếu có, STRING phải là "có" hoặc "không" (trường hợp không quan trọng). Nếu nó là
"có", thì phương thức được đánh dấu là ẩn khỏi bất kỳ API nội quan nào.

Chữ ký: STRING
Dòng này có thể xuất hiện nhiều lần và được xử lý tích lũy. Sự lựa chọn khác
ghi đè các giá trị trước đó nếu chúng xuất hiện nhiều lần. Phần sau
Phần "Chữ ký:" được coi là chữ ký được công bố cho phương pháp, với
các phần tử được phân tách bằng khoảng trắng. Mỗi phương thức phải có ít nhất một chữ ký, vì vậy
thiếu bất kỳ sẽ gây ra lỗi.

Hồ sơ trợ giúp: STRING
Chỉ định tệp để đọc văn bản trợ giúp. Nó không phải là một lỗi nếu không có sự giúp đỡ
văn bản được chỉ định.

tệp mã: STRING
Chỉ định tệp để đọc mã từ đó. Mã được giả định là Perl, và
sẽ được gắn thẻ như vậy trong tệp kết quả.

Codefile [lang]: chuỗi
Chỉ định tệp để đọc mã, đồng thời xác định ngôn ngữ
mà mã đang ở trong đó. Điều này cho phép tạo ra một XPL tệp bao gồm
triển khai nhiều ngôn ngữ của phương pháp hoặc thủ tục đã cho.

Bất kỳ dòng nào khác với các mẫu trên đều bị bỏ qua.

Nếu không có mã nào được đọc, thì công cụ sẽ thoát ra với một thông báo lỗi.

Đầu ra được ghi vào CƠ SỞ.xpl, duy trì thông tin đường dẫn để
tệp kết quả nằm ngay bên cạnh các tệp nguồn. Điều này cho phép các cấu trúc như:

make_method --base = method / introspection

FILE FORMAT VÀ DTD

Định dạng tệp cho các quy trình đã xuất bản này là một phương ngữ XML rất đơn giản. Điều này ít hơn
do XML là một định dạng lý tưởng hơn là tính khả dụng của trình phân tích cú pháp, cho rằng
RPC :: XML :: Máy chủ lớp sẽ có mã phân tích cú pháp trong lõi. Viết một hoàn toàn mới
định dạng sẽ không đạt được bất cứ điều gì.

Tuyên bố loại tài liệu cho định dạng có thể được tóm tắt bằng:

<!ELEMENT proceduredef (name, namespace?, version?, hidden?,
chữ ký +, trợ giúp ?, mã)>
<!ELEMENT methoddef (name, namespace?, version?, hidden?,
chữ ký +, trợ giúp ?, mã)>
<!ELEMENT functiondef (name, namespace?, version?, hidden?,
chữ ký +, trợ giúp ?, mã)>









Tệp "rpc-method.dtd" đi kèm với bản phân phối có thêm một số chú thích
với đặc điểm kỹ thuật thực tế.

Một tệp (hiện tại) bị giới hạn ở một định nghĩa. Điều này được bắt đầu bởi một trong những phần mở đầu
thẻ " "," " hoặc " ". Tiếp theo là một
" "vùng chứa chỉ định tên phương pháp, tem phiên bản tùy chọn, tùy chọn
cờ ẩn, một hoặc nhiều " "vùng chứa chỉ định chữ ký,
một tùy chọn " "vùng chứa với văn bản trợ giúp, sau đó là vùng " container with the
mã chương trình thực tế. Tất cả văn bản phải sử dụng mã hóa thực thể cho các ký hiệu:

& C <&> (dấu và)
E C <<> (nhỏ hơn)
E C <>> (lớn hơn)

Quá trình phân tích cú pháp trong lớp máy chủ sẽ giải mã các thực thể. Để làm ra những thứ
dễ dàng hơn, công cụ quét tất cả các phần tử văn bản và mã hóa các thực thể trên trước khi viết
tập tin.

Sản phẩm Đặc điểm kỹ thuật of Mã
Đây không phải là "Lập trình 101 ", Cũng không phải là nó "Perl cho các Hơi Lờ mờ". Mã đó là
được chuyển qua một trong các tệp "* .xpl" được chuyển đến "eval" mà không có sửa đổi nào
(xem bên dưới). Do đó, mã độc hoặc viết xấu rất có thể tàn phá
người phục vụ. Đây không phải là lỗi của mã máy chủ. Giá của sự linh hoạt của hệ thống này
ưu đãi là trách nhiệm từ phía nhà phát triển để đảm bảo rằng mã
đã được thử nghiệm và an toàn.

Bản thân mã được coi là nguyên văn nhất có thể. Một số chỉnh sửa có thể xảy ra ở phía máy chủ,
vì nó làm cho mã phù hợp để tạo một chương trình con ẩn danh từ. Các phương thức make_
công cụ sẽ cố gắng sử dụng phần "CDATA" để nhúng mã vào tài liệu XML, vì vậy
rằng không cần phải mã hóa các thực thể hoặc như vậy. Điều này cho phép kết quả * .xpl
các tệp có thể kiểm tra cú pháp bằng "perl -cx". Bạn có thể hỗ trợ điều này bằng cách đảm bảo rằng mã
không chứa một trong hai chuỗi ký tự sau:

]]>

__DỮ LIỆU__

Đầu tiên là trình kết thúc "CDATA". Nếu nó xuất hiện tự nhiên trong mã, nó sẽ kích hoạt
cuối phần trong trình phân tích cú pháp. Thứ hai là mã thông báo Perl quen thuộc, được chèn
để phần còn lại của tài liệu XML không làm lộn xộn bộ phân tích cú pháp Perl.

VÍ DỤ

Sản phẩm RPC :: XML phân phối đi kèm với một số phương thức mặc định trong một thư mục con được gọi là
(đủ khó hiểu) "phương pháp". Mỗi trong số này được biểu thị dưới dạng một tập hợp ("* .base",
tệp "* .code", "* .help"). Tệp Makefile.PL định cấu hình Makefile kết quả như vậy
chúng được sử dụng để tạo tệp "* .xpl" bằng công cụ này, sau đó cài đặt chúng.

CHẨN ĐOÁN

Hầu hết các vấn đề xuất hiện dưới dạng thông báo lỗi sau đó là thoát đột ngột.

EXIT TÌNH TRẠNG

Công cụ thoát với trạng thái 0 khi thành công và 255 nếu không.

THẬN TRỌNG

Tôi không thích cách tiếp cận này để chỉ định các phương pháp, nhưng tôi thậm chí còn thích những ý tưởng khác của mình
ít hơn.

Sử dụng make_methodp trực tuyến bằng các dịch vụ onworks.net