make_methodp - 클라우드에서의 온라인

프로그램:

이름

make_method - Perl 코드를 RPC::XML::Server에 대한 XML 설명으로 변환합니다.

개요

make_method --name=system.identification --helptext='시스템 ID 문자열'
--서명=문자열 --code=ident.pl --output=ident.xpl

make_method --base=방법/식별

기술

이것은 수행할 메서드를 지정하기 위한 XML 설명 파일을 생성하는 간단한 도구입니다.
에 의해 출판됨 RPC::XML::서버기반 서버.

서버가 내보내는 메소드(또는 발행)는 다음의 일부입니다.
코드를 실행하면 이 도구가 필요하지 않습니다. 다만, 서버의 사정에 따라
코드(예: Apache 기반 RPC 서버)와 분리되고 구별되어야 합니다.
루틴과 지원 정보 작성은 번거로울 수 있습니다.

하나의 솔루션 RPC::XML::서버 패키지 제공은 게시 가능 항목을 로드하는 수단입니다.
외부 파일의 코드. 파일은 명확하게 설명하는 간단한 XML 방언으로 되어 있습니다.
외부에서 볼 수 있는 이름, 메소드 서명, 도움말 텍스트 및 코드 자체. 이것들
파일을 수동으로 만들거나 이 도구를 보조 도구로 사용할 수 있습니다.

필요한 인수

필수 인수는 없지만 전달된 옵션이 충분하지 않으면
오류 메시지로 알려줍니다.

옵션

이 도구는 다음 옵션을 인식합니다.

--도움
옵션에 대한 간략한 요약을 인쇄합니다.

--이름=STRING
인코딩 중인 메서드의 게시된 이름을 지정합니다. 이것이 그 이름이다.
서버의 클라이언트에게 표시됩니다.

--네임스페이스=STRING
XPL이 실행될 때 메소드의 코드가 평가될 네임스페이스를 지정합니다.
파일은 서버 인스턴스에 의해 로드됩니다.

--유형=STRING
결과 파일의 유형을 지정합니다. 여기서 "유형"은 컨테이너가
결과 XML에 사용되는 태그는 순서 또는 방법. 기본값은
방법. 문자열은 대소문자를 구분하지 않고 첫 번째 문자("m" 또는
"p")가 실제로 간주됩니다.

--버전=STRING
코드 루틴에 대한 버전 스탬프를 지정합니다.

--숨겨진
이것이 통과되면 결과 파일에는 서버 데몬에 알리는 태그가 포함됩니다.
인트로스펙션 인터페이스를 통해 루틴을 볼 수 없도록 합니다.

--signature=STRING [ --signature=STRING ... ]
메소드에 대해 하나 이상의 서명을 지정하십시오. 서명은 다음과 같은 유형 이름이어야 합니다.
RPC::XML 문서에 배치되어 있으며 요소는 콜론으로 구분되어 있습니다. 너
인수를 인용하는 경우 공백으로 구분할 수도 있습니다. 이 옵션은 다음과 같습니다.
일부 메서드에는 여러 개의 서명이 있을 수 있으므로 두 번 이상 지정되었습니다.

--helptext=STRING
명령줄에서 메서드에 대한 도움말 텍스트를 간단한 문자열로 지정합니다. 아니다
매우 긴 도움말 문자열에 적합합니다.

--helpfile=파일
지정된 파일에서 메소드에 대한 도움말 텍스트를 읽으십시오.

--코드=파일
지정된 파일에서 루틴의 실제 코드를 읽습니다. 이 옵션이 아닌 경우
주어진 경우 코드는 표준 입력 파일 설명자에서 읽혀집니다.

--출력=파일
결과 XML 표현을 지정된 파일에 씁니다. 이 옵션이 아닌 경우
주어진 경우 출력은 표준 출력 파일 설명자로 이동합니다.

--base=이름
이것은 특별한 "올인원" 옵션입니다. 전달되면 다른 모든 옵션은 무시됩니다.

값은 이름이 지정된 파일에서 정보를 읽기 위한 기본 요소로 사용됩니다.
BASE.베이스. 이 파일에는 이름, 버전, 숨겨진 상태,
서명 및 기타 방법 정보. 파일의 각 줄은 다음 중 하나와 같아야 합니다.
다음 :

이름: STRING
공개되는 루틴의 이름을 지정하십시오. 이 줄이 나타나지 않으면
다음의 값 --베이스 모든 디렉토리 요소가 제거된 인수는
익숙한.

버전 : STRING
함수에 대한 버전 스탬프를 제공하십시오. 이 패턴과 일치하는 라인이 없으면
현재 버전 태그가 기록되지 않습니다.

숨겨진: STRING
존재하는 경우, STRING "예" 또는 "아니요"여야 합니다(대소문자는 중요하지 않음). 그렇다면
"yes"이면 메서드가 모든 내부 검사 API에서 숨겨지도록 표시됩니다.

서명 : STRING
이 줄은 두 번 이상 나타날 수 있으며 누적되어 처리됩니다. 다른 옵션
이전 값이 두 번 이상 나타나는 경우 재정의합니다. 다음 부분은
"서명:" 부분은 메서드에 대해 게시된 서명으로 간주됩니다.
공백으로 구분된 요소입니다. 각 메서드에는 최소한 하나의 서명이 있어야 하므로
아무것도 없으면 오류가 발생합니다.

도움말 파일: STRING
도움말 텍스트를 읽을 파일을 지정합니다. 도움이 없으면 오류가 아닙니다.
텍스트가 지정됩니다.

