Martin Kutter > SOAP-WSDL-2.00.99_3 > SOAP::WSDL::Manual

Download:
SOAP-WSDL-2.00.99_3.tar.gz

Annotate this POD

CPAN RT

New  20
Open  19
View/Report Bugs
Source   Latest Release: SOAP-WSDL-v3.002

NAME ^

SOAP::WSDL::Manual - Accessing WSDL based web services

Accessing a WSDL-based web service ^

Quick walk-through for the unpatient

Instrumenting web services with interface classes

SOAP::WSDL (starting from 2.00) instruments WSDL based web services with interface classes. This means that SOAP::WSDL features a code generator which creates one class for every web service you want to access.

Moreover, the data types from the WSDL definitions are also wrapped into classes and returned to the user as objects.

To find out which class a particular XML node should be, SOAP::WSDL uses the information built into type classes and interfaces.

Older versions of SOAP::WSDL used typemaps. For every Web service, a typemap was created. Typemaps were dropped, as they don't allow recursive XML schema declarations, eat up more memory and are slower. Old interfaces using typemaps are still supported, but you're encouraged to re-generate your interfaces.

Interface class creation

To create interface classes, follow the steps above from Quick walk-through for the unpatient.

If this works fine for you, skip the next paragraphs. If not, read on.

The steps to instrument a web service with SOAP::WSDL perl bindings (in detail) are as follows:

Adding missing information

Sometimes, WSDL definitions are incomplete. In most of these cases, proper fault definitions are missing. This means that though the specification says nothing about it, Fault messages include extra elements in the <detail> section, or errors are even indicated by non-fault messages.

There are two steps you need to perform for adding additional information.

Accessing a web service without a WSDL definition ^

Accessing a web service without a WSDL definition is more cumbersome. There are two ways to go:

Creating a SOAP Server ^

Creating a SOAP server works just like creating a client - just add the --server or -s option to the call to wsdl2perl.pl.

 perl wsdl2perl.pl -s -b BASE_DIR URL

SOAP::WSDL currently includes classes for building a basic CGI and a mod_perl 2 based SOAP server.

SEE ALSO ^

SOAP::WSDL::Manual::Cookbook cooking recipes for accessing web services, altering the XML Serializer and others.

SOAP::WSDL::Manual::XSD SOAP::WSDL's XML Schema implementation

SOAP::WSDL::Manual::Glossary The meaning of all these words

SOAP::WSDL::Client Basic client for SOAP::WSDL based interfaces

SOAP::WSDL an interpreting WSDL based SOAP client

LICENSE AND COPYRIGHT ^

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>

syntax highlighting: