The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
XML-Compile-WSDL11-Recursive-0.001-TRIAL
/ XML::Compile::WSDL11::Recursive

NAME

XML::Compile::WSDL11::Recursive - Recursively compile a web service proxy

VERSION

version 0.001

SYNOPSIS

    use XML::Compile::WSDL11::Recursive;

    my $wsdl = XML::Compile::WSDL11::Recursive->new(
                uri => 'http://example.com/foo.wsdl' );
    $wsdl->proxy->compileCalls();
    my ( $answer, $trace ) = $wsdl->proxy->call( hello => {name => 'Joe'} );

DESCRIPTION

From the description of XML::Compile::WSDL11:

    When the [WSDL] definitions are spread over multiple files you will need to use addWSDL() (wsdl) or importDefinitions() (additional schema's) explicitly. Usually, interreferences between those files are broken. Often they reference over networks (you should never trust). So, on purpose you must explicitly load the files you need from local disk! (of course, it is simple to find one-liners as work-arounds, but I will to tell you how!)

This module implements that work-around, recursively parsing and compiling a WSDL specification and any imported definitions and schemas. The wrapped WSDL is available as a proxy attribute.

It also provides a hook to use any CHI driver so that retrieved files may be cached locally, reducing dependence on network-accessible definitions.

You may also provide your own LWP::UserAgent (sub)class instance, possibly to correct on-the-fly any broken interreferences between files as warned above.

ATTRIBUTES

cache

A read-only reference to the underlying CHI::Driver object used to cache schemas.

cache_parameters

A hash reference settable at construction to pass parameters to the CHI module used to cache schemas. By default nothing is cached.

options

Optional hash reference of additional parameters to pass to the XML::Compile::WSDL11 constructor. Defaults to:

    { allow_undeclared => 1 }

proxy

Retrieves the resulting XML::Compile::WSDL11 object. Any definitions are retrieved and compiled on first access to this attribute. If there are problems retrieving any files, an HTTP::Exception is thrown with the details.

uri

Required string or URI object pointing to a WSDL file to compile.

user_agent

Optional instance of an LWP::UserAgent that will be used to get all WSDL and XSD content when the proxy cache is built.

SUPPORT

Perldoc

You can find documentation for this module with the perldoc command.

  perldoc XML::Compile::WSDL11::Recursive

Websites

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

Bugs / Feature Requests

Please report any bugs or feature requests through the web interface at https://github.com/mjgardner/xml-compile-wsdl11-recursive/issues. You will be automatically notified of any progress on the request by the system.

Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

https://github.com/mjgardner/xml-compile-wsdl11-recursive

  git clone git://github.com/mjgardner/xml-compile-wsdl11-recursive.git

AUTHOR

Mark Gardner <mjgardner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by ZipRecruiter.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.