코드파일: STRING
코드를 읽을 파일을 지정합니다. 코드는 Perl로 가정됩니다.
결과 파일에는 태그가 지정됩니다.

코드파일[언어]: 현
언어를 식별하면서 코드를 읽을 파일을 지정합니다.
코드가 들어있습니다. 이를 통해 XPL 포함하는 파일
주어진 방법이나 절차의 다중 언어 구현.

위의 패턴 이외의 라인은 무시됩니다.

코드를 읽지 않은 경우 도구는 오류 메시지와 함께 종료됩니다.

출력은 다음에 기록됩니다. BASE.xpl, 경로 정보를 보존하여
결과 파일은 소스 파일 바로 옆에 있습니다. 이를 통해 다음과 같은 구성이 가능합니다.

make_method --base=방법/내부 검사

FILE FORMAT 및 DTD

이러한 게시된 루틴의 파일 형식은 매우 간단한 XML 방언입니다. 이 적은
XML이 파서의 가용성보다 이상적인 형식이기 때문에
RPC::XML::서버 클래스의 코어에는 이미 파서 코드가 있습니다. 완전히 새로운 글을 쓰다
형식은 아무것도 얻지 못했을 것입니다.

형식에 대한 문서 유형 선언은 다음과 같이 요약할 수 있습니다.

<!ELEMENT 프로시저def(이름, 네임스페이스?, 버전?, 숨김?,
서명+, 도움말?, 코드)>
<!ELEMENT 메소드 정의(이름, 네임스페이스?, 버전?, 숨김?,
서명+, 도움말?, 코드)>
<!ELEMENT 함수 정의(이름, 네임스페이스?, 버전?, 숨김?,
서명+, 도움말?, 코드)>









배포판과 함께 제공되는 "rpc-method.dtd" 파일에는 추가로 몇 가지 설명이 있습니다.
실제 사양에 맞춰

파일은 (현재) 하나의 정의로 제한됩니다. 이것은 오프닝 중 하나로 시작됩니다
태그 " ", " " 또는 " ". 다음은 정확히 하나입니다.
" " 메서드 이름을 지정하는 컨테이너, 선택적 버전 스탬프, 선택적
Hide-from-introspection 플래그, 하나 이상의 " " 서명을 지정하는 컨테이너,
선택적 " " 컨테이너를 도움말 텍스트로 표시한 다음 " " container with the
실제 프로그램 코드 모든 텍스트는 기호에 대한 엔터티 인코딩을 사용해야 합니다.

& C<&>(앰퍼샌드)
이자형 C<<>(보다 작음)
이자형 C<>>(보다 큼)

서버 클래스 내의 구문 분석 프로세스는 엔터티를 디코딩합니다. 물건을 만들려면
더 쉽게, 도구는 모든 텍스트 요소를 스캔하고 위의 항목을 쓰기 전에 인코딩합니다.
파일.

XNUMXD덴탈의 스펙 of 암호
이 없습니다 "프로그램 작성 101 ", 그렇지도 않다 "펄 for 전에, 약간 어둑한". 코드는
"*.xpl" 파일 중 하나를 통해 전달되면 수정 없이 "eval"로 전달됩니다.
(아래 참조). 따라서 잘못 작성된 코드나 악성 코드는
섬기는 사람. 이는 서버 코드의 결함이 아닙니다. 이 시스템의 유연성 가격
제안은 코드가 다음과 같은지 확인하는 개발자 측의 책임입니다.
테스트를 거쳐 안전합니다.

코드 자체는 가능한 한 그대로 처리됩니다. 일부 편집은 서버 측에서 발생할 수 있습니다.
익명 서브루틴을 생성하는 데 적합한 코드를 만들기 때문입니다. 그만큼 make_method
도구는 "CDATA" 섹션을 사용하여 XML 문서 내에 코드를 삽입하려고 시도하므로
엔터티 등을 인코딩할 필요가 없습니다. 이는 결과를 허용합니다. *.xpl
"perl -cx"를 사용하여 구문 테스트가 가능한 파일입니다. 코드가 다음과 같은지 확인하면 도움이 될 수 있습니다.
다음 두 문자 시퀀스 중 하나를 포함하지 않습니다.

]]>

__데이터__

첫 번째는 "CDATA" 종결자입니다. 코드에서 자연스럽게 발생하면 트리거됩니다.
파서의 섹션 끝. 두 번째는 친숙한 Perl 토큰입니다.
XML 문서의 나머지 부분이 Perl 파서를 복잡하게 만들지 않도록 합니다.

사용 예

XNUMXD덴탈의 RPC::XML 배포판은 하위 디렉토리에 여러 기본 메서드와 함께 제공됩니다.
(암호적으로) "방법". 이들 각각은 ("*.base",
"*.code", "*.help") 파일. Makefile.PL 파일은 결과 Makefile을 다음과 같이 구성합니다.
이 도구를 사용하여 "*.xpl" 파일을 생성하고 설치하는 데 사용됩니다.

진단

대부분의 문제는 갑작스러운 종료가 뒤따르는 오류 메시지의 형태로 나타납니다.

EXIT 지위

도구는 성공 시 0 상태로 종료되고 그렇지 않으면 255 상태로 종료됩니다.

경고

나는 메서드를 지정하는 이 접근 방식을 별로 좋아하지 않지만, 다른 아이디어도 마음에 들었습니다.
적게.

onworks.net 서비스를 사용하여 온라인으로 make_methodp 사용