RPC::XM...rFactory(3)

📦
version 0.82 · 5 versions
, in opensuse-leap 16.0

🦋 RPC::XML::ParserFactory — RPC::XM...rFactory(3) 🦋

okay bestie, welcome to the User Contributed Perl Documentation page for RPC::XML::ParserFactory — yes, the header says RPC::XM...rFactory(3), and this is literally the factory-class era of your Perl journey. ✨

✨ NAME ✨

RPC::XML::ParserFactory — a factory class for RPC::XML::Parser objects. It's giving parser matchmaker in the best way. 💅

🎀 SYNOPSIS 🎀

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

literally the whole vibe: load the factory, make a parser object, parse your message. slay. 🫶

💖 DESCRIPTION 💖

The RPC::XML::ParserFactory class encapsulates the process of creating parser objects that adhere to the interface described in RPC::XML::Parser. Under the hood, the parser object created and returned could be from any of a number of implementation classes. So you ask the factory, it does the matchmaking, and you get a parser shaped like the RPC::XML::Parser interface. 🧚

🌈 IMPORT-TIME ARGUMENTS 🌈

You can specify a particular underlying parser class to use, if you do not want RPC::XML::ParserFactory to use the default class. This is done with the class keyword:

use RPC::XML::ParserFactory (class => 'XML::Parser');

The value may be the name for any of the built-in classes, or it may be the name of a class that inherits from RPC::XML::Parser (and can thus be "manufactured" by the factory). The value is saved and becomes the default class for any calls to new that do not explicitly name a class to use. factory memory unlocked 🌟

bestie, heads up: if the specified class is not valid, this is not tested until the first call to new, at which point an invalid class will cause an exception (error) to occur. The constructor will return undef and the $RPC::XML::ERROR variable will contain the error message. 😭

🌸 Names of Built-In Parsers 🌸

The following names are valid when specified as the value of the class argument described above:

  • XML::Parser
  • xml::parser
  • xmlparser

All of these specify the parser implementation based on the XML::Parser module. This is the default parser if the user does not specify any alternative. 👑

  • XML::LibXML
  • xml::libxml
  • xmllibxml

These specify a parser implementation based on the XML::LibXML module. This is a new parser and not as well-vetted as the previous one, hence it must be explicitly requested. 🦋

🔥 SUBROUTINES/METHODS 🔥

The methods are:

  • new([ARGS]) — Create a new instance of the class. Any extra data passed to the constructor is taken as key/value pairs (not a hash reference) and attached to the object.

This method passes all arguments on to the new() method of the chosen implementation class, except for the following:

  • class NAME — If the user chooses, they may specify an explicit class to use for parsers when calling new(). If passed, this overrides any value that was given at use-time (processed by import()). 💅

💀 DIAGNOSTICS 💀

The constructor returns undef upon failure, with the error message available in the global variable $RPC::XML::ERROR. So if things go sideways, check that global and maybe cry a little — affectionately, obviously. 😭

🐛 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>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. bug-report main character energy 🐛✨

🫶 SUPPORT 🫶

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>) or the GNU LGPL 2.1 (<http://www.opensource.org/licenses/lgpl-2.1.php>). legal era, but make it open source 💜

🌟 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::Client, RPC::XML::Server, XML::Parser. the friend group 🫶

💌 AUTHOR 💌

Randy J. Ray "<rjray@blackperl.com>"

made with 💖 by perl v5.42.0 on 2021-04-08, for RPC::XM...rFactory(3) — okay bye bestie, go parse something iconic! 💅✨

📦 where this page comes from