About SOAP::WSDL
SOAP::WSDL is a WSDL based open-source SOAP toolkit for perl.
It allows to easily create client and server SOAP interfaces based on a
WSDL description (WSDL-first Web Services).
SOAP::WSDL does not attempt to implement all concepts in all versions of the SOAP and WSDL specifications, but to comply to the WS-I Basic Profile.
SOAP-WSDL_XS provides a high-speed SOAP message parser
for SOAP::WSDL
What is SOAP, what is WSDL?
SOAP is an acronym for Simple Object Access Protocol.
SOAP is a W3C recommendation.
The latest version of the SOAP specification may be found
here.
SOAP defines a protocoll for message exchange between applications.
The most popular usage is to use SOAP for remote procedure calls (RPC).
WSDL is an acronym for Web Services Description Language.
WSDL is a W3C recommendation.
The latest version of the WSDL specification may be found
here.
WSDL defines a XML-based language for describing web service interfaces,
including SOAP interfaces.
News
Mar 03 2009: SOAP-WSDL_XS 0.2 release.
First public release of SOAP-WSDL_XS.
Read the full list of Changes.
Feb 22 2009: SOAP-WSDL 2.00.09 release.
Bugfix release: Fixes a few simple bugs.
Read the full list of Changes.
Feb 22 2009: SOAP-WSDL 2.00.08 release.
Bugfix release: perl Build test fails when SOAP::WSDL
has not previously been installed. Users of 2.00.07 can safely skip this
release, as it only changes a few files in the test suite.
Read the full list of Changes.
Feb 21 2009: SOAP-WSDL 2.00.07 release.
A maintenance release with numerous new features and bug
fixes. Most notably, there's the ability to enable "lax" XML processing,
and a Java example included
Read the full list of Changes.
SOAP-WSDL linked from Wikipedia!
I just noticed that SOAP::WSDL (this page) is linked from Wikipedia! And I haven't dug
deep enough to find out since when - it must be a while now...
Many thanks to the all Wikipedia guys and all Wikipedia authors, including anonymous - you rock!
Many thanks to the all Wikipedia guys and all Wikipedia authors, including anonymous - you rock!
Dec 03 2008: SOAP-WSDL 2.00.06 released.
Read the list of Changes.
Aug 14 2008: SOAP-WSDL Lighting talk at YAPC Europe
I did a lightning talk on YAPC Europe 2008 in beautiful
Copenhagen. During YAPC, I had the chance to Mark Overmeer, the author of
XML::Compile. Let's see whether there's opportunities to work together
on perl's SOAP support in the future...
Jun 05 2008: SOAP-WSDL 2.00.05 released.
Read the list of Changes.
Jun 05 2008: SOAP-WSDL 2.00.04 released.
Read the list of Changes.
May 18 2008: SOAP-WSDL 2.00.03 released.
Read the list of Changes.
May 16 2008: SOAP-WSDL 2.00.02 released.
It looks like this release is broken, so you better skip it.
Apr 26/27 2008: Erlangen PM WSRP Hackathon using SOAP::WSDL
The perl monger group
Erlangen PM had organized a
WSRP hackathon on 26/27th of April in Nuremberg, Germany.
WSRP is a OASIS standard for a portlet technology, allowing to include remote
portlets via a SOAP-based web service interface. For details, see the
WSRP TC home page.
While things started a bit slowly, the hackathon yielded a minimal WSRP producer, and
a command line WSRP consumer for testing, all based on SOAP::WSDL. Even though
the current state of the WSRP library is best described as "proof of concept",
SOAP::WSDL turned out to be a very helpful tool for implementing a WSRP toolkit in perl.
The WSRP distribution created at the hackathon is planned to be released on
CPAN, and can be retrieved from the subversion repository at http://svn.hyper-framework.org/Hyper/WSRP/
Apr 23 2008: SOAP-WSDL 2.00.01 released.
Read the list of Changes.
Apr 19 2008: SOAP::WSDL listed at ohloh.net
SOAP::WSDL is listed at ohloh.
Check out the code metrics rate it and add it to your stack, if you like.
Mar 30 2008: SOAP-WSDL 2.00_33 pre-release.
Read the list of Changes.
Feb 14 2007: SOAP-WSDL 2.00_32 pre-release.
Read the list of Changes.
Feb 11 2007: SOAP-WSDL 2.00_31 pre-release.
Read the list of Changes.
Jan 30 2008: SOAP talk at German Perl Workshop
Martin is doing a talk on perl's current SOAP toolkit at
German Perl Workshop
2008 in Erlangen (February 13 - February 15 2008). You may download the
submission proceedings to the and slides here.
Jan 20 2008: SOAP-WSDL 2.00_29 pre-release.
Read the list of Changes.
Jan 13 2008: SOAP-WSDL 1.27 release.
This is a bugfix release of the 1.2x SOAP-WSDL branch.
Jan 08 2008: SOAP-WSDL 2.00_28 pre-release.
Read the list of Changes.
Features
- WSDL based SOAP client
- SOAP1.1 support
- Supports document/literal message style/encoding
- Support for complex datatypes (complexType) and nested complexTypes.
- Code generator for generating WSDL-based interface classes
- Generated code includes usage documentation for the web service interface
- Easy-to use API.
- Automatically encodes perl data structures as message data
- Automatically sets HTTP headers right
- Quickstart documentation: SOAP::WSDL::Manual points you at getting your job done, not at the package's internals
- Thorough test suite: SOAP::WSDL is heavily regression and acceptance tested.
- SOAP::Lite like look and feel.
- Where possible, SOAP::WSDL mimics SOAP::Lite's API to allow easy migrations
- XML schema based class library for creating data objects
- High-performance XML parser
- Plugin support. SOAP::WSDL can be extended through plugins in various aspects.
The following plugins types are supported:
- Transport plugins via SOAP::WSDL::Factory::Transport
- Serializer plugins via SOAP::WSDL::Factory::Serializer
- Deserializer plugins via SOAP::WSDL::Factory::Deserializer
- Code Generator plugins via SOAP::WSDL::Factory::Generator
- Support for different output formats via deserializer plugins. The following plugins are included:
- Native SOAP::WSDL deserializer for creating custom objects based on the WSDL's XML schema definition
- Hash deserializer for creating native perl hash data structures
- SOM object deserializer for creating SOAP::Lite's SOAP::SOM objects
Documentation
All doumentation can be viewed online on CPAN
The material to be presented at German Perl Workshop 2008 can be downloaded here.
These documents are licensed under the same terms as Perl itself. See
www.perl.org
- State of the SOAP - proceedings paper (german)
- POD version (38kb)
- PDF version (250kB)
- State of the SOAP - presentation slides (german)
- PDF version (380kB)
Download
All releases can be downloaded from CPAN
You may also download the latest releases from
Sourceforge
Related projects
SOAP-WSDL_XS | High-performance SOAP message parser for SOAP::WSDL. |
SOAP::Lite | Client and server side SOAP implementation. Good support for rpc/encoded SOAP messages, basic support for document/literal SOAP messages. Basic WSDL support. |
XML::Compile::SOAP | SOAP Client and Server. Support for generating WSDL-based XML parser/generator pairs and for parsing/generating SOAP messages. Uses XML::LibXML's DOM implementation as base. |
Development
SOAP::WSDL is a WSDL based SOAP library for perl.
Martin Kutter maintains the distribution.
While the current implementation covers the needs of most users,
there are still many features missing from SOAP::WSDL.
As an open-source project, development and participation for SOAP::WSDL
is open to anyone willing to assist and contribute.
Any contribution is welcome, from bug reports, to patches, to new features.
If you want to join the project, post a note to the SOAP::WSDL forum.
Follow the links below for more information about working on SOAP::WSDL.
Resources
- SOAP: http://www.w3.org/TR/soap/
- WSDL 1.1: http://www.w3.org/TR/wsdl
- XML Schema: http://www.w3.org/XML/Schema
Credits
CPAN Testers | CPAN Testers provide most valuable feedback |
Sourceforge | SOAP::WSDL is hosted on Sourceforge |
Contact
For support or discussion on SOAP::WSDL you may look in the following locations:
SOAP-WSDL forum | SOAP-WSDL forum on CPAN::Forum |