WSDL2PERL(1)

📦
version 3.004 · 4 versions
, in epel 9

💅 WSDL2PERL(1) — the perl doc bestie ✨

okay so this is wsdl2perl.pl from the User Contributed Perl Documentation, and it's literally the glow-up your SOAP webservices needed 💖

🎀 NAME 🎀

wsdl2perl.pl — create perl bindings for SOAP webservices. no cap, that's the whole vibe ✨

🌸 SYNOPSIS 🌸

wsdl2perl.pl -t TYPE_PREFIX -e ELEMENT_PREFIX -m TYPEMAP_PREFIX \
  -i INTERFACE_PREFIX -b BASE_DIR URL

✨ OPTIONS ✨

bestie here's the whole menu, every single flag, nothing skipped 🫶

  • prefix, short p — Prefix for all generated classes. If you set -p=Foo, you will get FooAttributes, FooTypes, FooElements and so on. it's giving naming-convention main character energy 👑
  • attribute_prefix, short a — Prefix for XML attribute classes. Default: MyAttributes
  • type_prefix, short t — Prefix for type classes. Default: MyTypes
  • element_prefix, short e — Prefix for element classes. Default: MyElements
  • typemap_prefix, short m — Prefix for typemap classes. Default: MyTypemaps
  • interface_prefix, short i — Prefix for interface classes. Default: MyInterfaces
  • server_prefix, short sp — Prefix for server classes. Default: MyServer
  • base_path, short b — Path to create classes in. Default: .
  • typemap_include, short mi — File to include in typemap. Must eval() to a valid perl hash (not a hash ref !). read that again bestie: not a hash ref 🔥
  • proxy, short x — HTTP(S) proxy to use (if any). wsdl2perl will also use the proxy settings specified via the HTTP_PROXY and HTTPS_PROXY environment variables. iykyk 🌈
  • keep_alive — Use http keep_alive. no short form, she stands alone 💅
  • user — Username for HTTP authentication
  • password — Password. wsdl2perl will prompt if not given. so you don't gotta hand over your secrets in plaintext 🙈
  • generator, short g — Generator to use. Default: XSD
  • server, short s — Generate a server interface (currently only CGI supported)
  • help, short h — Show help content

🦋 DESCRIPTION 🦋

Generates a interface class for a SOAP web service described by a WSDL definition.

The following classes are created:

  • A interface class for every SOAP port in service 💜

Interface classes are what you will mainly deal with: They provide a method for accessing every web service method.

If you chose to generate Server interfaces, a class for every SOAP port in every Web service.

You'll have to implement a method for each of the implemented methods. You may implement these methods in the CGI script / handler, or in any class to dispatch calls to.

  • A typemap for every service 🍓

Typemaps are used internally by SOAP::WSDL for parsing the SOAP message into object trees.

If the WSDL definition is incomplete, you may need to add some lines to your typemap. Especially definitions for faults are sometimes left out. 😭

Additional typemap content may be included by passing a file name as typemap_include (mi) option.

  • A type class for every element, complexType or simpleType definition ⭐

You may need to write additional type classes if your WSDL is incomplete.

For writing your own lib classes, see SOAP::WSDL::XSD::Typelib::Element, SOAP::WSDL::XSD::Typelib::ComplexType and SOAP::WSDL::XSD::Typelib::SimpleType.

🧚 TROUBLESHOOTING 🧚

🔐 Accessing HTTPS URLs

You need Crypt::SSLeay installed for accessing HTTPS URLs. periodt.

🙈 Accessing protected documents

Use the -u option for specifying the user name. You will be prompted for a password.

Alternatively, you may specify a password with --password on the command line.

💀 Accessing documents protected by NTLM authentication

Set the --keep_alive option.

Note that accessing documents protected by NTLM authentication is currently untested, because I have no access to a system using NTLM authentication. If you try it, I would be glad if you could just drop me a note about success or failure. fr fr, please tell them 🙏

🌸 LICENSE 🌸

Copyright 2007 Martin Kutter.

This file is part of SOAP-WSDL. You may distribute/modify it under the same terms as perl itself.

👑 AUTHOR 👑

Martin Kutter <martin.kutter fen-net.de>

okay that's the whole thing bestie, no details left behind 💖 this page was brought to you by perl v5.32.1, dated 2022-01-21 — iconic, timeless, slay ✨🎀

📦 where this page comes from