Parent Directory
| 
Revision Log
Revision 279 - (view) (download)
| 1 : | gage | 279 | RPC::XML - An implementation of XML-RPC |
| 2 : | |||
| 3 : | Version: 0.25 (initial release) | ||
| 4 : | |||
| 5 : | WHAT IS IT | ||
| 6 : | |||
| 7 : | The RPC::XML package is an implementation of XML-RPC. The module provides | ||
| 8 : | classes for sample client and server implementations, a server designed as an | ||
| 9 : | Apache location-handler, and a suite of data-manipulation classes that are | ||
| 10 : | used by them. | ||
| 11 : | |||
| 12 : | |||
| 13 : | USING RPC::XML | ||
| 14 : | |||
| 15 : | There are not any pre-packaged executables in this distribution (except for a | ||
| 16 : | utility tool). Client usage will usually be along the lines of: | ||
| 17 : | |||
| 18 : | use RPC::XML::Client; | ||
| 19 : | ... | ||
| 20 : | my $client = new RPC::XML::Client | ||
| 21 : | 'http://www.oreillynet.com/meerkat/xml-rpc/server.php'; | ||
| 22 : | my $req = RPC::XML::request->new('meerkat.getChannelsBySubstring', 'perl'); | ||
| 23 : | my $res = $client->send_request($req); | ||
| 24 : | # This returns an object of the RPC::XML::response class. This double-call | ||
| 25 : | # of value() first gets a RPC::XML::* data object from the response, then | ||
| 26 : | # the actual data from it: | ||
| 27 : | my $value = $res->value->value; | ||
| 28 : | |||
| 29 : | Running a simple server is not much more involved: | ||
| 30 : | |||
| 31 : | use RPC::XML::Server; | ||
| 32 : | ... | ||
| 33 : | my $srv = new RPC::XML::Server (host => 'localhost', | ||
| 34 : | port => 9000); | ||
| 35 : | # You would then use $srv->add_method to add some remotely-callable code | ||
| 36 : | ... | ||
| 37 : | $srv->accept_loop; # Stays in an accept/connect loop | ||
| 38 : | |||
| 39 : | |||
| 40 : | BUILDING/INSTALLING | ||
| 41 : | |||
| 42 : | This package is set up to configure and build like a typical Perl extension. | ||
| 43 : | To build: | ||
| 44 : | |||
| 45 : | perl Makefile.PL | ||
| 46 : | make && make test | ||
| 47 : | |||
| 48 : | If RPC::XML passes all tests, then: | ||
| 49 : | |||
| 50 : | make install | ||
| 51 : | |||
| 52 : | You may need super-user access to install. | ||
| 53 : | |||
| 54 : | |||
| 55 : | PROBLEMS/BUG REPORTS | ||
| 56 : | |||
| 57 : | Please send any reports of problems or bugs to rjray@blackperl.com | ||
| 58 : | |||
| 59 : | |||
| 60 : | SEE ALSO | ||
| 61 : | |||
| 62 : | XML-RPC: http://www.xmlrpc.com/spec | ||
| 63 : | The Artistic License: http://language.perl.com/misc/Artistic.html | ||
| 64 : | |||
| 65 : | |||
| 66 : | CHANGES | ||
| 67 : | |||
| 68 : | This is the initial release. Everything changed at least once. |
| aubreyja at gmail dot com | ViewVC Help |
| Powered by ViewVC 1.0.9 |