1RPC::XML::Parser::XMLPaUrsseerr(C3o)ntributed Perl DocumRePnCt:a:tXiMoLn::Parser::XMLParser(3)
2
3
4
6 RPC::XML::Parser::XMLParser - A container class for XML::Parser
7
9 # This class should rarely (if ever) be used directly:
10
11 use RPC::XML::ParserFactory 'XML::Parser';
12 ...
13 $P = RPC::XML::ParserFactory->new();
14 $P->parse($message);
15
17 This class implements the interface defined in the RPC::XML::Parser
18 factory-class (see RPC::XML::Parser) using the XML::Parser module to
19 handle the actual manipulation of XML.
20
22 This module implements the public-facing methods as described in
23 RPC::XML::Parser:
24
25 new [ ARGS ]
26 The constructor only recognizes the two parameters specified in the
27 base class (for the RPC::XML::base64 file-spooling operations).
28
29 parse [ STRING | STREAM ]
30 The parse() method accepts either a string of XML, a filehandle of
31 some sort, or no argument at all. In the latter case, the return
32 value is a parser instance that acts as a push-parser (a non-
33 blocking parser). For the first two types of input, the return
34 value is either a message object (one of RPC::XML::request or
35 RPC::XML::response) or an error.
36
37 parse_more STRING
38 (Only callable on a push-parser instance) Parses the chunk of XML,
39 which does not have to describe a complete document, and adds it to
40 the current running document. If this method is called on a parser
41 instance that is not a push-parser, an exception is thrown.
42
43 parse_done
44 (Only callable on a push-parser instance) Finishes the parsing
45 process and returns either a message object (one of
46 RPC::XML::request or RPC::XML::response) or an error (if the
47 document was incomplete, not wel-formed, or not valid). If this
48 method is called on a parser instance that is not a push-parser, an
49 exception is thrown.
50
52 Please report any bugs or feature requests to "bug-rpc-xml at
53 rt.cpan.org", or through the web interface at
54 http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RPC-XML
55 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RPC-XML>. I will be
56 notified, and then you'll automatically be notified of progress on your
57 bug as I make changes.
58
60 · RT: CPAN's request tracker
61
62 http://rt.cpan.org/NoAuth/Bugs.html?Dist=RPC-XML
63 <http://rt.cpan.org/NoAuth/Bugs.html?Dist=RPC-XML>
64
65 · AnnoCPAN: Annotated CPAN documentation
66
67 http://annocpan.org/dist/RPC-XML <http://annocpan.org/dist/RPC-XML>
68
69 · CPAN Ratings
70
71 http://cpanratings.perl.org/d/RPC-XML
72 <http://cpanratings.perl.org/d/RPC-XML>
73
74 · Search CPAN
75
76 http://search.cpan.org/dist/RPC-XML
77 <http://search.cpan.org/dist/RPC-XML>
78
79 · Source code on GitHub
80
81 http://github.com/rjray/rpc-xml/tree/master
82 <http://github.com/rjray/rpc-xml/tree/master>
83
85 This file and the code within are copyright (c) 2009 by Randy J. Ray.
86
87 Copying and distribution are permitted under the terms of the Artistic
88 License 2.0
89 (http://www.opensource.org/licenses/artistic-license-2.0.php
90 <http://www.opensource.org/licenses/artistic-license-2.0.php>) or the
91 GNU LGPL 2.1 (http://www.opensource.org/licenses/lgpl-2.1.php
92 <http://www.opensource.org/licenses/lgpl-2.1.php>).
93
95 The XML-RPC standard is Copyright (c) 1998-2001, UserLand Software,
96 Inc. See <http://www.xmlrpc.com> for more information about the XML-
97 RPC specification.
98
100 RPC::XML, RPC::XML::Parser, XML::Parser
101
103 Randy J. Ray <rjray@blackperl.com>
104
105
106
107perl v5.12.0 2009-09-03 RPC::XML::Parser::XMLParser(3)