RPC::XML::Parser::XMLLibXML (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/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

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 suite), external entities whose 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 <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

*

RT: CPAN

's request tracker

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

*

AnnoCPAN: Annotated

CPAN

documentation

<annocpan.org/dist/RPC-XML>

*

CPAN

Ratings

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

*

Search

CPAN

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

*

MetaCPAN

<metacpan.org/release/RPC-XML>

*

Source code on GitHub

<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 (<www.opensource.org/licenses/artistic-license-2.0.php>) or the

(<www.opensource.org/licenses/lgpl-2.1.php>).

CREDITS

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

SEE ALSO

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

AUTHOR

Randy J. Ray <rjray@blackperl.com>