xml-rpc-api2cpp(1) [debian man page]

XML-RPC-API2CPP(1)					      General Commands Manual						XML-RPC-API2CPP(1)

NAME

       xml-rpc-api2cpp - Make a C++ wrapper class for an XML-RPC API

SYNOPSIS

       xml-rpc-api2cpp server-url remote-method-prefix c++-class-name

DESCRIPTION

       xml-rpc-api2cpp queries an XML-RPC server using the XML-RPC Instrospection API designed by Edd Dumbill.	It then prints a C++ wrapper class
       to standard output.  This class can be used with xmlrpc-c's C++ API.

       You can find a list of supported XML-RPC server libraries (and patches for many others) at http://xmlrpc-c.sourceforge.net/hacks.php.

OPTIONS

       server-url
	      The name of the server to query.	Try http://xmlrpc-c.sourceforge.net/cgi-bin/interop.cgi.

       remote-method-prefix
	      The prefix of the methods to wrap.  For example, to wrap all the system.* calls, you could specify "system".

       c++-class-name
	      The name of the C++ class to generate.  Try "SystemProxy".

BUGS

       xml-rpc-api2cpp can't talk to certain PHP servers based on Edd Dumbill's PHP library, because the trailing bytes of the XML-RPC message get
       truncated in HTTP pipelining mode.  It's not clear whether this is a PHP, Apache or w3c-libwww bug.

       xml-rpc-api2cpp assumes that method descriptions are ASCII text, not HTML as specified in the standard.	(In practice, both conventions are
       often seen.)  It may also get unhappy if method descriptions contain "*/".

       In general, error messages and diagnostics are still fairly poor.

SEE ALSO

       xmlrpc-c(7), xml-rpc-api2txt(1).

       This program is part of xmlrpc-c.

AUTHOR

       This manual page was written by Eric Kidd <eric.kidd@pobox.com>.  It may be distributed under the same terms as the rest of xmlrpc-c.

								   June 27, 2001						XML-RPC-API2CPP(1)

RPC::XML::Parser::XMLLibXML(3pm)			User Contributed Perl Documentation			  RPC::XML::Parser::XMLLibXML(3pm)

NAME

       RPC::XML::Parser::XMLLibXML - A container class for XML::LibXML

SYNOPSIS

	   # This class should rarely (if ever) be used directly:

	   use RPC::XML::ParserFactory 'XML::LibXML';
	   ...
	   $P = RPC::XML::ParserFactory->new();
	   $P->parse($message);

DESCRIPTION

       This class implements the interface defined in the RPC::XML::Parser factory-class (see RPC::XML::Parser) using the XML::LibXML module to
       handle the actual manipulation of XML.

SUBROUTINES
/METHODS
       This module implements the public-facing methods as described in RPC::XML::Parser:

       new [ ARGS ]
	   The constructor only recognizes the two parameters specified in the base class (for the RPC::XML::base64 file-spooling operations).

       parse [ STRING | STREAM ]
	   The parse() method accepts either a string of XML, a filehandle of some sort, or no argument at all. In the latter case, the return
	   value is a parser instance that acts as a push-parser (a non-blocking parser). For the first two types of input, the return value is
	   either a message object (one of RPC::XML::request or RPC::XML::response) or an error.

       parse_more STRING
	   (Only callable on a push-parser instance) Parses the chunk of XML, which does not have to describe a complete document, and adds it to
	   the current running document. If this method is called on a parser instance that is not a push-parser, an exception is thrown.

       parse_done
	   (Only callable on a push-parser instance) Finishes the parsing process and returns either a message object (one of RPC::XML::request or
	   RPC::XML::response) or an error (if the document was incomplete, not well-formed, or not valid). If this method is called on a parser
	   instance that is not a push-parser, an exception is thrown.

DIAGNOSTICS

       All methods return some type of reference on success. The new and parse methods return an error string on failure. The parse_more and
       parse_done methods may throw exceptions, if the underlying XML::LibXML parser encounters a fatal error.

EXTERNAL ENTITIES

       As of version 1.15 of this module (version 0.75 of the RPC::XML suite), external entities whose URI is a "file:/" scheme (local file) are
       explicitly ignored. This is for security purposes.

BUGS

       Please report any bugs or feature requests to "bug-rpc-xml at rt.cpan.org", or through the web interface at
       http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RPC-XML <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RPC-XML>. I will be notified, and
       then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

       o   RT: CPAN's request tracker

	   http://rt.cpan.org/NoAuth/Bugs.html?Dist=RPC-XML <http://rt.cpan.org/NoAuth/Bugs.html?Dist=RPC-XML>

       o   AnnoCPAN: Annotated CPAN documentation

	   http://annocpan.org/dist/RPC-XML <http://annocpan.org/dist/RPC-XML>

       o   CPAN Ratings

	   http://cpanratings.perl.org/d/RPC-XML <http://cpanratings.perl.org/d/RPC-XML>

       o   Search CPAN

	   http://search.cpan.org/dist/RPC-XML <http://search.cpan.org/dist/RPC-XML>

       o   MetaCPAN

	   https://metacpan.org/release/RPC-XML <https://metacpan.org/release/RPC-XML>

       o   Source code on GitHub

	   http://github.com/rjray/rpc-xml <http://github.com/rjray/rpc-xml>

LICENSE AND COPYRIGHT

       This file and the code within are copyright (c) 2011 by Randy J. Ray.

       Copying and distribution are permitted under the terms of the Artistic License 2.0
       (http://www.opensource.org/licenses/artistic-license-2.0.php <http://www.opensource.org/licenses/artistic-license-2.0.php>) or the GNU LGPL
       2.1 (http://www.opensource.org/licenses/lgpl-2.1.php <http://www.opensource.org/licenses/lgpl-2.1.php>).

CREDITS

       The XML-RPC standard is Copyright (c) 1998-2001, UserLand Software, Inc.  See <http://www.xmlrpc.com> for more information about the XML-
       RPC specification.

SEE ALSO

       RPC::XML, RPC::XML::Parser, XML::LibXML

AUTHOR

       Randy J. Ray <rjray@blackperl.com>

perl v5.14.2							    2011-07-23					  RPC::XML::Parser::XMLLibXML(3pm)