NAME

RPC::XML::Parser::XS - Fast XML-RPC parser written in C

SYNOPSIS

  use RPC::XML::Parser::XS;

  my $req = parse_rpc_xml(qq{
    <methodCall>
      <methodName>foo.bar</methodName>
      <params>
        <param><value><string>Hello, world!</string></value></param>
      </params>
    </methodCall>
  });
  # $req is a RPC::XML::request
  
  my $res = parse_rpc_xml(qq{
    <methodResponse>
      <fault>
        <value>
          <struct>
            <member>
              <name>faultCode</name>
              <value><int>-1</int></value>
            </member>
            <member>
              <name>faultString</name>
              <value><string>No such method: foo.bar</string></value>
            </member>
          </struct>
        </value>
      </fault>
    </methodResponse>
  });
  # $res is a RPC::XML::response
  

DESCRIPTION

This module provides a single function "parse_rpc_xml" to parse XML-RPC request and response.

parse_rpc_xml

  my $obj = parse_rpc_xml($xml);

Parse an XML-RPC methodCall or methodResponse. Resulting object is a RPC::XML::request or RPC::XML::response depending on the XML.

Note that UTF-8 flags aren't turned on in strings in the result structure. This behavior is different from RPC::XML::Parser.

EXPORT

"parse_rpc_xml" is exported by default. If you don't want it to be exported, just say like this:

 use RPC::XML::Parser::XS ();

PERFORMANCE

When I compared the performance of RPC::XML::Parser and RPC::XML::Parser::XS, the latter was nearly 20 times faster than the former. If you have any suspicion in this, please benchmark it yourself.

DEPENDENCY

Libxml2

This is not a perl module. We don't use XML::LibXML. See http://xmlsoft.org/.

IPC::Run

MIME::Base64

RPC::XML

Test::Exception

Test::More

SEE ALSO

RPC::XML::Parser

COPYRIGHT AND LICENSE

Copyright (C) 2007 YMIRLINK Inc.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself