XML::C...tension(3pm)

💖 XML::Compile::SOAP::Extension — plugins for standards ✨

okay bestie, buckle up, we're looking at XML::Compile::SOAP::Extension (that's the XML::C...tension(3pm) page, and yes the terminal is just being dramatic with the truncation, it's fine, she's shy). This is from the User Contributed Perl Documentation, and it is exactly what it sounds like: the lil base class that lets other standards come in and do their thing. 🎀

---

🌸 NAME 🌸

XML::Compile::SOAP::Extension — plugins for standards

Like, literally. Plugins. For standards. She's the vibe curator of the SOAP world. 💅

---

🧚 INHERITANCE 🧚

XML::Compile::SOAP::Extension is extended by:

• XML::Compile::SOAP::WSA
• XML::Compile::Transport

So she's the mom friend. The one everybody inherits from. 👑

---

✨ SYNOPSIS ✨

# only as base-class

That's it. That's the whole synopsis. Not me getting emotional over a one-line synopsis, nope, not me. 😭 This module does not want to be instantiated and used directly, she's a base-class only situation. She's the blueprint, not the building. 🦋

---

🌈 DESCRIPTION 🌈

This module defines hooks which are used to implement the SOAP and WSDL extensions. 🪝

Hooks are created on critial spots — yes, the original says "critial", we are quoting her typo verbatim because we respect the lore — where additional standards play tricks with the logic of SOAP and WSDL. 🙈

And bestie, there are a lot of those standards. Like, a lot a lot. For instance:

• Web Service Addressing (WSA, XML::Compile::SOAP::WSA)

So basically every time some new standard wants to be quirky about SOAP, this module is where the little trapdoors get installed. It's giving backstage pass. 🎟️

---

💅 METHODS 💅

🍓 Constructors 🍓

• XML::Compile::SOAP::Extension->new(%options)

That's the constructor. %options go in, an object comes out. Standard behavior, no notes. ✨

🦋 WSDL11 🦋

• $obj->wsdl11Init($wsdl, $args)
• XML::Compile::SOAP::Extension->wsdl11Init($wsdl, $args)

⚠️ Do not use this hook for adding WSDLs or schemas, unless those are used to interpret $wsdl or SOAP files correctly.

Like, seriously. Read that twice. This is a "girl please don't" situation, the hook is not a dumping ground for your extra WSDLs. It's for things that actually help interpret $wsdl or the SOAP files properly. Periodt. 💀

🌸 SOAP11 🌸

• $obj->soap11ClientWrapper($operation, $call, $args)
• $obj->soap11HandlerWrapper($operation, $callback, $args)

Called before the handler is created, to influence the encoder and decoder. What comes back is either a wrapped callback, or the same one. Either way, you get a callback out. 🎀

• $obj->soap11OperationInit($operation, $args)
• XML::Compile::SOAP::Extension->soap11OperationInit($operation, $args)

$args is a reference. 🔥

🌟 SOAP12 🌟

• $obj->soap12ClientWrapper($operation, $call, $args)
• $obj->soap12HandlerWrapper($operation, $callback, $args)

Called before the handler is created, to influence the encoder and decoder. Returned is a wrapped callback, or the same. Same deal as her SOAP11 sister, just with a 12 on the end. 💖

• $obj->soap12OperationInit($operation, $args)
• XML::Compile::SOAP::Extension->soap12OperationInit($operation, $args)

$args is a reference. 🫶

---

🔥 SEE ALSO 🔥

This module is part of the XML-Compile-SOAP distribution, version 3.28, built on August 01, 2022. 🌈

Website: http://perl.overmeer.net/CPAN/

---

👑 LICENSE 👑

Copyrights 2007-2022 by [Mark Overmeer <markov@cpan.org>]. For other contributors see ChangeLog. 🌸

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://dev.perl.org/licenses/

---

and that's the whole page bestie!! 💜 built on perl v5.34.0, dated 2022-08-04, and yes the footer says XML::C...tension(3pm) again because the terminal refuses to spell her whole name. go forth and hook responsibly, mwah 💋✨