View of /trunk/xmlrpc/RPC/RPC-XML-0.25/README

    1 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.