Pod::WSDL

Pod::WSDL is a Perl module that creates WSDL documents from (extended) pod.
Download

Pod::WSDL Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • Tarek Ahmed
  • Publisher web site:
  • http://search.cpan.org/~tareka/Pod-WSDL-0.05/lib/Pod/WSDL/Doc.pm

Pod::WSDL Tags


Pod::WSDL Description

Pod::WSDL is a Perl module that creates WSDL documents from (extended) pod. Pod::WSDL is a Perl module that creates WSDL documents from (extended) pod.SYNOPSIS use Pod::WSDL; my $pod = new Pod::WSDL(source => 'My::Server', location => 'http://localhost/My/Server', pretty => 1, withDocumentation => 1); print $pod->WSDL;Parsing the podHow does Pod::WSDL work? If you instantiate a Pod::WSDL object with the name of the module (or the path of the file, or an open filehandle) providing the web service like this my $pwsdl = new Pod::WSDL(source => 'My::Module', location => 'http://my.services.location/on/the/web');Pod::WSDL will try to find My::Module in @INC, open the file, parse it for WSDL directives and prepare the information for WSDL output. By calling $pwsdl->WSDL;Pod::WSDL will output the WSDL document. That's it.When using Pod::WSDL, the parser expects you to do the following:Put the pod directly above the subroutines which the web service's client is going to call. There may be whitespace between the pod and the sub declaration but nothing else.Use the =begin/=end respectively the =for directives according to standard pod: anything between =begin WSDL and =end will be treated as pod. Anything composing a paragraph together with =for WSDL will be treated as pod.Any subroutine not preceeded by WSDL pod will be left unmentioned. Any standard pod will be ignored (though, for an exception to this, see the section on own complex types below).The individual instructions for Pod::WSDL always begin with a keyword, like _RETURN or _DOC or _FAULT. After this different things may follow, according to the specific type of instruction. The instruction may take one or more lines - everything up to the next line beginning with a keyword or the end of the pod is belonging to the current instruction.Describing MethodsHow do we use Pod::WSDL? In describing a web service's method we have to say something about parameters, return values and faults. In addition you might want to add some documentation to these items and to the method itself. Requirements: · Perl


Pod::WSDL Related Software