import SOAP-WSDL 2.00_10 from CPAN

git-cpan-module:   SOAP-WSDL
git-cpan-version:  2.00_10
git-cpan-authorid: MKUTTER
git-cpan-file:     authors/id/M/MK/MKUTTER/SOAP-WSDL-2.00_10.tar.gz

Build.PL

@@ -1,31 +1,35 @@
 use Module::Build;
 Module::Build->new(
+        create_makefile_pl => 'passthrough',
 	dist_abstract => 'SOAP with WSDL support',
 	dist_name => 'SOAP-WSDL',
-	dist_version => '2.00_07',
+	dist_version => '2.00_10',
 	module_name   => 'SOAP::WSDL',
 	license       => 'artistic',
 	requires      => {
 	    'Class::Std' => q/v0.0.8/,
 	    'Class::Std::Storable' => 0,
-            'SOAP::Lite' => 0,
+	    'Date::Parse' => 0,
+	    'Date::Format' => 0,
+            'LWP::UserAgent' => 0,
             'List::Util' => 0,
             'File::Basename' => 0,
             'File::Path' => 0,
-            'XML::XPath' => 0,
             'XML::LibXML' => 0,
             'XML::SAX::Base' => 0,
             'XML::SAX::ParserFactory' => 0,
             'XML::Parser::Expat' => 0,
 	},
 	buildrequires => {	
+	    'Date::Parse' => 0,
+	    'Date::Format' => 0,
 	    'Benchmark' => 0, 
 	    'Cwd' => 0,    
 	    'Test::More' => 0,
-            'SOAP::Lite' => 0,
 	    'Class::Std' => 0.0.8,
 	    'Class::Std::Storable' => 0,        
             'List::Util' => 0,
+            'LWP::UserAgent' => 0,
             'File::Basename' => 0,
             'File::Path' => 0,
             'XML::Simple' => 0,
@@ -34,7 +38,6 @@ Module::Build->new(
             'XML::SAX::Base' => 0,
             'XML::SAX::ParserFactory' => 0,
             'Pod::Simple::Text' => 0,
-            'XML::SAX::ParserFactory' => 0,
 	},
 	recursive_test_files => 1,
 )->create_build_script;

CHANGES

@@ -1 +1,639 @@
-See perldoc SOAP::WSDL
+------------------------------------------------------------------------
+r142 | kutterma | 2007-08-13 15:55:45 +0200 (Mo, 13 Aug 2007) | 1 line
+
+typo
+------------------------------------------------------------------------
+r141 | kutterma | 2007-08-12 21:45:51 +0200 (So, 12 Aug 2007) | 2 lines
+
+- corrected POD error
+- little speedup in add_FOO methods
+------------------------------------------------------------------------
+r140 | kutterma | 2007-08-12 21:27:58 +0200 (So, 12 Aug 2007) | 1 line
+
+- corrected POD error
+------------------------------------------------------------------------
+r139 | kutterma | 2007-08-12 21:15:59 +0200 (So, 12 Aug 2007) | 1 line
+
+- adder repository information
+------------------------------------------------------------------------
+r138 | kutterma | 2007-08-12 21:13:08 +0200 (So, 12 Aug 2007) | 1 line
+
+- typo
+------------------------------------------------------------------------
+r137 | kutterma | 2007-08-12 21:12:20 +0200 (So, 12 Aug 2007) | 3 lines
+
+- updated docs
+- added svn information
+- cosmetics
+------------------------------------------------------------------------
+r136 | kutterma | 2007-08-12 15:11:50 +0200 (So, 12 Aug 2007) | 2 lines
+
+- fixed element ref="" top level- elements in code generator
+- prepared 2.00_09 pre-release
+------------------------------------------------------------------------
+r135 | kutterma | 2007-08-12 14:44:06 +0200 (So, 12 Aug 2007) | 1 line
+
+- prepared 2.00_09 pre-release
+------------------------------------------------------------------------
+r134 | kutterma | 2007-08-12 14:30:33 +0200 (So, 12 Aug 2007) | 2 lines
+
+- updated README
+- bumped up version
+------------------------------------------------------------------------
+r133 | kutterma | 2007-08-12 14:27:17 +0200 (So, 12 Aug 2007) | 1 line
+
+- fixed Build.PL to leave Makefile.PL untouched.
+------------------------------------------------------------------------
+r132 | kutterma | 2007-08-12 14:21:24 +0200 (So, 12 Aug 2007) | 1 line
+
+- now really added Makefile.PL
+------------------------------------------------------------------------
+r131 | kutterma | 2007-08-12 14:18:59 +0200 (So, 12 Aug 2007) | 3 lines
+
+- fixed documentation for generated code with element ref="" declarations
+- fixed element ref="" test for generated code
+- added (generated) Makefile.PL to make CPAN testers happy
+------------------------------------------------------------------------
+r130 | kutterma | 2007-08-10 15:57:12 +0200 (Fr, 10 Aug 2007) | 1 line
+
+- first try at truely callback-based parser (inspired by XML::Compile)
+------------------------------------------------------------------------
+r129 | kutterma | 2007-08-07 17:53:40 +0200 (Di, 07 Aug 2007) | 1 line
+
+- moved duplicate sub generation out of loop
+------------------------------------------------------------------------
+r128 | kutterma | 2007-08-07 14:16:28 +0200 (Di, 07 Aug 2007) | 1 line
+
+- bool now returns numerical value in bool context, not "true" or "false" (always true...)
+------------------------------------------------------------------------
+r127 | kutterma | 2007-08-07 11:45:23 +0200 (Di, 07 Aug 2007) | 1 line
+
+- fixed test to be timezone sensitive
+------------------------------------------------------------------------
+r126 | kutterma | 2007-08-07 11:09:51 +0200 (Di, 07 Aug 2007) | 1 line
+
+- made test timezone-sensitive
+------------------------------------------------------------------------
+r125 | kutterma | 2007-08-07 11:09:16 +0200 (Di, 07 Aug 2007) | 1 line
+
+- made test timezone-sensitive
+------------------------------------------------------------------------
+r124 | kutterma | 2007-08-06 18:05:02 +0200 (Mo, 06 Aug 2007) | 2 lines
+
+- fixed element ref handling in code generator in ComplexType. 
+- top-level element ref still not supported/tested
+------------------------------------------------------------------------
+r123 | kutterma | 2007-08-06 17:48:57 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- test now dies and outputs code to eval on eval errors
+------------------------------------------------------------------------
+r122 | kutterma | 2007-08-06 17:29:46 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- fixed element ref="" handling in complexType
+------------------------------------------------------------------------
+r121 | kutterma | 2007-08-06 17:29:14 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- added test data for element ref inside complexType
+------------------------------------------------------------------------
+r120 | kutterma | 2007-08-06 17:28:54 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- added test for element ref inside complexType
+------------------------------------------------------------------------
+r119 | kutterma | 2007-08-06 17:13:03 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- fixed element ref handling
+------------------------------------------------------------------------
+r118 | kutterma | 2007-08-06 17:12:47 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- added element ref test data
+------------------------------------------------------------------------
+r117 | kutterma | 2007-08-06 17:12:36 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- added element ref test
+------------------------------------------------------------------------
+r116 | kutterma | 2007-08-06 15:47:30 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- refined docs
+------------------------------------------------------------------------
+r115 | kutterma | 2007-08-06 15:39:39 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- updated docs. Hope the CPAN indexer ignores "=for developers"...
+------------------------------------------------------------------------
+r114 | kutterma | 2007-08-06 14:12:28 +0200 (Mo, 06 Aug 2007) | 1 line
+
+- removed annoying pod 
+------------------------------------------------------------------------
+r113 | kutterma | 2007-08-05 18:42:09 +0200 (So, 05 Aug 2007) | 5 lines
+
+- removed SOAP::Lite dependency
+- updated docs
+- changed SOAP::WSDL::XSD::Typelib::ComplexType to require the actuall class for element data, not just the base class (good for finding errors earlier)
+- implemented returning SOAP::SOM objects in SOAP::WSDL
+- added SOAP::WSDL example(weather_wsdl.pl)
+------------------------------------------------------------------------
+r112 | kutterma | 2007-08-03 16:12:57 +0200 (Fr, 03 Aug 2007) | 1 line
+
+updated docs
+------------------------------------------------------------------------
+r111 | kutterma | 2007-08-03 16:12:04 +0200 (Fr, 03 Aug 2007) | 1 line
+
+- added "skip"
+------------------------------------------------------------------------
+r110 | kutterma | 2007-07-31 22:27:25 +0200 (Di, 31 Jul 2007) | 2 lines
+
+- further work on removing SOAP::Lite dependency
+- Note: SOAP::WSDL may be broken !
+------------------------------------------------------------------------
+r109 | kutterma | 2007-07-31 21:10:40 +0200 (Di, 31 Jul 2007) | 3 lines
+
+- finished move from XSD::Primitive to Builtin
+- fixed a few tests
+- removed typo namespace from TypeLookupt
+------------------------------------------------------------------------
+r108 | kutterma | 2007-07-31 21:02:43 +0200 (Di, 31 Jul 2007) | 1 line
+
+- removed unneeded example stuff
+------------------------------------------------------------------------
+r107 | kutterma | 2007-07-31 20:32:43 +0200 (Di, 31 Jul 2007) | 1 line
+
+- rename to Builtin
+------------------------------------------------------------------------
+r106 | kutterma | 2007-07-31 20:32:11 +0200 (Di, 31 Jul 2007) | 1 line
+
+- prepared rename to Builtin
+------------------------------------------------------------------------
+r105 | kutterma | 2007-07-31 13:17:52 +0200 (Di, 31 Jul 2007) | 2 lines
+
+- added configurable ContentType / charset 
+- maybe split up charset and content type into two methods ?
+------------------------------------------------------------------------
+r104 | kutterma | 2007-07-31 00:16:15 +0200 (Di, 31 Jul 2007) | 3 lines
+
+- removed optional nanoseconds from dateTime conversions
+- added conversion to date objects
+- removed fetching WSDL via SOAP::Schema in SOAP::WSDL. SOAP::Lite is still used as base class.
+------------------------------------------------------------------------
+r103 | kutterma | 2007-07-30 13:25:06 +0200 (Mo, 30 Jul 2007) | 1 line
+
+- updated TODO
+------------------------------------------------------------------------
+r102 | kutterma | 2007-07-30 13:23:09 +0200 (Mo, 30 Jul 2007) | 2 lines
+
+- updated Build.PL dependencies
+- update TODO
+------------------------------------------------------------------------
+r101 | kutterma | 2007-07-30 13:22:05 +0200 (Mo, 30 Jul 2007) | 2 lines
+
+- added dateTime test
+- fixed pod test
+------------------------------------------------------------------------
+r100 | kutterma | 2007-07-27 16:03:15 +0200 (Fr, 27 Jul 2007) | 2 lines
+
+- allow passing list refs of hash refs to set_value.
+I hope I got all combinations by now - start getting ugly...
+------------------------------------------------------------------------
+r99 | kutterma | 2007-07-26 23:18:35 +0200 (Do, 26 Jul 2007) | 1 line
+
+- added SOAP::Lite usage (to be removed later)
+------------------------------------------------------------------------
+r98 | kutterma | 2007-07-26 23:16:30 +0200 (Do, 26 Jul 2007) | 3 lines
+
+- removed SOAP::Lite dependency
+- added set_trace and tracing facility support via callback in call()
+- added fault_class property to allow different Fault classes (somewhen later on)
+------------------------------------------------------------------------
+r97 | kutterma | 2007-07-25 16:59:49 +0200 (Mi, 25 Jul 2007) | 3 lines
+
+- dateTime now converts date strings into XML date strings
+- updated docs
+
+------------------------------------------------------------------------
+r96 | kutterma | 2007-07-23 11:17:36 +0200 (Mo, 23 Jul 2007) | 3 lines
+
+- SOAP::WSDL::Definitions::create now
+   - converts '.' in service names to '::' (.NET class separator to perl class separator)
+   - outputs Typemaps and Interface classes in UTF8 to allow proper inclusion of UTF8 documentation from WSDL
+------------------------------------------------------------------------
+r95 | kutterma | 2007-07-23 10:26:59 +0200 (Mo, 23 Jul 2007) | 1 line
+
+- typo
+------------------------------------------------------------------------
+r94 | kutterma | 2007-07-23 10:11:46 +0200 (Mo, 23 Jul 2007) | 1 line
+
+- typo
+------------------------------------------------------------------------
+r93 | kutterma | 2007-07-22 23:24:12 +0200 (So, 22 Jul 2007) | 1 line
+
+updated TODO
+------------------------------------------------------------------------
+r92 | kutterma | 2007-07-22 23:19:15 +0200 (So, 22 Jul 2007) | 3 lines
+
+- WSDLHandler now handles <wsdl:documentation> tags
+- SOAP::WSDL::Definitions now includes some usable doc in generated interface classes
+- fixed explain in SimpleType, ComplexType and Element (someway)
+------------------------------------------------------------------------
+r91 | kutterma | 2007-07-22 21:18:21 +0200 (So, 22 Jul 2007) | 1 line
+
+- updated docs
+------------------------------------------------------------------------
+r90 | kutterma | 2007-07-22 15:42:23 +0200 (So, 22 Jul 2007) | 1 line
+
+- updated docs
+------------------------------------------------------------------------
+r89 | kutterma | 2007-07-22 15:38:25 +0200 (So, 22 Jul 2007) | 2 lines
+
+- updated docs
+- removed useless docs from "internally used only" - modules
+------------------------------------------------------------------------
+r88 | kutterma | 2007-07-22 09:17:57 +0200 (So, 22 Jul 2007) | 1 line
+
+typo
+------------------------------------------------------------------------
+r87 | kutterma | 2007-07-21 23:57:46 +0200 (Sa, 21 Jul 2007) | 1 line
+
+- updated docs
+------------------------------------------------------------------------
+r86 | kutterma | 2007-07-21 23:24:24 +0200 (Sa, 21 Jul 2007) | 5 lines
+
+- removed irritating pod from SOAP::WSDL::XSD::Typelib::Builtin::* classes and put int into SOAP::WSDL::XSD::Typelib::Builtin
+- added fast constructor creation BEGIN block to all SOAP::WSDL::XSD::Typelib::Builtin::* classes
+- added examples
+- updated docs
+- prepared 2.00_07 pre-release
+------------------------------------------------------------------------
+r85 | kutterma | 2007-07-21 18:12:49 +0200 (Sa, 21 Jul 2007) | 4 lines
+
+- added wsdl2perl code generation script - works against FortuneCookie web service at fullerdata.com
+- fixed SOAP::WSDL::Client::Base to work as base class for generated classes
+- added interface generation facility to SOAP::WSDL::Definitions
+- updated docs (a few)
+------------------------------------------------------------------------
+r84 | kutterma | 2007-07-20 15:37:40 +0200 (Fr, 20 Jul 2007) | 9 lines
+
+- added Expat-based parser
+- made Expat-based parser the default
+- added fast "new" method to most important "Builtin" types 
+- added Parser POD
+- fixed propagating element names in complex types to element elements - element ref="element" should work on 
+ class level now (don't know whether typelib supports it yet)
+- updated tests
+- updated HACKING
+- prepared 2.00_06 release
+------------------------------------------------------------------------
+r83 | kutterma | 2007-07-19 13:09:33 +0200 (Do, 19 Jul 2007) | 1 line
+
+- fixed element class generation (removed additional ::)
+------------------------------------------------------------------------
+r82 | kutterma | 2007-07-17 22:17:02 +0200 (Di, 17 Jul 2007) | 1 line
+
+- updated README and HACKING
+------------------------------------------------------------------------
+r81 | kutterma | 2007-07-17 22:00:14 +0200 (Di, 17 Jul 2007) | 5 lines
+
+- added parent ref in SOAP::WSDL::Base - now we have a real tree, and maybe can completely support namespaces some day
+- replaced grep by List::Util::first where appropriate
+- code cleanup
+- fixed test for Code Generation
+- updated a few tests
+------------------------------------------------------------------------
+r80 | kutterma | 2007-07-17 17:00:48 +0200 (Di, 17 Jul 2007) | 1 line
+
+- improved pod in generated classes
+------------------------------------------------------------------------
+r79 | kutterma | 2007-07-17 14:41:44 +0200 (Di, 17 Jul 2007) | 1 line
+
+- made explain look nicer
+------------------------------------------------------------------------
+r78 | kutterma | 2007-07-15 12:25:03 +0200 (So, 15 Jul 2007) | 7 lines
+
+- SOAP::WSDL::Definitions can now generate
+   - Typemaps
+   - Type and Element classes
+- fixed SOAP::WSDL::XSD::Typelib::ComplexType to support elements with type="ComplexType" definitions
+- moved toClass method in SOAP::WSDL::XSD::ComplexType, Element and SimpleType to to_class and added compatibility wrapper with warning for toClass calls
+- added generator test
+- updated docs
+------------------------------------------------------------------------
+r77 | kutterma | 2007-07-14 10:46:54 +0200 (Sa, 14 Jul 2007) | 1 line
+
+- started working on high-level code generator
+------------------------------------------------------------------------
+r76 | kutterma | 2007-07-13 09:21:33 +0200 (Fr, 13 Jul 2007) | 1 line
+
+- fixed handling of complex data (hashes with lists embedded lists of objects)
+------------------------------------------------------------------------
+r75 | kutterma | 2007-07-10 12:08:39 +0200 (Di, 10 Jul 2007) | 1 line
+
+- removed unneeded SOAP::Lite calls
+------------------------------------------------------------------------
+r74 | kutterma | 2007-07-10 12:08:10 +0200 (Di, 10 Jul 2007) | 1 line
+
+- updated to new SOAP::Lite API
+------------------------------------------------------------------------
+r73 | kutterma | 2007-07-10 12:00:25 +0200 (Di, 10 Jul 2007) | 6 lines
+
+- re-integrated old SOAP::WSDL tests
+- updated docs
+- SOAP::WSDL::XSD::Typelib::Builtin::string now escapes XML builtin entities on serialization
+- SOAP::WSDL::XSD::Element now supports generating classes for elements and types into different namespaces
+- SOAP::WSDL::Definitions now supports different namespaces for elements and types when generating typmaps
+- 2.00_05 release preparation
+------------------------------------------------------------------------
+r72 | kutterma | 2007-07-06 11:20:56 +0200 (Fr, 06 Jul 2007) | 1 line
+
+- fixed detail (typo)
+------------------------------------------------------------------------
+r71 | kutterma | 2007-07-05 16:13:28 +0200 (Do, 05 Jul 2007) | 1 line
+
+- TODO comments added
+------------------------------------------------------------------------
+r70 | kutterma | 2007-07-04 16:14:50 +0200 (Mi, 04 Jul 2007) | 2 lines
+
+- updated docs
+- prepared 2.00_04 release
+------------------------------------------------------------------------
+r69 | kutterma | 2007-07-04 16:07:54 +0200 (Mi, 04 Jul 2007) | 1 line
+
+- ComplexType now ignores xmlns - TODO: check xmlns, don't ignore...
+------------------------------------------------------------------------
+r68 | kutterma | 2007-07-04 11:25:31 +0200 (Mi, 04 Jul 2007) | 1 line
+
+- made builtin types with overloads serializable
+------------------------------------------------------------------------
+r67 | kutterma | 2007-07-04 09:51:06 +0200 (Mi, 04 Jul 2007) | 4 lines
+
+- updated docs
+- removed unneeded uses from test
+- added Build requirements from tests
+- prepared 2.00_03 release
+------------------------------------------------------------------------
+r66 | kutterma | 2007-07-04 00:06:29 +0200 (Mi, 04 Jul 2007) | 3 lines
+
+- split up builtin type lib into single files for Class::Std::Storable
+- fixed more tests
+- fixed complexType serialization for non-objecs
+------------------------------------------------------------------------
+r65 | kutterma | 2007-07-03 16:52:54 +0200 (Di, 03 Jul 2007) | 2 lines
+
+- fixed a few tests
+- added performance improvements
+------------------------------------------------------------------------
+r64 | kutterma | 2007-07-03 15:09:27 +0200 (Di, 03 Jul 2007) | 1 line
+
+- small performance improvements
+------------------------------------------------------------------------
+r63 | kutterma | 2007-07-03 14:37:28 +0200 (Di, 03 Jul 2007) | 3 lines
+
+- fixed serializing complextypes correctly
+- fixed handling has attribute refs in new
+- fixed performance problems in MessageHandler
+------------------------------------------------------------------------
+r62 | kutterma | 2007-07-03 14:37:14 +0200 (Di, 03 Jul 2007) | 1 line
+
+- re-added
+------------------------------------------------------------------------
+r61 | kutterma | 2007-07-03 14:36:59 +0200 (Di, 03 Jul 2007) | 1 line
+
+
+------------------------------------------------------------------------
+r60 | kutterma | 2007-07-01 09:52:41 +0200 (So, 01 Jul 2007) | 2 lines
+
+- fixed lots of tests
+- attic tests may be re-integrated now...
+------------------------------------------------------------------------
+r59 | kutterma | 2007-06-28 13:07:35 +0200 (Do, 28 Jun 2007) | 1 line
+
+- added ignore for dist tar.gz
+------------------------------------------------------------------------
+r58 | kutterma | 2007-06-28 13:06:25 +0200 (Do, 28 Jun 2007) | 1 line
+
+- updated buildrequires
+------------------------------------------------------------------------
+r57 | kutterma | 2007-06-28 13:05:03 +0200 (Do, 28 Jun 2007) | 1 line
+
+- typo
+------------------------------------------------------------------------
+r56 | kutterma | 2007-06-28 11:15:24 +0200 (Do, 28 Jun 2007) | 1 line
+
+- pre-release 2.00_01
+------------------------------------------------------------------------
+r55 | kutterma | 2007-06-28 10:23:20 +0200 (Do, 28 Jun 2007) | 1 line
+
+- moved old tests to attic
+------------------------------------------------------------------------
+r54 | kutterma | 2007-06-28 10:15:41 +0200 (Do, 28 Jun 2007) | 1 line
+
+- fixed a few typos
+------------------------------------------------------------------------
+r53 | kutterma | 2007-06-28 10:10:41 +0200 (Do, 28 Jun 2007) | 3 lines
+
+- fixed MessageHandler to support deserializing into objects which return false in boolean context
+- updated docs
+- fixed Fault11 (named detail correctly)
+------------------------------------------------------------------------
+r52 | kutterma | 2007-06-27 17:36:01 +0200 (Mi, 27 Jun 2007) | 3 lines
+
+- added Fault for SOAP 1.1 implementation
+- fixed ComplexType - though it doesn't work quite for faults yet...
+
+------------------------------------------------------------------------
+r51 | kutterma | 2007-06-27 13:27:59 +0200 (Mi, 27 Jun 2007) | 13 lines
+
+- added test for sending objects via call()
+- modified Client to accept objects of type SOAP::WSDL::XSD::Typelib::Builtin::anyType as message content 
+without checking the WSDL objects
+Note: 
+- SOAPAction is just guessed - needs to be replaced by something better
+- The method should be looked up from the typelib, too, and serialized according to the rules specified in the WSDL 
+and dumped into the typelib.
+
+- updated to_typelib to include top element
+- fixed element and complextype templates for toClass
+
+
+
+------------------------------------------------------------------------
+r50 | kutterma | 2007-06-27 00:01:32 +0200 (Mi, 27 Jun 2007) | 1 line
+
+- added xsi xmlns to envelope
+------------------------------------------------------------------------
+r49 | kutterma | 2007-06-26 23:52:18 +0200 (Di, 26 Jun 2007) | 1 line
+
+- cosmetics and a few doc updates
+------------------------------------------------------------------------
+r48 | kutterma | 2007-06-26 22:47:52 +0200 (Di, 26 Jun 2007) | 2 lines
+
+- refactored element serializing to make it somewhat more consistent
+- added nillable implementation for Elements
+------------------------------------------------------------------------
+r47 | kutterma | 2007-06-26 18:06:59 +0200 (Di, 26 Jun 2007) | 1 line
+
+- removed shebang
+------------------------------------------------------------------------
+r46 | kutterma | 2007-06-26 18:06:33 +0200 (Di, 26 Jun 2007) | 1 line
+
+- added warnings
+------------------------------------------------------------------------
+r45 | kutterma | 2007-06-26 17:39:09 +0200 (Di, 26 Jun 2007) | 3 lines
+
+- got toClass working for generating WSDL based type libraries.
+- changed typelib base class behavior to qualify first element called.
+TODO (a bigger one): Fully support namespaces...
+------------------------------------------------------------------------
+r44 | kutterma | 2007-06-26 12:10:33 +0200 (Di, 26 Jun 2007) | 14 lines
+
+- changed Typelib::Element to work as attribute of a type (serialize serializes start_tag and end_tag provided by Typelib::Element around it's vontent, if present)
+- worked on toClass functionality with embedded templates.
+There's much to do - current impl should support:
+   * <element name="name" type="type"
+   * <element name="name"><simpleType>
+   * <element name="name"><complexType>
+
+   * <simpleType ...><list>
+   * <simpleType ...><restriction>
+
+   * <complexType ...><all>
+   * <complexType ...><sequence>
+
+All other variants are not completely supported yet.
+------------------------------------------------------------------------
+r43 | kutterma | 2007-06-25 18:58:56 +0200 (Mo, 25 Jun 2007) | 1 line
+
+- broke element again...
+------------------------------------------------------------------------
+r42 | kutterma | 2007-06-25 17:30:34 +0200 (Mo, 25 Jun 2007) | 3 lines
+
+- fixed to_typemap to report atomic simple and complex types correctly
+- update tests
+- renamed WSDLFilter to WSDLHandler
+------------------------------------------------------------------------
+r41 | kutterma | 2007-06-25 17:29:41 +0200 (Mo, 25 Jun 2007) | 1 line
+
+
+------------------------------------------------------------------------
+r40 | kutterma | 2007-06-25 14:15:40 +0200 (Mo, 25 Jun 2007) | 2 lines
+
+- Client.pm now uses XML::LibXML as default and falls back on XML::SAX::ParserFactory if not present
+- fixed tests
+------------------------------------------------------------------------
+r39 | kutterma | 2007-06-25 14:07:28 +0200 (Mo, 25 Jun 2007) | 2 lines
+
+- typo in Element
+- fixed tests
+------------------------------------------------------------------------
+r38 | kutterma | 2007-06-25 10:31:20 +0200 (Mo, 25 Jun 2007) | 2 lines
+
+- made WSDLFilter.pm a inside out class and let it run without XML::SAX::Base (This probably breaks a lot of tests - we need to implement XML::LibXML semantics in all tests / classes which use it)
+- first swag at to_typemap Typemap generation. to_typemap implemented throughout the WSDL:: modules. Some implementations (Elenenet.pm, ComplexType.pm) need further work for correctly handling atomic simpleType / complexType definitions.
+------------------------------------------------------------------------
+r37 | kutterma | 2007-06-24 09:15:22 +0200 (So, 24 Jun 2007) | 3 lines
+
+- added test for on-the-fly created ComplexType
+- fixed ComplexType factory to really work
+- startet working on Element facets
+------------------------------------------------------------------------
+r36 | kutterma | 2007-06-24 09:14:46 +0200 (So, 24 Jun 2007) | 2 lines
+
+- added test for on-the-fly created ComplexType
+- startet working on Element facets
+------------------------------------------------------------------------
+r35 | kutterma | 2007-06-24 08:13:32 +0200 (So, 24 Jun 2007) | 1 line
+
+- implemented ComplexType as class factory to get rid of the annoying START every subclass had to implement.
+------------------------------------------------------------------------
+r34 | kutterma | 2007-06-23 23:22:35 +0200 (Sa, 23 Jun 2007) | 2 lines
+
+- added XSD Typelib SimpleType, Element and ComplexType base classes (stereotypes).
+ComplexType's not yet complete (no restriction / extension etc. handling).
+------------------------------------------------------------------------
+r33 | kutterma | 2007-06-23 11:04:56 +0200 (Sa, 23 Jun 2007) | 2 lines
+
+- added SOAP::WSDL::XSD::Typelib::Builtin implementation of builtin XML Schema datatypes with built-in stringification, boolification and numerification.
+- SAX::MessageHandler now deserializes simple types in SOAP messages into SOAP::WSDL::XSD::Typelib::Builtin (provided these are named in the ClassResolver...)
+------------------------------------------------------------------------
+r32 | kutterma | 2007-06-23 02:14:16 +0200 (Sa, 23 Jun 2007) | 4 lines
+
+- added pod
+- added ref handling for elements
+- added abstract handling for elements (easy...)
+- added storing of content model (simpleContent/complexContent) to simpleType and complexType, though the attribute is still ignored in serializing
+------------------------------------------------------------------------
+r31 | kutterma | 2007-06-23 00:37:18 +0200 (Sa, 23 Jun 2007) | 1 line
+
+- renamed MessageFilter to MessageHandler
+------------------------------------------------------------------------
+r30 | kutterma | 2007-06-23 00:35:54 +0200 (Sa, 23 Jun 2007) | 1 line
+
+- renamed MessageFilter to MessageHandler
+------------------------------------------------------------------------
+r29 | kutterma | 2007-06-23 00:35:16 +0200 (Sa, 23 Jun 2007) | 2 lines
+
+- switched to Class::Std::Storable
+- renamed MessageFilter to MessageHandler
+------------------------------------------------------------------------
+r28 | kutterma | 2007-06-22 18:56:28 +0200 (Fr, 22 Jun 2007) | 3 lines
+
+- optimised SOAP::WSDL::SAX::MessageFilter for performance
+- moved Typelob into own directory and load it dynamically from test script
+- added some pod
+------------------------------------------------------------------------
+r27 | kutterma | 2007-06-22 15:34:28 +0200 (Fr, 22 Jun 2007) | 5 lines
+
+- modified SOAP::WSDL::XSD lib to allow serializing of object hierarchies
+- added SOAP::WSDL::SAX::MessageFilter for creating object hierarchies from SOAP messages
+- moved Builtin XML Schema types to SOAP::WSDL:XSD::Schema::Builtin
+- added test + benchmark for serializing /deserializing SOAP messages into object trees
+- fixed Client to use SOAP::WSDL::Types as typelib, not first SOAP::WSDL::XSD::Schema
+------------------------------------------------------------------------
+r26 | kutterma | 2007-06-21 23:35:30 +0200 (Do, 21 Jun 2007) | 2 lines
+
+- first swag at a typed SOAP Message parser.
+Typelib is still to be implemented...
+------------------------------------------------------------------------
+r25 | kutterma | 2007-06-21 18:14:49 +0200 (Do, 21 Jun 2007) | 1 line
+
+- added missing files from last commit
+------------------------------------------------------------------------
+r24 | kutterma | 2007-06-19 00:29:36 +0200 (Di, 19 Jun 2007) | 3 lines
+
+- worked a bit on explain
+- introduced handling of multiple schema definitions in one WSDL file
+- fixed propagating targetNamespace to child elements in WSDLFilter
+------------------------------------------------------------------------
+r23 | kutterma | 2007-06-16 14:48:30 +0200 (Sa, 16 Jun 2007) | 1 line
+
+- updated new SOAP::WSDL framework to use inside out classes based on Class::Std (not yet complete)
+------------------------------------------------------------------------
+r22 | kutterma | 2007-06-12 23:19:41 +0200 (Di, 12 Jun 2007) | 4 lines
+
+- updated a few tests
+- fixed a few WSDLs
+- fixed handling of elements with minOccurs 0
+- fixed setting of minOccurs/maxOccurs for all/sequence complexTypes
+------------------------------------------------------------------------
+r21 | kutterma | 2007-06-08 21:38:41 +0200 (Fr, 08 Jun 2007) | 2 lines
+
+- updated a few tests
+- fixed namespaces in tests
+------------------------------------------------------------------------
+r19 | kutterma | 2007-05-31 16:58:18 +0200 (Do, 31 Mai 2007) | 10 lines
+
+- first swag at a WSDL-generated Object-tree based SOAP client.
+
+Works as following: 
+a) a sax filter transforms the sax stream from a wsdl into a perl object tree
+b) the perl object tree has methods for performing the following tasks:
+   a) explain: Tell what services and methods are there, and how to use them
+   b) serialize: Serialize data structures to the XML defined in the WSDL & schema
+c) The client uses the generated XML to call the SOAP Server. Unfortunately, SOAP::Lite 
+does not allow custom XML to be rendered as a method's "value", so we have to replace 
+call() completely and generate the envelope on our own (which is not complete yet).
+------------------------------------------------------------------------
+r9 | kutterma | 2007-05-28 17:08:41 +0200 (Mo, 28 Mai 2007) | 1 line
+
+- first try at bindings support - see t/12/bindings on how we could find out bindings and portname from a target URL
+------------------------------------------------------------------------
+r4 | kutterma | 2007-05-28 15:15:03 +0200 (Mo, 28 Mai 2007) | 1 line
+
+- move from private repository to sourceforge
+------------------------------------------------------------------------

MANIFEST

@@ -21,6 +21,7 @@ example/lib/MyInterfaces/GlobalWeather.pm
 example/lib/MyTypemaps/FullerData_x0020_Fortune_x0020_Cookie.pm
 example/lib/MyTypemaps/GlobalWeather.pm
 example/weather.pl
+example/weather_wsdl.pl
 example/wsdl/FortuneCookie.xml
 example/wsdl/genericbarcode.xml
 example/wsdl/globalweather.xml
@@ -50,9 +51,9 @@ lib/SOAP/WSDL/SOAP/Typelib/Fault11.pm
 lib/SOAP/WSDL/SoapOperation.pm
 lib/SOAP/WSDL/TypeLookup.pm
 lib/SOAP/WSDL/Types.pm
+lib/SOAP/WSDL/XSD/Builtin.pm
 lib/SOAP/WSDL/XSD/ComplexType.pm
 lib/SOAP/WSDL/XSD/Element.pm
-lib/SOAP/WSDL/XSD/Primitive.pm
 lib/SOAP/WSDL/XSD/Schema.pm
 lib/SOAP/WSDL/XSD/Schema/Builtin.pm
 lib/SOAP/WSDL/XSD/SimpleType.pm
@@ -107,7 +108,7 @@ lib/SOAP/WSDL/XSD/Typelib/ComplexType.pm
 lib/SOAP/WSDL/XSD/Typelib/Element.pm
 lib/SOAP/WSDL/XSD/Typelib/SimpleType.pm
 LICENSE
-MANIFEST
+MANIFEST			This list of files
 META.yml
 README
 t/001_use.t
@@ -126,6 +127,7 @@ t/014_sax_typelib.t
 t/015_to_typemap.t
 t/016_client_object.t
 t/017_generator.t
+t/018_generator.t
 t/020_storable.t
 t/098_pod.t
 t/acceptance/results/03_complexType-all.xml
@@ -179,4 +181,8 @@ t/SOAP/WSDL/10_performance.t
 t/SOAP/WSDL/11_helloworld.NET.t
 t/SOAP/WSDL/12_binding.pl
 t/SOAP/WSDL/XSD/Typelib/Builtin/001_string.t
+t/SOAP/WSDL/XSD/Typelib/Builtin/002_dateTime.t
+t/SOAP/WSDL/XSD/Typelib/Builtin/002_time.t
+t/SOAP/WSDL/XSD/Typelib/Builtin/003_date.t
 TODO
+Makefile.PL

META.yml

@@ -1,21 +1,22 @@
 ---
 name: SOAP-WSDL
-version: 2.00_07
+version: 2.00_10
 author:
 abstract: SOAP with WSDL support
 license: artistic
 requires:
   Class::Std: v0.0.8
   Class::Std::Storable: 0
+  Date::Format: 0
+  Date::Parse: 0
   File::Basename: 0
   File::Path: 0
+  LWP::UserAgent: 0
   List::Util: 0
-  SOAP::Lite: 0
   XML::LibXML: 0
   XML::Parser::Expat: 0
   XML::SAX::Base: 0
   XML::SAX::ParserFactory: 0
-  XML::XPath: 0
 generated_by: Module::Build version 0.2808
 meta-spec:
   url: http://module-build.sourceforge.net/META-spec-v1.2.html
@@ -23,7 +24,7 @@ meta-spec:
 provides:
   SOAP::WSDL:
     file: lib/SOAP/WSDL.pm
-    version: 2.00_05
+    version: 2.00_10
   SOAP::WSDL::Base:
     file: lib/SOAP/WSDL/Base.pm
   SOAP::WSDL::Binding:
@@ -64,12 +65,12 @@ provides:
     file: lib/SOAP/WSDL/TypeLookup.pm
   SOAP::WSDL::Types:
     file: lib/SOAP/WSDL/Types.pm
+  SOAP::WSDL::XSD::Builtin:
+    file: lib/SOAP/WSDL/XSD/Builtin.pm
   SOAP::WSDL::XSD::ComplexType:
     file: lib/SOAP/WSDL/XSD/ComplexType.pm
   SOAP::WSDL::XSD::Element:
     file: lib/SOAP/WSDL/XSD/Element.pm
-  SOAP::WSDL::XSD::Primitive:
-    file: lib/SOAP/WSDL/XSD/Primitive.pm
   SOAP::WSDL::XSD::Schema:
     file: lib/SOAP/WSDL/XSD/Schema.pm
   SOAP::WSDL::XSD::Schema::Builtin:

Makefile.PL

@@ -0,0 +1,31 @@
+# Note: this file was auto-generated by Module::Build::Compat version 0.03
+    
+    unless (eval "use Module::Build::Compat 0.02; 1" ) {
+      print "This module requires Module::Build to install itself.\n";
+      
+      require ExtUtils::MakeMaker;
+      my $yn = ExtUtils::MakeMaker::prompt
+	('  Install Module::Build now from CPAN?', 'y');
+      
+      unless ($yn =~ /^y/i) {
+	die " *** Cannot install without Module::Build.  Exiting ...\n";
+      }
+      
+      require Cwd;
+      require File::Spec;
+      require CPAN;
+      
+      # Save this 'cause CPAN will chdir all over the place.
+      my $cwd = Cwd::cwd();
+      
+      CPAN::Shell->install('Module::Build::Compat');
+      CPAN::Shell->expand("Module", "Module::Build::Compat")->uptodate
+	or die "Couldn't install Module::Build, giving up.\n";
+      
+      chdir $cwd or die "Cannot chdir() back to $cwd: $!";
+    }
+    eval "use Module::Build::Compat 0.02; 1" or die $@;
+    
+    Module::Build::Compat->run_build_pl(args => \@ARGV);
+    require Module::Build;
+    Module::Build::Compat->write_makefile(build_class => 'Module::Build');

README

@@ -1,2 +1,26 @@
+INTRO
+-----
+
+SOAP-WSDL provides a SOAP client with WSDL support.
+
 This is a developer release - everything may (and most things will) change.
-
+
+INSTALLING
+----------
+
+Use the following mantra:
+
+ perl Build.PL
+ perl Build
+ perl Build test
+ perl Build install
+
+If you don't have Module::Build installed, you may also use 
+
+ perl Makefile.PL
+ make 
+ make test
+ make install
+
+Note that Module::Build is the recommended installer - make will not run 
+all tests provided with SOAP-WSDL.

TODO

@@ -1,14 +1,23 @@
+- support embedded atomic types by including a second (and third and fourth) 
+package type_prefix::complex_type::element_name element package.
+Allow unlimited depth (though this is rather wicked).
+- fixup generated pod so it looks nice in SOAP::WSDL::Definitions.
 - remove benchmarks from tests. Create benchmark/ directory and store benchmarks in.
-- SOAP::WSDL::Definitions::create creates bad interface docs. Fix it.
 - add tests for SOAP::WSDL::Definitions::create 
    - test for correct creation
    - test against web service (fullerdata.com?)
 - Improve docs
+   - Partially DONE
 - Remove SOAP::Lite dependency - for now, just support HTTP(s) via LWP::UserAgent.
+   - Partially DONE. SOAP::WSDL still uses SOAP::Schema
 - write inheritance Test for all XSD::Typelib::Builtin::* classes
 - Check & probably fix simpleType support. 
 The WS at http://www.webservicex.net/genericbarcode.asmx?wsdl should make up a good example for simpleType 
 definitions.
+- add default Fault11 typemap to generated typemaps
+  - DONE
+- SOAP::WSDL::Definitions::create creates bad interface docs. Fix it.
+   - DONE
 - update all Builtin Types to new constructor BEGIN block (Class::Std unfortunately is way slow)
    - DONE.
 - Remove useless (but on CPAN annoying) doc from Builtin::* classes

bin/wsdl2perl.pl

@@ -5,7 +5,7 @@ use Fcntl;
 use IO::File;
 use Pod::Usage;
 use Getopt::Long;
-use LWP::Simple qw(get);
+use LWP::UserAgent;
 use SOAP::WSDL::SAX::WSDLHandler;
 use XML::LibXML;
 
@@ -17,6 +17,7 @@ my %opt = (
   typemap_prefix => 'MyTypemaps::',
   interface_prefix => 'MyInterfaces::',
   base_path => 'lib/',
+  proxy => undef
 );
 
 GetOptions(\%opt,
@@ -29,6 +30,7 @@ GetOptions(\%opt,
     base_path|b=s
     typemap_include|mi=s
     help|h
+    proxy|x=s
   )
 );
 
@@ -40,7 +42,12 @@ pod2usage( -exit => 1 , verbose => 1 ) if not ($url);
 my $handler = SOAP::WSDL::SAX::WSDLHandler->new();
 my $parser = XML::LibXML->new();
 
-my $xml = get($url) or die "Could not load WSDL schema $url\n";
+local $ENV{HTTP_PROXY} = $opt{proxy} if $opt{proxy};
+my $lwp = LWP::UserAgent->new();
+my $response = $lwp->get($url);
+die $response->message(), "\n" if $response->code != 200;
+
+my $xml = $response->content();
 
 $parser->set_handler( $handler );
 $parser->parse_string( $xml );

example/fortune.pl

@@ -11,23 +11,37 @@
 
 use lib 'lib/';
 use MyInterfaces::FullerData_x0020_Fortune_x0020_Cookie;
-use MyElements::GetFortuneCookie;
 my $cookieService = MyInterfaces::FullerData_x0020_Fortune_x0020_Cookie->new();
 
-my $cookie = $cookieService->GetFortuneCookie();
+my $cookie;
+$cookie = $cookieService->GetFortuneCookie()
+  or die "$cookie";
 
-if ($cookie) {
+print $cookie; # ->get_GetFortuneCookieResult()->get_value, "\n";
-  print $cookie->get_GetFortuneCookieResult()->get_value, "\n";
-}
-else {
-  print $cookie;
-}
 
-$cookie = $cookieService->GetSpecificCookie({ index => 23 });
+$cookie = $cookieService->GetSpecificCookie({ index => 23 })
-if ($cookie) {
+  or die "$cookie";
-  print $cookie
+
-  ->get_GetSpecificCookieResult(), "\n";
+print $cookie->get_GetSpecificCookieResult(), "\n";
-}
+
-else {
+print $cookie;
-  print $cookie;
+
-}
+
+=for demo:
+
+# the same in SOAP lite (second call)
+#
+
+use SOAP::Lite;
+
+my $lite = SOAP::Lite->new()->on_action(sub { join '/', @_ } )
+  ->proxy('http://www.fullerdata.com/FortuneCookie/FortuneCookie.asmx');
+
+$lite->call(
+    SOAP::Data->name('GetSpecificCookie')
+      ->attr({ 'xmlns', 'http://www.fullerdata.com/FortuneCookie/FortuneCookie.asmx' }), 
+      SOAP::Data->name('index')->value(23) 
+  );
+
+die $soap->message() if ($soap->fault());
+print $soap->result();

example/lib/MyElements/GetWeatherResponse.pm

@@ -26,7 +26,6 @@ __PACKAGE__->_factory(
     {
       
         GetWeatherResult => 'SOAP::WSDL::XSD::Typelib::Builtin::string',        
-         
       
     }
 );

example/lib/MyElements/string.pm

@@ -13,7 +13,7 @@ use base qw(
 );
 
 
-sub get_xmlns { 'http://www.fullerdata.com/FortuneCookie/FortuneCookie.asmx' }
+sub get_xmlns { 'http://www.webserviceX.NET' }
 
 __PACKAGE__->__set_name('string');
 __PACKAGE__->__set_nillable(true);

example/lib/MyInterfaces/GlobalWeather.pm

@@ -38,220 +38,29 @@ http://www.webservicex.net/globalweather.asmx
  my $GetCitiesByCountry = $interface->GetCitiesByCountry();
 
 
-=head1 Service GlobalWeather
+=head1 METHODS
 
-=head2 Service information:
+=head2 GetWeather
 
- Port name: GlobalWeatherSoap
+Get weather report for all major cities around the world.
- Binding: tns:GlobalWeatherSoap
- Location: http://www.webservicex.net/globalweather.asmx
 
-=head2 SOAP Operations 
+SYNOPSIS:
 
-B<Note:>
+ $service->GetWeather({
-
- Input, output and fault messages are stated as perl hash refs. 
- 
- These are only for informational purposes - the actual implementation 
- normally uses object trees, not hash refs, though the input messages 
- may be passed to the respective methods as hash refs and will be 
- converted to object trees automatically.
-
-
-=head3 GetWeather
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
      'CityName' => $someValue,
      'CountryName' => $someValue,
-   },
+ });
- }
 
 
-B<Output Message:>
+=head2 GetCitiesByCountry
 
- {
+Get all major cities by country name(full / part).
-   'GetWeather'=> {
+
-     'CityName' => $someValue,
+SYNOPSIS:
+
+ $service->GetCitiesByCountry({
      'CountryName' => $someValue,
-   },
+ });
- }
-
-
-B<Fault:>
-
-
-
-
-=head3 GetCitiesByCountry
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Output Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Fault:>
-
-
-
-=head2 Service information:
-
- Port name: GlobalWeatherHttpGet
- Binding: tns:GlobalWeatherHttpGet
- Location: 
-
-=head2 SOAP Operations 
-
-B<Note:>
-
- Input, output and fault messages are stated as perl hash refs. 
- 
- These are only for informational purposes - the actual implementation 
- normally uses object trees, not hash refs, though the input messages 
- may be passed to the respective methods as hash refs and will be 
- converted to object trees automatically.
-
-
-=head3 GetWeather
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Output Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Fault:>
-
-
-
-
-=head3 GetCitiesByCountry
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Output Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Fault:>
-
-
-
-=head2 Service information:
-
- Port name: GlobalWeatherHttpPost
- Binding: tns:GlobalWeatherHttpPost
- Location: 
-
-=head2 SOAP Operations 
-
-B<Note:>
-
- Input, output and fault messages are stated as perl hash refs. 
- 
- These are only for informational purposes - the actual implementation 
- normally uses object trees, not hash refs, though the input messages 
- may be passed to the respective methods as hash refs and will be 
- converted to object trees automatically.
-
-
-=head3 GetWeather
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Output Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Fault:>
-
-
-
-
-=head3 GetCitiesByCountry
-
-B<Input Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Output Message:>
-
- {
-   'GetWeather'=> {
-     'CityName' => $someValue,
-     'CountryName' => $someValue,
-   },
- }
-
-
-B<Fault:>
-
-
 
 
 

example/lib/MyTypemaps/GlobalWeather.pm

@@ -3,6 +3,14 @@ use strict;
 use warnings;
 
 my %typemap = (
+# SOAP 1.1 fault typemap
+'Fault' => 'SOAP::WSDL::SOAP::Typelib::Fault11',
+'Fault/faultcode' => 'SOAP::WSDL::XSD::Typelib::Builtin::anyURI',
+'Fault/faultactor' => 'SOAP::WSDL::XSD::Typelib::Builtin::TOKEN',
+'Fault/faultstring' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+'Fault/detail' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+
+# generated typemap
 'GetWeather' => 'MyElements::GetWeather',
 # atomic complex type (sequence)
 'GetWeather/CityName' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
@@ -24,12 +32,9 @@ my %typemap = (
 'GetCitiesByCountryResponse/GetCitiesByCountryResult' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
 
 # end atomic complex type (sequence)
-Fault => 'SOAP::WSDL::SOAP::Typelib::Fault11',
+
-'Fault/faultstring' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+
-'Fault/faultcode' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+
-'Fault/faultactor' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
-'Fault/faultactor' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
-'Fault/detail' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
 
 );
 

example/weather.pl

@@ -1,19 +1,19 @@
-# Accessing the fortune cookie service at
+# Accessing the globalweather service at
 # www.webservicex.net/GlobalWeather/GlobalWeather.asmx
 #
+# Note that the GlobalWeather web service returns a (quoted) XML structure - 
+# don't be surprised by the response's format.
+#
 # I have no connection to www.webservicex.net
-# 
 # Use this script at your own risk.
+#
+# This script demonstrates the use of a interface generated by wsdl2perl.pl
 
 use lib 'lib/';
 use MyInterfaces::GlobalWeather;
-my $webservice = MyInterfaces::GlobalWeather->new();
+my $weather = MyInterfaces::GlobalWeather->new();
+my $result = $weather->GetWeather({ CountryName => 'Germany', CityName => 'Munich' });
 
-my $result = $webservice->GetWeather({ CountryName => 'Germany', CityName => 'Munich' });
+die $result->get_faultstring()->get_value() if not ($result);   # boolean comparison overloaded
 
-if ($result) {
+print $result->get_GetWeatherResult()->get_value() , "\n";
-  print $result->get_GetWeatherResult()->get_value(), "\n";
-}
-else {
-  print $result;
-}

example/weather_wsdl.pl

@@ -0,0 +1,25 @@
+# Accessing the globalweather service at
+# www.webservicex.net/GlobalWeather/GlobalWeather.asmx
+#
+# Note that the GlobalWeather web service returns a (quoted) XML structure - 
+# don't be surprised by the response's format.
+#
+# I have no connection to www.webservicex.net
+# Use this script at your own risk.
+#
+# This script demonstrates the use of SOAP::WSDL in SOAP::Lite style.
+
+use lib 'lib/';
+use lib '../lib';
+use SOAP::WSDL;
+use File::Basename qw(dirname);
+use File::Spec;
+my $path = File::Spec->rel2abs( dirname __FILE__);
+
+my $soap = SOAP::WSDL->new();
+my $som = $soap->wsdl("file:///$path/wsdl/globalweather.xml")
+  ->call('GetWeather', GetWeather => { CountryName => 'Germany', CityName => 'Munich' });
+
+die $som->message() if $som->fault();
+
+print $som->result();

lib/SOAP/WSDL.pm

@@ -1,181 +1,185 @@
 package SOAP::WSDL;
 use strict;
 use warnings;
-use vars qw/$AUTOLOAD/;
+use vars qw($AUTOLOAD);
+use Carp;
 use Scalar::Util qw(blessed);
+use SOAP::WSDL::Client;
 use SOAP::WSDL::Envelope;
 use SOAP::WSDL::SAX::WSDLHandler;
-use base qw(SOAP::Lite);
+use Class::Std;
-use Data::Dumper;
+use XML::LibXML;
+use LWP::UserAgent;
 
-our $VERSION='2.00_05';
+our $VERSION='2.00_10';
-
-BEGIN {
-    eval {
-        use XML::LibXML;
-    };
-    if ($@) {
-        use XML::SAX::ParserFactory;
-    }
-}
 
-sub AUTOLOAD {
+my %no_dispatch_of      :ATTR(:name<no_dispatch>);
-    my $method = substr($AUTOLOAD, rindex($AUTOLOAD, '::') + 2);
+my %wsdl_of             :ATTR(:name<wsdl>);
-    die "$method not found";
+my %proxy_of            :ATTR(:name<proxy>);
+my %readable_of         :ATTR(:name<readable>);
+my %autotype_of         :ATTR(:name<autotype>);
+my %outputxml_of        :ATTR(:name<outputxml>);
+my %outputtree_of       :ATTR(:name<outputtree>);
+my %outputhash_of       :ATTR(:name<outputhash>);
+my %servicename_of      :ATTR(:name<servicename>);
+my %portname_of         :ATTR(:name<portname>);
+my %class_resolver_of   :ATTR(:name<class_resolver>);
+
+my %method_info_of      :ATTR(:default<()>);
+my %port_of             :ATTR(:default<()>);
+my %porttype_of         :ATTR(:default<()>);
+my %binding_of          :ATTR(:default<()>);
+my %service_of          :ATTR(:default<()>);
+my %definitions_of      :ATTR(:get<definitions> :default<()>);
+my %serialize_options_of :ATTR(:default<()>);
+my %explain_options_of  :ATTR(:default<()>);
+
+my %client_of           :ATTR(:name<client>     :default<()>);
+
+my %LOOKUP = (
+  no_dispatch           => \%no_dispatch_of,
+  class_resolver        => \%class_resolver_of,
+  wsdl                  => \%wsdl_of,
+  proxy                 => \%proxy_of,
+  readable              => \%readable_of,
+  autotype              => \%autotype_of,
+  outputxml             => \%outputxml_of,
+  outputtree            => \%outputtree_of,
+  outputhash            => \%outputhash_of,
+  portname              => \%portname_of,
+  servicename           => \%servicename_of,
+);
+
+for my $method (keys %LOOKUP ) {
+    no strict qw(refs);
+    *{ $method } = sub {
+        my $self = shift;
+        my $ident = ident $self; 
+        if (@_) {
+            $LOOKUP{ $method }->{ $ident } = shift;
+            return $self;
+        }
+        return $LOOKUP{ $method }->{ $ident };
+    };
 }
 
-sub outputtree {
+{
-    my $self = shift;
+    # we need to roll our own for supporting
-    return $self->{ _WSDL }->{ outputtree } if not @_;
+    # SOAP::WSDL->new( key => value ) syntax, 
-    return $self->{ _WSDL }->{ outputtree } = shift;
+    # like SOAP::Lite does
-}
+    no warnings qw(redefine);
-
+    sub new {
-sub class_resolver {
+        my $class = shift;
-    my $self = shift;
+        my %args_from = @_;
-    return $self->{ _WSDL }->{ class_resolver } if not @_;
+        my  $self = \do { my $foo = undef };
-    return $self->{ _WSDL }->{ class_resolver } = shift;
+        bless $self, $class;
-}
+           
+        for (keys %args_from) {
+            my $method = $self->can("set_$_")
+                or croak "unknown parameter $_ passed to new";
+            $method->($self, $args_from{$_});
+        }
+        my $ident = ident $self;        
+        $self->wsdlinit() if ($wsdl_of{ $ident });
+        
+        $client_of{ $ident } = SOAP::WSDL::Client->new();
+        
+        return $self;
+    }
+}
 
 sub wsdlinit {
-    my $self = shift;
+    my $self = shift;
+    my $ident = ident $self;
     my %opt = @_;
-
+
-    my $wsdl_xml = SOAP::Schema->new( schema_url => $self->wsdl() )->access(
+    my $lwp = LWP::UserAgent->new();
-        $self->wsdl()
+    my $response = $lwp->get( $wsdl_of{ $ident } );
-    );
+    croak $response->message() if ($response->code != 200);
-
+
-    my $filter;
+    # TODO: Port parser to expat and remove XML::LibXML dependency
-    my $parser = eval { XML::LibXML->new() };
+    my $parser = XML::LibXML->new();
-    if ($parser) {
+    my $filter = SOAP::WSDL::SAX::WSDLHandler->new();
-            $filter   = SOAP::WSDL::SAX::WSDLHandler->new();
+    $parser->set_handler( $filter );
-        $parser->set_handler( $filter );
+    $parser->parse_string( $response->content() );
-    }
+
-    else {
+    # sanity checks
-        $filter =  SOAP::WSDL::SAX::WSDLHandler->new( base => 'XML::SAX::Base' );
+    my $wsdl_definitions = $filter->get_data() or die "unable to parse WSDL";
-        $parser = XML::SAX::ParserFactory->parser( Handler => $filter );
-    }
-
-    $parser->parse_string( $wsdl_xml );
-
-    my $wsdl_definitions = $filter->get_data()
-        or die "unable to parse WSDL";
-
     my $types = $wsdl_definitions->first_types()
         or die "unable to extract schema from WSDL";
-
     my $ns = $wsdl_definitions->get_xmlns()
         or die "unable to extract XML Namespaces" . $wsdl_definitions->to_string;
     ( %{ $ns } ) or die "unable to extract XML Namespaces";
 
     # setup lookup variables
-    $self->{ _WSDL }->{ wsdl_definitions }  = $wsdl_definitions;
+    $definitions_of{ $ident }  = $wsdl_definitions;
-    $self->{ _WSDL }->{ serialize_options } = {
+    $serialize_options_of{ $ident } = {
         autotype  => 0,
-        readable  => $self->readable(),
         typelib   => $types,
         namespace => $ns,
     };
-    $self->{ _WSDL }->{ explain_options } = {
+    $explain_options_of{ $ident } = {
         readable  => $self->readable(),
         wsdl      => $wsdl_definitions,
         namespace => $ns,
         typelib   => $types,
     };
 
-    $self->servicename($opt{servicename}) if $opt{servicename};
+    $servicename_of{ $ident } = $opt{servicename} if $opt{servicename};
-    $self->portname($opt{portname}) if $opt{portname};
+    $portname_of{ $ident } = $opt{portname} if $opt{portname};
     return $self;
 } ## end sub wsdlinit
 
-sub _wsdl_get_service {
+sub _wsdl_get_service :PRIVATE {
-        my $self = shift;
+    my $ident = ident shift;
-        my $service;
+    my $wsdl = $definitions_of{ $ident };
-        my $wsdl = $self->{ _WSDL }->{ wsdl_definitions };
+    return $service_of{ $ident } = $servicename_of{ $ident } 
-        my $ns   = $wsdl->get_targetNamespace();
+        ? $wsdl->find_service( $wsdl->get_targetNamespace() , $servicename_of{ $ident } )
-        if ( $self->{ _WSDL }->{ servicename } )
+        : $service_of{ $ident } = $wsdl->get_service()->[ 0 ];
-        {
-                $service =
-                  $wsdl->find_service( $ns, $self->{ _WSDL }->{ servicename } );
-        }
-        else
-        {
-                $service = $wsdl->get_service()->[ 0 ];
-                warn "no servicename specified - using " . $service->get_name();
-        }
-        return $self->{ _WSDL }->{ service } = $service;
 } ## end sub _wsdl_get_service
 
-sub _wsdl_get_port {
+sub _wsdl_get_port :PRIVATE  {
-        my $self    = shift;
+    my $ident = ident shift;
-        my $service = $self->{ _WSDL }->{ service }
+    my $wsdl = $definitions_of{ $ident };
-          || $self->_wsdl_get_service();
-        my $wsdl = $self->{ _WSDL }->{ wsdl_definitions };
-        my $ns   = $wsdl->get_targetNamespace();
-        my $port;
-        if ( $self->{ _WSDL }->{ portname } )
-        {
-                $port = $service->get_port( $ns, $self->{ _WSDL }->{ portname } );
-        }
-        else
-        {
-                $port = $service->get_port()->[ 0 ];
-        }
-        $self->{ _WSDL }->{ port } = $port;
-
-        # preload portType
-        $self->_wsdl_get_portType();
-
-        # Auto-set proxy - required before issuing call()
-        $self->proxy( $port->get_location() );
-
-        return $port;
-} ## end sub _wsdl_get_port
-
-sub _wsdl_get_binding {
-    my $self = shift;
-    my $wsdl = $self->{ _WSDL }->{ wsdl_definitions };
     my $ns   = $wsdl->get_targetNamespace();
-    my $port = $self->{ _WSDL }->{ port }
+    return $port_of{ $ident } = $portname_of{ $ident }
-        || $self->_wsdl_get_port();
+        ? $service_of{ $ident }->get_port( $ns, $portname_of{ $ident } )
+        : $port_of{ $ident } = $service_of{ $ident }->get_port()->[ 0 ];
+} 
 
-    my ( $prefix, $localname ) = split /:/, $port->get_binding();
+sub _wsdl_get_binding :PRIVATE {
-
+    my $self = shift;
-    # TODO lookup $ns instead of just using
+    my $ident = ident $self;
-    # the top element's targetns...
+    my $wsdl = $definitions_of{ $ident };
-    my $binding = $wsdl->find_binding( $ns, $localname )
+    my $port = $port_of{ $ident } || $self->_wsdl_get_port();
+    $binding_of{ $ident } = $wsdl->find_binding( $wsdl->_expand( $port->get_binding() ) )
         or die "no binding found for ", $port->get_binding();
-    return $self->{ _WSDL }->{ binding } = $binding;
+    return $binding_of{ $ident };
-} ## end sub _wsdl_get_binding
+} 
 
-sub _wsdl_get_portType {
+sub _wsdl_get_portType :PRIVATE {
     my $self    = shift;
-    my $wsdl    = $self->{ _WSDL }->{ wsdl_definitions };
+    my $ident   = ident $self;
-    my $binding = $self->{ _WSDL }->{ binding }
+    my $wsdl    = $definitions_of{ $ident };
-        || $self->_wsdl_get_binding();
+    my $binding = $binding_of{ $ident } || $self->_wsdl_get_binding();
-    my $ns = $wsdl->get_targetNamespace();
+    $porttype_of{ $ident } = $wsdl->find_portType( $wsdl->_expand( $binding->get_type() ) )
-    my ( $prefix, $localname ) = split /:/, $binding->get_type(); 
+        or die "cannot find portType for " . $binding->get_type();
-    my $portType = $wsdl->find_portType( $ns, $localname );
+    return $porttype_of{ $ident };
-    $self->{ _WSDL }->{ portType } = $portType;
+} 
-    return $portType;
-} ## end sub _wsdl_get_portType
 
-
+sub _wsdl_init_methods :PRIVATE {
-sub _wsdl_init_methods {
+    my $self = shift;
-    my $self = shift;
+    my $ident = ident $self;
-    my $wsdl = $self->{ _WSDL }->{ wsdl_definitions };
+    my $wsdl = $definitions_of{ $ident };
     my $ns   = $wsdl->get_targetNamespace();
 
-    # get bindings, portType, message, part(s)
+    # get bindings, portType, message, part(s) - use private methods for clear separation...
-    # - use cached values where possible for speed,
+    $self->_wsdl_get_service if not ($service_of{ $ident });
-    # private methods if not for clear separation...
+    my $binding = $binding_of{ $ident } || $self->_wsdl_get_binding()
-    my $binding = $self->{ _WSDL }->{ binding }
-       || $self->_wsdl_get_binding()
            || die "Can't find binding";
-    my $portType = $self->{ _WSDL }->{ portType }
+    my $portType = $porttype_of{ $ident } || $self->_wsdl_get_portType();
-       || $self->_wsdl_get_portType()
-           || die "Can't find portType";
 
-    my $methodHashRef = {};
+    $method_info_of{ $ident } = {};
 
     foreach my $binding_operation (@{ $binding->get_operation() })
     {
@@ -211,201 +215,59 @@ sub _wsdl_init_methods {
             }
             : undef;
 
-        $methodHashRef->{ $binding_operation->get_name() } = $method;
+        $method_info_of{ $ident }->{ $binding_operation->get_name() } = $method;
     }
-
+
-    $self->{ _WSDL }->{ methodInfo } = $methodHashRef;
+    return $method_info_of{ $ident };
-
-    return $methodHashRef;
 }
-
+
 sub call {
-    my $self = shift;
+    my $self = shift;
+    my $ident = ident $self;
     my $method = shift;
     my $data = ref $_[0] ? $_[0] : { @_ };
-
+
-    my $content = q{};
+    $self->wsdlinit() if not ($definitions_of{ $ident });
-    my $envelope;
+    $self->_wsdl_init_methods() if not ($method_info_of{ $ident });
-    my $methodInfo;
+
-
+    my $client = $client_of{ $ident };
-    if (blessed $data
+    $client->set_proxy( $proxy_of{ $ident } || $port_of{ $ident }->get_location() );
-        && $data->isa('SOAP::WSDL::XSD::Typelib::Builtin::anyType'))
+    $client->set_no_dispatch( $no_dispatch_of{ $ident } );
-    {
+    $client->set_outputxml( $outputtree_of{ $ident } ? 0 : 1 );
-        $envelope = SOAP::WSDL::Envelope->serialize( $method, $data );
+
-
+    my $response = (blessed $data) 
-        # TODO replace by something derived from binding - this is just a
+        ? $client->call( $method, $data )
-        # workaround...
+        : do {
-        $methodInfo->{ soap_action }
+            my $content = '';
-            = join '/', $data->get_xmlns(), $method;
+            # TODO support RPC-encoding: Top-Level element + namespace...
-    }
+            foreach my $part ( @{ $method_info_of{ $ident }->{ $method }->{ parts } } ) {
-    else {
+                $client->set_on_action( sub { $part->get_targetNamespace() . '/' . $_[1] } );
-        my $methodLookup = $self->{ _WSDL }->{ methodInfo }
+                $content .= $part->serialize( $method, $data, 
-            || $self->_wsdl_init_methods();
+                  {
-
+                    %{ $serialize_options_of{ $ident } },
-        $methodInfo = $methodLookup->{ $method };
+                    readable => $readable_of{ $ident },
-        my $partListRef = $methodInfo->{ parts };
+                  }  );
-
+            }
-        # set serializer options
+            $client->call($method, $content);
-        # TODO allow custom options here
+        };
-        my $opt = $self->{ _WSDL }->{ serialize_options };
+
-
+    return $response if ( 
-        # set response target namespace
+      $outputxml_of{ $ident } 
-        # TODO make rpc-encoded encoding recognise this namespace
+#      || $outputhash_of{ $ident }
-        #    $opt->{ targetNamespace } = $soap_binding_operation ?
+      || $outputtree_of{ $ident } 
-        #        $operation->input()->namespace() : undef;
+      || $no_dispatch_of{ $ident } );
-
+
-        # serialize content
+    return unless $response;    # nothing to do for one-ways
-        # TODO create surrounding element for rpc-encoded messages
+    # now convert into SOAP::SOM - bah !
-        foreach my $part ( @{ $partListRef } ) {
+    require SOAP::Lite;
-            $content .= $part->serialize( $method, $data, $opt );
+    return SOAP::Deserializer->new()->deserialize( $response );
-        }
+} 
-        $envelope = SOAP::WSDL::Envelope->serialize( $method, $content , $opt );
-    };
-
-
-    if ( $self->no_dispatch() ) {
-        return $envelope;
-    } ## end if ( $self->no_dispatch...
-
-    # get response via transport layer
-    # TODO remove dependency from SOAP::Lite and use a
-    # SAX-based filter using XML::LibXML to get the
-    # result.
-    # Filter should have the following methods:
-    # - result: returns the result of the call (like SOAP::Lite, but as
-    #           perl data structure)
-    # - header: returns the content of the SOAP header
-    # - fault:  returns the result of the call if a SOAP fault is sent back
-    #           by the server. Retuns undef (nothing) if the call has been
-    #           processed without errors.
-    my $response = $self->transport->send_receive(
-        context  => $self,              # this is provided for context
-        endpoint => $self->endpoint(),
-        action   => $methodInfo->{ soap_action },   # SOAPAction from binding
-        envelope => $envelope,          # use custom content
-    );
-
-    return $response if ($self->outputxml() );
-
-    if ($self->outputtree()) {
-
-        my ($parser, $handler);     # replace by globals - singleton is faster
-        if (not $parser) {
-            require SOAP::WSDL::SOAP::Typelib::Fault11;
-            require SOAP::WSDL::SAX::MessageHandler;
-            require XML::LibXML;
-            $handler = SOAP::WSDL::SAX::MessageHandler->new(
-                { class_resolver => $self->class_resolver() },
-            );
-            $parser = XML::LibXML->new();
-            $parser->set_handler( $handler);
-        }
-
-        # if we had no success (Transport layer error status code)
-        # or if transport layer failed
-        if (! $self->transport->is_success() ) {
-            # Try deserializing response - there may be some
-            if ($response) {
-                eval { $parser->parse_string( $response ) };
-                return $handler->get_data if not $@;
-            };
-
-            # generate & return fault if we cannot serialize response
-            # or have none...
-            return SOAP::WSDL::SOAP::Typelib::Fault11->new({
-                faultcode => 'soap:Server',
-                faultactor => 'urn:localhost',
-                faultstring => 'Error sending / receiving message: '
-                    . $self->transport->message()
-            });
-        }
-
-        eval { $parser->parse_string( $response ) };
-
-        # return fault if we cannot deserialize response
-        if ($@) {
-            return SOAP::WSDL::SOAP::Typelib::Fault11->new({
-                faultcode => 'soap:Server',
-                faultactor => 'urn:localhost',
-                faultstring => "Error deserializing message: $@. \n"
-                    . "Message was: \n$response"
-            });
-        }
-
-        return $handler->get_data();
-    }
-
-    # deserialize and store result
-    my $result = $self->{ '_call' } =
-    eval { $self->deserializer->deserialize( $response ) }
-        if $response;
-
-    if (
-        !$self->transport->is_success ||  # transport fault
-        $@                            ||  # not deserializible
-            # fault message even if transport OK
-            # or no transport error (for example, fo TCP, POP3, IO implementations)
-            UNIVERSAL::isa( $result => 'SOAP::SOM' ) && $result->fault
-    ) {
-        return $self->{ '_call' } = (
-            $self->on_fault->( $self, ($@) 
-                ? $@ . ( $response || '' ) 
-                : $result 
-            ) || $result
-        );
-    } ## end if ( !$self->transport...
-
-    return unless $response;    # nothing to do for one-ways
-    return $result;
-} ## end sub call
 
 sub explain {
-        my $self = shift;
+    my $ident = ident shift;
-        my $opt  = $self->{ _WSDL }->{ explain_options };
+    my $opt  = $explain_options_of{ $ident };
-
+    return $definitions_of{ $ident }->explain( $opt );
-        return $self->{ _WSDL }->{ wsdl_definitions }->explain( $opt );
+} 
-} ## end sub explain
-
-sub _load_method {
-    my $method = shift;
-    no strict "refs";
-    *$method = sub {
-        my $self = shift;
-        return ( @_ ) ? $self->{ _WSDL }->{ $method } = shift
-            : $self->{ _WSDL }->{ $method }
-    };
-} ## end sub _load_method
-
-&_load_method( 'no_dispatch' );
-&_load_method( 'wsdl' );
-
-sub servicename {
-        my $self = shift;
-        return $self->{ _WSDL }->{ servicename } if ( not @_ );
-        $self->{ _WSDL }->{ servicename } = shift;
-
-        my $ns = $self->{ _WSDL }->{ wsdl_definitions }->get_targetNamespace();
-
-        $self->{ _WSDL }->{ service } =
-          $self->{ _WSDL }->{ wsdl_definitions }
-          ->find_service( $ns, $self->{ _WSDL }->{ servicename } )
-          or die "No such service: " . $self->{ _WSDL }->{ servicename };
-        return $self;
-} ## end sub servicename
-
-sub portname {
-        my $self = shift;
-        return $self->{ _WSDL }->{ portname } if ( not @_ );
-        $self->{ _WSDL }->{ portname } = shift;
-
-        my $ns = $self->{ _WSDL }->{ wsdl_definitions }->get_targetNamespace();
-
-        $self->{ _WSDL }->{ port } =
-          $self->{ _WSDL }->{ service }
-          ->find_port( $ns, $self->{ _WSDL }->{ portname } )
-          or die "No such port: " . $self->{ _WSDL }->{ portname };
-        return $self;
-} ## end sub portname
 
 1;
 
@@ -416,32 +278,53 @@ __END__
 =head1 NAME
 
 SOAP::WSDL - SOAP with WSDL support
+
+=head1 Overview
+
+For creating Perl classes instrumenting a web service with a WSDL definition,
+read L<SOAP::WSDL::Manual>.
+
+For using an interpreting (thus slow and somewhat troublesome) WSDL based 
+SOAP client, which mimics L<SOAP::Lite|SOAP::Lite>'s API, read on.
 
 =head1 SYNOPSIS
 
  my $soap = SOAP::WSDL->new(
     wsdl => 'file://bla.wsdl',
     readable => 1,
- )->wsdlinit();
+ );
  
  my $result = $soap->call('MyMethod', %data);
  
 =head1 DESCRIPTION
 
-SOAP::WSDL provides easy access to Web Services with WSDL descriptions.
+SOAP::WSDL provides easy access to Web Services with WSDL descriptions.
-
+
 The WSDL is parsed and stored in memory. 
 
-Your data is serialized according to the rules in the WSDL and sent via 
+Your data is serialized according to the rules in the WSDL.
-SOAP::Lite's transport mechanism.
+
+The only transport mechanisms currently supported are http and https.
 
 =head1 METHODS
+
+=head2 new
+
+Constructor. All parameters passed are passed to the corresponding methods.
+
+=head2 call
+
+Performs a SOAP call. The result is either an object tree (with outputtree),
+a hash reference (with outputhash), plain XML (with outputxml) or a SOAP::SOM 
+object (with neither of the above set).
+
+ my $result = $soap->call('method', %data);
 
 =head2 wsdlinit
 
 Reads the WSDL file and initializes SOAP::WSDL for working with it.
 
-Must be called after the wsdl URL has been set, and before calling one of
+Is called automatically from call() if not called directly before.
 
  servicename
  portname
@@ -455,14 +338,6 @@ wsdlinit:
     portname => 'MyPort' 
  );
 
-=head2 call
-
-Performs a SOAP call. The result is either an object tree (with outputtree),
-a hash reference (with outputhash), plain XML (with outputxml) or a SOAP::SOM 
-object (with neither of the above set).
-
- my $result = $soap->call('method', %data);
-
 =head1 CONFIGURATION METHODS
 
 =head2 outputtree
@@ -515,8 +390,6 @@ SOAP::WSDL::XSD::ComplexType on how to build / generate one.
 Sets the service to operate on. If no service is set via servicename, the 
 first service found is used.
 
-Must be called after calling wsdlinit().
-
 Returns the soap object, so you can chain calls like
 
  $soap->servicename->('Name')->portname('Port');
@@ -528,8 +401,6 @@ Returns the soap object, so you can chain calls like
 Sets the port to operate on. If no port is set via portname, the 
 first port found is used.
 
-Must be called after calling wsdlinit().
-
 Returns the soap object, so you can chain calls like
 
  $soap->portname('Port')->call('MyMethod', %data);
@@ -539,12 +410,25 @@ Returns the soap object, so you can chain calls like
 When set, call() returns the plain request XML instead of dispatching the 
 SOAP call to the SOAP service. Handy for testing/debugging.
 
-=head2 _wsdl_init_methods
+=head1 ACCESS TO SOAP::WSDL's internals
-
+
-Creates a lookup table containing the information required for all methods
+=head2 get_client / set_client
-specified for the service/port selected. 
+
-
+Returns the SOAP client implementation used (normally a SOAP::WSDL::Client 
-The lookup table is used by L<call|call>.
+object).
+
+Useful for enabling tracing:
+
+ # enable tracing via 'warn'
+ $soap->get_client->set_trace(1);
+ 
+ # enable tracing via a custom facility - 
+ # Log::Log4perl in this case...
+ $soap->get_client->set_trace(sub { Log::Log4perl->get_logger->info(@_) } );
+
+=head1 EXAMPLES
+
+See the examples/ directory.
 
 =head1 Differences to previous versions
 
@@ -560,7 +444,8 @@ it's content.
 The object tree has two main functions: It knows how to serialize data passed 
 as hash ref, and how to render the WSDL elements found into perl classes.
 
-Yup your're right, there's a builting code generation facility. 
+Yup your're right, there's a builting code generation facility. Read 
+L<SOAP::WSDL::Manual> for using it.
 
 =item * no_dispatch 
 
@@ -581,33 +466,92 @@ You may pass the servicename and portname as attributes to wsdlinit, though.
 =back
 
 =head1 Differences to SOAP::Lite
+
+=head2 Message style/encoding
+
+While SOAP::Lite supports rpc/encoded style/encoding only, SOAP::WSDL currently 
+supports document/literal style/encoding.
+
+=head2 autotype / type information
+
+SOAP::Lite defaults to transmitting XML type information by default, where 
+SOAP::WSDL defaults to leaving it out. 
+
+autotype(1) might even be broken in SOAP::WSDL - it's not well-tested, yet.
+
+=head2 Output formats
+
+In contrast to SOAP::Lite, SOAP::WSDL supports the following output formats:
+
+=over
+
+=item * SOAP::SOM objects.
+
+This is the default. SOAP::Lite is required for outputting SOAP::SOM objects.
+
+=item * Object trees.
+
+This is the recommended output format. 
+You need a class resolver (typemap) for outputting object trees. 
+See L<class_resolver|class_resolver> above.
+
+=item * Hash refs
+
+This is for convnience: A single hash ref containing the content of the 
+SOAP body.
+
+=item * xml
+
+See below.
+
+=back
+
+=head2 outputxml
 
-=head2 Auto-Dispatching
+SOAP::Lite returns only the content of the SOAP body when outputxml is set
+to true. SOAP::WSDL returns the complete XML response.
+
+=head3 Auto-Dispatching
 
 SOAP::WSDL does B<does not> support auto-dispatching.
 
 This is on purpose: You may easily create interface classes by using
-SOAP::WSDL and implementing something like
+SOAP::WSDL::Client and implementing something like
 
  sub mySoapMethod {
      my $self = shift;
      $soap_wsdl_client->call( mySoapMethod, @_);
  }
 
-You may even do this in a class factory - SOAP::WSDL provides the methods
+You may even do this in a class factory - see L<wsdl2perl.pl> for creating 
-for generating such interfaces.
+such interfaces.
-
+
-SOAP::Lite's autodispatching mechanism is - though convenient - a constant
+=head3 Debugging / Tracing
-source of errors: Every typo in a method name gets caught by AUTOLOAD and
+
-may lead to unpredictable results.
+While SOAP::Lite features a global tracing facility, SOAP::WSDL 
+allows to switch tracing on/of on a per-object base.
+
+This has to be done in the SOAP client used by SOAP::WSDL - see 
+L<get_client|get_client> for an example and L<SOAP::WSDL::Client> for 
+details.
 
 =head1 Bugs and Limitations
 
 =over 
-
+
-=item * readable
+=item * SOAP Headers are not supported
-
+
-readable() must be called before calling wsdlinit. This is a bug.
+There's no way to use SOAP Headers with SOAP::WSDL yet.
+
+=item * Apache SOAP datatypes are not supported
+
+You currently can't use SOAP::WSDL with Apache SOAP datatypes like map.
+
+If you want this changed, email me a copy of the specs, please.
+
+=item * outputhash
+
+outputhash is not implemented yet.
 
 =item * Unsupported XML Schema definitions
 
@@ -619,7 +563,7 @@ The following XML Schema definitions are not supported:
  simpleContent
  complexContent
 
-=item * Serialization of hash refs dos not work for ambiguous values
+=item * Serialization of hash refs dos not work for ambiguos values
 
 If you have list elements with multiple occurences allowed, SOAP::WSDL 
 has no means of finding out which variant you meant.
@@ -629,11 +573,11 @@ Passing in item => [1,2,3] could serialize to
  <item>1 2</item><item>3</item>
  <item>1</item><item>2 3</item>
 
-Ambiguos data can be avoided by passing an object tree as data.
+Ambiguos data can be avoided by providing data as objects.
 
 =item * XML Schema facets
 
-Almost all XML schema facets are not yet implemented. The only facets 
+Almost no XML schema facets are implemented yet. The only facets 
 currently implemented are:
 
  fixed
@@ -651,7 +595,59 @@ The following facets have no influence yet:
  enumeration
 
 =back
-
+
+=head1 SEE ALSO
+
+There are lots of SOAP Clients on CPAN, lately.
+
+You may wish to look at the following:
+
+=over
+
+=item * L<SOAP::Lite|SOAP::Lite>
+
+Full featured SOAP-library, little WSDL support. Supports rpc-encoded style only. Many protocols supported.
+
+=item * L<SOAP::Message|SOAP::Message>
+
+A very basic SOAP library without transport facilities.
+
+Handy if you got your XML message ready and just need an envelope around it.
+
+=item * L<SOAP::MySOAP|SOAP::MySOAP>
+
+An extremely basic SOAP client module - just HTTP support, no encoding / decoding, 
+HTTP headers have to be set as arguments to 'new'
+
+=item * <XML::Compile::WSDL|XML::Compile::WSDL>
+
+A promising-looking approach derived from a cool functional DOM-based XML schema parser.
+
+Will support encoding/decoding of SOAP messages based on WSDL definitions.
+
+Not yet finished at the time of writing - but you may wish to give it a try, especially 
+if you need to adhere very closely to the XML Schema / WSDL specs. 
+
+=back
+
+=head1 ACKNOWLEDGMENTS
+
+There are many people out there who fostered SOAP::WSDL's developement. 
+I would like to thank them all (and apologize to all those I have forgotten).
+
+Giovanni S. Fois wrote a improved version of SOAP::WSDL (which eventually became v1.23)
+
+Damian A. Martinez Gelabert, Dennis S. Hennen, Dan Horne, Peter Orvos, Mark Overmeer, 
+Jon Robens, Isidro Vila Verde and Glenn Wood spotted bugs and/or 
+suggested improvements in the 1.2x releases.
+
+Andreas 'ACID' Specht constantly asked for better performance.
+
+Numerous people sent me their real-world WSDL files for testing. Thank you.
+
+Paul Kulchenko and Byrne Reese wrote and maintained SOAP::Lite and thus provided a 
+base (and counterpart) for SOAP::WSDL.
+
 =head1 LICENSE
 
 Copyright 2004-2007 Martin Kutter.
@@ -663,5 +659,12 @@ the same terms as perl itself
 
 Martin Kutter E<lt>martin.kutter fen-net.deE<gt>
 
+=head1 REPOSITORY INFORMATION
+
+ $Rev: 143 $
+ $LastChangedBy: kutterma $
+ $Id: WSDL.pm 143 2007-08-13 18:43:20Z kutterma $
+ $HeadURL: https://soap-wsdl.svn.sourceforge.net/svnroot/soap-wsdl/SOAP-WSDL/trunk/lib/SOAP/WSDL.pm $
+ 
 =cut
 

lib/SOAP/WSDL/Base.pm

@@ -6,7 +6,8 @@ use Class::Std::Storable;
 use List::Util qw(first);
 
 my %id_of :ATTR(:name<id> :default<()>);
-my %name_of :ATTR(:name<name> :default<()>);
+my %name_of :ATTR(:name<name> :default<()>);
+my %documentation_of :ATTR(:name<documentation> :default<()>);
 my %targetNamespace_of :ATTR(:name<targetNamespace> :default<()>);
 my %xmlns_of :ATTR(:name<xmlns> :default<{}>);
 my %parent_of :ATTR(:name<parent> :default<()>);

lib/SOAP/WSDL/Client.pm

@@ -2,26 +2,45 @@ package SOAP::WSDL::Client;
 use strict;
 use warnings;
 use Carp;
-use Scalar::Util qw(blessed);
+
-use SOAP::WSDL::Envelope;
-use SOAP::Lite;
 use Class::Std::Storable;
+use LWP::UserAgent;
+use HTTP::Request;
+use Scalar::Util qw(blessed);
+
+use SOAP::WSDL::Envelope;
 use SOAP::WSDL::Expat::MessageParser;
 use SOAP::WSDL::SOAP::Typelib::Fault11;
 
 # Package globals for speed...
 my $PARSER;
-my $MESSAGE_HANDLER;
+
-
 my %class_resolver_of   :ATTR(:name<class_resolver> :default<()>);
 my %no_dispatch_of      :ATTR(:name<no_dispatch>    :default<()>);
 my %outputxml_of        :ATTR(:name<outputxml>      :default<()>);
 my %proxy_of            :ATTR(:name<proxy>          :default<()>);
+
+my %fault_class_of      :ATTR(:name<fault_class>    :default<SOAP::WSDL::SOAP::Typelib::Fault11>);
+my %trace_of            :ATTR(:set<trace>           :init_arg<trace>    :default<()> );
+my %on_action_of        :ATTR(:name<on_action>      :default<()>);
+my %content_type_of     :ATTR(:name<content_type>   :default<text/xml; charset=utf8>);  
 
+#/#trick editors
+
 # TODO remove when preparing 2.01
 sub outputtree { warn 'outputtree is deprecated and'
     . 'will be removed before reaching v2.01 !' }
-
+
+sub get_trace {
+    my $ident = ident $_[0];
+    return $trace_of{ $ident } 
+      ? ref $trace_of{ $ident } eq 'CODE' 
+        ? $trace_of{ $ident }
+        : sub { warn @_ }
+    : ()
+}
+
+# Mimic SOAP::Lite's behaviour for getter/setter routines
 SUBFACTORY: {
     no strict qw(refs);
     for (qw(class_resolver no_dispatch outputxml proxy)) {
@@ -43,83 +62,84 @@ BEGIN {
 
 sub call {
     my $self = shift;
-    my $method = shift;
+    my $method = shift;
-    my $data = ref $_[0] ? $_[0] : { @_ };
+    my $ident = ident $self;
-    my $content = q{};
+    my $data = ref $_[0] 
-    my ($envelope, $soap_action);
+      ? $_[0] 
+      : (@_>1) 
+          ? { @_ }
+          : $_[0];
+
+    my $soap_action;
+    my $trace_sub = $self->get_trace();
+    my $envelope = SOAP::WSDL::Envelope->serialize( $method, $data );
 
     if (blessed $data
         && $data->isa('SOAP::WSDL::XSD::Typelib::Builtin::anyType'))
     {
-        $envelope = SOAP::WSDL::Envelope->serialize( $method, $data );
         # TODO replace by something derived from binding - this is just a
         # workaround...
         $soap_action = join '/', $data->get_xmlns(), $method;
     }
     else {
         $envelope = SOAP::WSDL::Envelope->serialize( $method, $data );
-        # $soap_action = $self->on_action( $method );
+        # TODO add something like SOAP::Lite's on_action mechanism
-    }
+        $soap_action = $on_action_of{$ident}->( $self, $method ) if ($on_action_of{$ident});
-    
+    }   
 
     return $envelope if $self->no_dispatch();
-    
-    # warn $envelope;
 
     # get response via transport layer
-    # TODO remove dependency from SOAP::Lite and use a
+    # maybe we should return a result with the following methods:
-    # SAX-based filter using XML::LibXML to get the
-    # result.
-    # Filter should have the following methods:
     # - result: returns the result of the call (like SOAP::Lite, but as
-    #           perl data structure)
+    #           object tree)
     # - header: returns the content of the SOAP header
     # - fault:  returns the result of the call if a SOAP fault is sent back
     #           by the server. Retuns undef (nothing) if the call has been
     #           processed without errors.
-    my $soap = SOAP::Lite->new()->proxy( $self->get_proxy() );
+    my $ua = LWP::UserAgent->new();
-	my $response = $soap->transport->send_receive(
+    my $request = HTTP::Request->new( 'POST',
-		context  => $self,              # this is provided for context
+        $self->get_proxy(),
-		endpoint => $soap->endpoint(),
+        [   'Content-Type', $content_type_of{ $ident },
-		action   => $soap_action,       # SOAPAction, should be from binding
+            'Content-Length', length($envelope),
-		envelope => $envelope,          # use custom content
+            'SOAPAction', $soap_action,
-	);
+        ],
-
+        $envelope );
-    # warn 'Received ' . length($response) . ' bytes of content';
+  
-    return $response if ($self->outputxml() );
+
+    $trace_sub->( $request->as_string() ) if $trace_of{ $ident };       # if for speed
+    my $response = $ua->request( $request );
+    $trace_sub->( $response->as_string() ) if $trace_of{ $ident };      # if for speed
+
+    return $response->content() if ($self->outputxml() );
 
     $PARSER->class_resolver( $self->get_class_resolver() );
 
     # if we had no success (Transport layer error status code)
-    # or if transport layer failed
+    # or if transport layer failed
-    if (! $soap->transport->is_success() ) {
+    if ($response->code() != 200) {
         # Try deserializing response - there may be some
-        if ($response) {
+        if ($response->content) {
-            eval { $PARSER->parse( $response ); };           
+            eval { $PARSER->parse( $response->content() ); };           
-            if ($@) {
+            return $PARSER->get_data() if (not $@);       
-                warn "could not deserialize response: $@";                    
+            warn "could not deserialize response: $@";                    
-            }
-            else {   
-                return $PARSER->get_data();
-            }
         };
         
-
-        require SOAP::WSDL::SOAP::Typelib::Fault11;
         # generate & return fault if we cannot serialize response
         # or have none...
-        return SOAP::WSDL::SOAP::Typelib::Fault11->new({
+        return $fault_class_of{$ident}->new({
             faultcode => 'soap:Server',
             faultactor => 'urn:localhost',
             faultstring => 'Error sending / receiving message: '
-                . $soap->transport->message()
+                . $response->message()
+                #$soap->transport->message()
         });
     }
-    eval { $PARSER->parse( $response ) };
+    eval { $PARSER->parse( $response->content() ) };
 
     # return fault if we cannot deserialize response
     if ($@) {
-        return SOAP::WSDL::SOAP::Typelib::Fault11->new({
+        return $fault_class_of{$ident}->new({
             faultcode => 'soap:Server',
             faultactor => 'urn:localhost',
             faultstring => "Error deserializing message: $@. \n"
@@ -133,6 +153,52 @@ sub call {
 1;
 
 =pod
+
+=head1 NAME
+
+SOAP::WSDL::Client - SOAP::WSDL's SOAP Client
+
+=head1 METHODS
+
+=head2 call
+
+=head2 Configuration methods
+
+=head3 outputxml
+
+ $soap->outputxml(1);
+
+When set, call() returns the raw XML of the SOAP Envelope.
+
+=head3 set_content_type 
+
+ $soap->set_content_type('application/xml; charset: utf8');
+
+Sets the content type and character encoding. 
+
+You probably should not use a character encoding different from utf8: 
+SOAP::WSDL::Client will not convert the request into a different encoding 
+(yet).
+
+To leave out the encoding, just set the content type without appendet charset 
+like in
+
+ text/xml
+
+Default:
+
+ text/xml; charset: utf8
+
+=head3 set_trace
+
+ $soap->set_trace(1);
+ $soap->set_trace( sub { Log::Log4perl::get_logger()->debug( @_ ) } );
+
+When set to a true value, tracing (via warn) is enabled.
+
+When set to a code reference, this function will be called on every 
+trace call, making it really easy for you to set up log4perl logging 
+or whatever you need.
 
 =head2 Features different from SOAP::Lite
 
@@ -145,7 +211,7 @@ Nonetheless SOAP::WSDL mimics part of SOAP::Lite's API and behaviour,
 so SOAP::Lite users can switch without looking up every method call in the
 documentation.
 
-A few things are quite differentl from SOAP::Lite, though:
+A few things are quite different from SOAP::Lite, though:
 
 =head3 SOAP request data
 
@@ -197,9 +263,33 @@ SOAP::WSDL::Client and implementing something like
      $soap_wsdl_client->call( mySoapMethod, @_);
  }
 
-You may even do this in a class factory - SOAP::WSDL provides the methods
+You may even do this in a class factory - see L<wsdl2perl.pl> for creating 
-for generating such interfaces.
+such interfaces.
+
+=head3 Debugging / Tracing
+
+While SOAP::Lite features a global tracing facility, SOAP::WSDL::Client 
+allows to switch tracing on/of on a per-object base.
+
+See L<set_trace|set_trace> on how to enable tracing.
 
+=head1 LICENSE
+
+Copyright 2004-2007 Martin Kutter.
+
+This file is part of SOAP-WSDL. You may distribute/modify it under 
+the same terms as perl itself
+
+=head1 AUTHOR
+
+Martin Kutter E<lt>martin.kutter fen-net.deE<gt>
+
+=head1 REPOSITORY INFORMATION
+
+ $Rev: 139 $
+ $LastChangedBy: kutterma $
+ $Id: Client.pm 139 2007-08-12 19:15:59Z kutterma $
+ $HeadURL: https://soap-wsdl.svn.sourceforge.net/svnroot/soap-wsdl/SOAP-WSDL/trunk/lib/SOAP/WSDL/Client.pm $
+ 
 =cut
 
-

lib/SOAP/WSDL/Client/Base.pm

@@ -34,10 +34,9 @@ sub __create_methods {
             $_->new( $data );
           } @{ $parts_of{ $method } };
           
-          $self->call( $method, @param );
+          return $self->SUPER::call( $method, @param );          
       }
   }
-
 }
 
 1;

lib/SOAP/WSDL/Definitions.pm

@@ -1,4 +1,5 @@
 package SOAP::WSDL::Definitions;
+use utf8;
 use strict;
 use warnings;
 use Carp;
@@ -49,8 +50,7 @@ sub explain {
     my $txt = '';
 
     for my $service (@{ $self->get_service() }) {
-        $txt .= $service->explain( $opt );
+        $txt .= $service->explain( $opt ) . "\n";
-        $txt .= "\n";
     }
     return $txt;
 }
@@ -101,49 +101,62 @@ sub create {
 sub _create_interface {
     my $self = shift;
     my $opt = shift;
-    my $service_name = $opt->{ service }->get_name();
+    my $service_name = $opt->{ service }->get_name();
-    my $file_name = "$opt->{ base_path }/$opt->{ interface_prefix }/$service_name.pm";
+    $service_name =~s{\.}{\:\:}xmsg;
-    $file_name =~s{::}{/}gms;
+    # TODO: iterate over ports.
-    my $path = dirname $file_name;
+    # - ignore non-SOAP ports
-    my $name = basename $file_name;
+    # - generate interface for all SOAP ports...
     my $binding = $self->find_binding( $self->_expand( $opt->{ service }->first_port()->get_binding() ) );
-    my $portType = $self->find_portType( $self->_expand( $binding->get_type() ) );
+    my $porttype = $self->find_portType( $self->_expand( $binding->get_type() ) );
-    my $portType_operation_from_ref = $portType->get_operation();
+    
+    my $port_operation_ref = $porttype->get_operation();
     my $operation_ref = $binding->get_operation();
-    $operation_ref = [ $operation_ref ] if ref $operation_ref ne 'ARRAY';
+   
-    my %operations = map { 
+    # make up operations map - name => [ part types / elements class names ]
-        do { 
+    #
-            my $operation_name = $_->get_name();
+    my %operations = ();
-            my $port_op = first { $_->get_name eq $operation_name } @{ $portType_operation_from_ref };
+    for my $operation ( @{ $operation_ref } ) {
-            my $input = $port_op->first_input()->get_message();
+        my $operation_name = $operation->get_name();
-            my $message = $self->find_message( $self->_expand( $input ) );
+        my $port_op = first { $_->get_name() eq $operation_name } @{ $port_operation_ref };
-            my $parts = $message->get_part;
+        
-            ( $operation_name => [
+        $operations{ $operation_name }->{ documentation } = $port_op->get_documentation();
-                  map { 
+        
-                      do {
+        my %msg_from = (
-                      my $name;
+          'input' => ($port_op->first_input() ) ? $port_op->first_input()->get_message() : undef,
-                          ($name = $_->get_element())
+          'output' => ($port_op->first_output()) ? $port_op->first_output()->get_message(): undef,
-                              ? do {
+          'fault' => ($port_op->first_fault()) ? $port_op->first_fault()->get_message() : undef,
-                                my ($prefix, $localname) = split m{:}xms , $name;
+        );
-                                "$opt->{ element_prefix }$localname";
+
-                              }
+        for my $msg (keys %msg_from) {
-                          : ($name = $_->get_type())
+            next if not $msg_from{ $msg };
-                              ? do {
+            for my $part (@{ $self->find_message( $self->_expand( $msg_from{$msg} ) )->get_part }) {
-                                my ($prefix, $localname) = split m{:}xms , $name;
+                my $name;
-                                "$opt->{ type_prefix }$localname";
+                if (my $element_name = $part->get_element() ) {
-                              }
+                    $name = $element_name;
-                              : ()
+                    push @{ $operations{ $operation_name }->{$msg}->{ types } },  
-                      }
+                        $self->first_types()->find_element( $self->_expand( $element_name ) )
-                  } @{ $parts }
+                            ->explain({ wsdl => $self , anonymous => 1 });
-            ]  );
+
-        };
+                }
-    } @{ $operation_ref };
+                elsif (my $type_name = $part->get_element() ) {
- 
+                    push @{ $operations{ $operation_name }->{$msg}->{ types } },  
-#     use Data::Dumper;
+                        $self->first_types()->find_type( $self->_expand( $element_name ) )
-#     die Dumper \%operations;
+                            ->explain({ wsdl => $self });
- 
+                    $name = $type_name;
+                }
+                my ($prefix, $localname) = split m{:}xms , $name;
+                push @{ $operations{ $operation_name }->{$msg}->{ class } },  
+                    "$opt->{ element_prefix }$localname";
+            }
+        }
+    }
+
+#    use Data::Dumper;
+#    die Dumper \%operations;
+
     my $template = <<'EOT';
-package [% interface_prefix %][% service.get_name %];
+package [% interface_prefix %][% service.get_name.replace('\.', '::') %];
+
 use strict;
 use warnings;
 use [% typemap_prefix %][% service.get_name %];
@@ -153,7 +166,7 @@ sub new {
     my $class = shift;
     my $arg_ref = shift || {};
     my $self = $class->SUPER::new({
-        class_resolver => '[% typemap_prefix %][% service.get_name %]',
+        class_resolver => '[% typemap_prefix %][% service.get_name.replace('\.', '::') %]',
         proxy => '[% service.first_port.get_location %]',
         %{ $arg_ref }
     });
@@ -162,7 +175,7 @@ sub new {
 
 __PACKAGE__->__create_methods(
       [% FOREACH name = operations.keys -%]
-        [% name %] => [ [% FOREACH class = operations.$name %]'[% class %]', [% END %]],
+        [% name %] => [ [% FOREACH class = operations.$name.input.class %]'[% class %]', [% END %]],
       [% END %]
 );
 
@@ -170,30 +183,55 @@ __PACKAGE__->__create_methods(
 
 __END__
 
-=pod
+[% MACRO pod BLOCK %]=pod[% END %]
+[% MACRO cut BLOCK %]=pod[% END %]
+[% MACRO head1 BLOCK %]=head1[% END %]
+[% MACRO head2 BLOCK %]=head2[% END %]
+[% pod %]
 
-=head1 NAME 
+[% head1 %] NAME 
 
 [% interface_prefix %][% service.get_name %] - SOAP interface to [% service.get_name %] at 
 [% service.first_port.get_location %]
 
-=head1 SYNOPSIS
+[% head1 %] SYNOPSIS
 
  my $interface = [% interface_prefix %][% service.get_name %]->new();
  my $[% operations.keys.1 %] = $interface->[% operations.keys.1 %]();
 
 
-[% service.explain({ wsdl => wsdl }) %]
+[% head1 %] METHODS
+[% FOREACH name=operations.keys;
+    operation=operations.$name;
+%]
+[% head2 %] [% name %]
 
-=cut
+[% operation.documentation %]
+
+SYNOPSIS:
+
+ $service->[% name %]({
+[% FOREACH type = operation.input.types; type; END %] });
+
+[% END %]
+
+[% cut %]
 
 EOT
 
     require Template;
+    my $file_name = "$opt->{ base_path }/$opt->{ interface_prefix }/$service_name.pm";
+    $file_name =~s{::}{/}gms;
+    my $path = dirname $file_name;
+    my $name = basename $file_name;
     my $tt = Template->new(
       OUTPUT_PATH => $path,
     );
-    $tt->process(\$template, { %{ $opt }, operations => \%operations, binding => $binding, wsdl => $self }, $name)
+    $tt->process(\$template, 
+        { %{ $opt }, operations => \%operations, binding => $binding, wsdl => $self }, 
+        $name,
+        binmode => ':utf8'
+    )
       or die $tt->error();
     return 1;
 }
@@ -203,7 +241,8 @@ EOT
 sub _create_typemap {
     my $self = shift;
     my $opt = shift;
-    my $service_name = $opt->{ service }->get_name();
+    my $service_name = $opt->{ service }->get_name();
+    $service_name =~s{\.}{\:\:}xmsg;
     my $file_name = "$opt->{ base_path }/$opt->{ typemap_prefix }/$service_name.pm";
     $file_name =~s{::}{/}gms;
     my $path = dirname $file_name;
@@ -212,11 +251,19 @@ sub _create_typemap {
     my $typemap = $opt->{ service }->to_typemap( { %{ $opt }, wsdl => $self } );
     
     my $template = <<'EOT';
-package [% typemap_prefix %][% service.get_name %];
+package [% typemap_prefix %][% service.get_name.replace('\.', '::') %];
 use strict;
 use warnings;
 
-my %typemap = (
+my %typemap = (
+# SOAP 1.1 fault typemap
+'Fault' => 'SOAP::WSDL::SOAP::Typelib::Fault11',
+'Fault/faultcode' => 'SOAP::WSDL::XSD::Typelib::Builtin::anyURI',
+'Fault/faultactor' => 'SOAP::WSDL::XSD::Typelib::Builtin::TOKEN',
+'Fault/faultstring' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+'Fault/detail' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+
+# generated typemap
 [% typemap %]
 [% custom_types %]
 );
@@ -237,7 +284,11 @@ EOT
     my $tt = Template->new(
       OUTPUT_PATH => $path,
     );
-    $tt->process(\$template, { %{ $opt }, typemap => $typemap }, $name)
+    $tt->process(\$template, 
+        { %{ $opt }, typemap => $typemap }, 
+        $name,
+        binmode => ':utf8',
+    )
       or die $tt->error();
 
 }

lib/SOAP/WSDL/Expat/MessageParser.pm

@@ -5,27 +5,8 @@ use warnings;
 use SOAP::WSDL::XSD::Typelib::Builtin;
 use XML::Parser::Expat;
 
-=pod
-
-=head2 new
-
-=over
-
-=item SYNOPSIS
-
- my $obj = ->new();
-
-=item DESCRIPTION
-
-Constructor.
-
-=back
-
-=cut
-
 sub new {
-    my $class = shift;
+    my ($class, $args) = @_;
-    my $args = shift;
     my $self = {
         class_resolver => $args->{ class_resolver }
     };
@@ -37,114 +18,135 @@ sub class_resolver {
     my $self = shift;
     $self->{ class_resolver } = shift;
 }
-
+
-sub parse {
+sub _initialize {
-	my $self = shift;
+	my ($self, $parser) = @_;
-    my $xml = shift; 
+
-	$self->{ data } = undef;
+	delete $self->{ data };
     
     my $characters;
-    my $current = '__STOP__';
+    my $current = undef;
-    my $ignore = [ 'Envelope', 'Body' ];
+    my $ignore = [ 'Envelope', 'Body' ];        # top level elements to ignore
-    my $list = [];
+    my $list = [];                              # node list
-    my $namespace = {};
+    my $path = [];                              # current path (without 
-    my $path = [];
+                                                # number)     
-    my $parser = XML::Parser::Expat->new();
+    my $skip = 0;                               # skip elements
+
+    # use "globals" for speed
+    my ($_prefix, $_localname, $_element, $_method, 
+        $_class, $_parser, %_attrs) = ();
 
     no strict qw(refs);     
     $parser->setHandlers(
         Start => sub {
-            my ($parser, $element, %attrs) = @_;
+            ($_parser, $_element, %_attrs) = @_;
-            my ($prefix, $localname) = split m{:}xms , $element;
+            ($_prefix, $_localname) = split m{:}xms , $_element;
-            # for non-prefixed elements
+
-            if (not $localname) {
+            $_localname ||= $_element;          # for non-prefixed elements
-                $localname = $element;
+
-                $prefix = q{};
-            }
             # ignore top level elements
-            if (@{ $ignore } && $localname eq $ignore->[0]) {
+            if (@{ $ignore } && $_localname eq $ignore->[0]) {
                 shift @{ $ignore };
                 return;
             }
-            # empty characters
+
-            $characters = q{};
+            push @{ $path }, $_localname;       # step down in path
-    
+            return if $skip;                    # skip inside __SKIP__
-            push @{ $path }, $localname;  # step down...
+
-            push @{ $list }, $current;    # remember current
-    
             # resolve class of this element
-            my $class = $self->{ class_resolver }->get_class( $path )
+            $_class = $self->{ class_resolver }->get_class( $path )
                 or die "Cannot resolve class for "
                     . join('/', @{ $path }) . " via $self->{ class_resolver }";
-    
+
+            # maybe write as "return $skip = join ... if (...)" ?
+            # would save a BLOCK...
+            return $skip = join('/', @{ $path }) if ($_class eq '__SKIP__');
+             
+            push @$list, $current;   # step down in tree ()remember current)
+                
+            $characters = q{};      # empty characters
+   
             # Check whether we have a primitive - we implement them as classes
-            # TODO replace with UNIVERSAL->isa()
+            # We could replace this with UNIVERSAL->isa() - but it's slow...
             # match is a bit faster if the string does not match, but WAY slower 
             # if $class matches...
-            # if (not $class=~m{^SOAP::WSDL::XSD::Typelib::Builtin}xms) {
+                    
-                
+            if (index $_class, 'SOAP::WSDL::XSD::Typelib::Builtin', 0 < 0) {           
-            if (index $class, 'SOAP::WSDL::XSD::Typelib::Builtin', 0 < 0) {           
-
                 # check wheter there is a CODE reference for $class::new.
                 # If not, require it - all classes required here MUST
                 # define new()
                 # This is the same as $class->can('new'), but it's way faster  
-                *{ "$class\::new" }{ CODE } 
+                *{ "$_class\::new" }{ CODE } 
-                    or eval "require $class"   ## no critic qw(ProhibitStringyEval)
+                    or eval "require $_class"   ## no critic qw(ProhibitStringyEval)
                         or die $@;                        
             }
-            # create object
+
-            # set current object
+            $current = $_class->new({ %_attrs });   # set new current object
-            $current = $class->new({ %attrs });
         
             # remember top level element
             defined $self->{ data } 
                 or ($self->{ data } = $current); 
         },
+        
         Char => sub {
+            return if $skip;
             $characters .= $_[1];
         },
+        
         End => sub {        
-            my $element = $_[1];
+            $_element = $_[1];
 
-            my ($prefix, $localname) = split m{:}xms , $element;
+            ($_prefix, $_localname) = split m{:}xms , $_element;          
-            # for non-prefixed elements
+            $_localname ||= $_element;          # for non-prefixed elements            
-            if (not $localname) {
+
-                $localname = $element;
+            pop @{ $path };                     # step up in path
-                $prefix = q{};
+       
+            if ($skip) {
+                return if $skip ne join '/', @{ $path }, $_localname;
+                $skip = 0;
+                return;
             }
       
             # This one easily handles ignores for us, too...
-            return if not ref $list->[-1];
+            return if not ref $$list[-1];
     
-            if ( $current
+            # set characters in current if we are a simple type
-                ->isa('SOAP::WSDL::XSD::Typelib::Builtin::anySimpleType') ) {
+            # we may have characters in complexTypes with simpleContent,
+            # too - maybe we should rely on the presence of characters ?
+            # may get a speedup by defining a ident method in anySimpleType 
+            # and looking it up via exists &$class::ident;
+            if ( $current->isa('SOAP::WSDL::XSD::Typelib::Builtin::anySimpleType') ) {
                 $current->set_value( $characters );
             }
+            # currently doesn't work, as anyType does not implement value - 
+            # maybe change ?
+#            $current->set_value( $characters ) if ($characters);
         
             # set appropriate attribute in last element
             # multiple values must be implemented in base class
-            my $method = "add_$localname";
+            $_method = "add_$_localname";
-        
+            $$list[-1]->$_method( $current );
-            $list->[-1]->$method( $current );
+                   
-        
+            $current = pop @$list;           # step up in object hierarchy...
-            # step up in path
-            pop @{ $path };
-            
-            # step up in object hierarchy...
-            $current = pop @{ $list };
         }
     );
-    
+    return $parser;
-    $parser->parse( $xml );     
+}
+
+sub parse {
+    $_[0]->_initialize( XML::Parser::Expat->new() )->parse( $_[1] );
+    return $_[0]->{ data };     
+}
+
+sub parsefile {
+    $_[0]->_initialize( XML::Parser::Expat->new() )->parsefile( $_[1] );
+    return $_[0]->{ data };     
 }
 
 sub get_data {
-    my $self = shift;
+    return $_[0]->{ data };
-    return $self->{ data };
 }
 
-
 1;
 
 =pod
@@ -167,6 +169,13 @@ Real fast expat based SOAP message parser.
 
 See L<SOAP::WSDL::Parser> for details.
 
+=head2 Skipping unwanted items
+
+Sometimes there's unneccessary information transported in SOAP messages.
+
+To skip XML nodes (including all child nodes), just edit the type map for 
+the message and set the type map entry to '__SKIP__'. 
+
 =head1 Bugs and Limitations
 
 =over

lib/SOAP/WSDL/Expat/MessageStreamParser.pm

@@ -2,148 +2,25 @@
 package SOAP::WSDL::Expat::MessageStreamParser;
 use strict;
 use warnings;
-use SOAP::WSDL::XSD::Typelib::Builtin;
 use XML::Parser::Expat;
+use SOAP::WSDL::Expat::MessageParser;
+use base qw(SOAP::WSDL::Expat::MessageParser);
 
-=pod
+sub parse_start {
-
-=head2 new
-
-=over
-
-=item SYNOPSIS
-
- my $obj = ->new();
-
-=item DESCRIPTION
-
-Constructor.
-
-=back
-
-=cut
-
-sub new {
-    my $class = shift;
-    my $self = {
-        class_resolver => shift->{ class_resolver }
-    };
-    bless $self, $class;
-    return $self;
-}
-
-sub class_resolver {
     my $self = shift;
-    $self->{ class_resolver } = shift;
+    $self->{ parser } = $_[0]->_initialize( XML::Parser::ExpatNB->new() );
 }
-
+sub init;
-sub init {
+*init = \&parse_start;
-	my $self = shift;
-    my $xml = shift; 
-	$self->{ data } = undef;
-    
-    my $characters;
-    my $current = '__STOP__';
-    my $ignore = [ 'Envelope', 'Body' ];
-    my $list = [];
-    my $namespace = {};
-    my $path = [];
-    my $parser = XML::Parser::ExpatNB->new();
 
-    no strict qw(refs);     
+sub parse_more {
-    $parser->setHandlers(
+    $_[0]->{ parser }->parse_more( $_[1] );
-        Start => sub {
-            my ($parser, $element, %attrs) = @_;
-            my ($prefix, $localname) = split m{:}xms , $element;
-            # for non-prefixed elements
-            if (not $localname) {
-                $localname = $element;
-                $prefix = q{};
-            }
-            # ignore top level elements
-            if (@{ $ignore } && $localname eq $ignore->[0]) {
-                shift @{ $ignore };
-                return;
-            }
-            # empty characters
-            $characters = q{};
-    
-            push @{ $path }, $localname;  # step down...
-            push @{ $list }, $current;    # remember current
-    
-            # resolve class of this element
-            my $class = $self->{ class_resolver }->get_class( $path )
-                or die "Cannot resolve class for "
-                    . join('/', @{ $path }) . " via $self->{ class_resolver }";
-    
-            # Check whether we have a primitive - we implement them as classes
-            # TODO replace with UNIVERSAL->isa()
-            # match is a bit faster if the string does not match, but WAY slower 
-            # if $class matches...
-            # if (not $class=~m{^SOAP::WSDL::XSD::Typelib::Builtin}xms) {
-                
-            if (index $class, 'SOAP::WSDL::XSD::Typelib::Builtin', 0 < 0) {           
-
-                # check wheter there is a CODE reference for $class::new.
-                # If not, require it - all classes required here MUST
-                # define new()
-                # This is the same as $class->can('new'), but it's way faster  
-                *{ "$class\::new" }{ CODE } 
-                    or eval "require $class"   ## no critic qw(ProhibitStringyEval)
-                        or die $@;                        
-            }
-            # create object
-            # set current object
-            $current = $class->new({ %attrs });
-        
-            # remember top level element
-            defined $self->{ data } 
-                or ($self->{ data } = $current); 
-        },
-        Char => sub {
-            $characters .= $_[1];
-        },
-        End => sub {        
-            my $element = $_[1];
-
-            my ($prefix, $localname) = split m{:}xms , $element;
-            # for non-prefixed elements
-            if (not $localname) {
-                $localname = $element;
-                $prefix = q{};
-            }
-      
-            # This one easily handles ignores for us, too...
-            return if not ref $list->[-1];
-    
-            if ( $current
-                ->isa('SOAP::WSDL::XSD::Typelib::Builtin::anySimpleType') ) {
-                $current->set_value( $characters );
-            }
-        
-            # set appropriate attribute in last element
-            # multiple values must be implemented in base class
-            my $method = "add_$localname";
-        
-            $list->[-1]->$method( $current );
-        
-            # step up in path
-            pop @{ $path };
-            
-            # step up in object hierarchy...
-            $current = pop @{ $list };
-        }
-    );
-
-    return $parser;
 }
 
-sub get_data {
+sub parse_done {
-    my $self = shift;
+    $_[0]->{ parser }->parse_done();
-    return $self->{ data };
 }
 
-
 1;
 
 =pod
@@ -174,15 +51,7 @@ See L<SOAP::WSDL::Parser> for details.
 
 =head1 Bugs and Limitations
 
-=over
+See SOAP::WSDL::Expat::MessageParser
-
-=item * Ignores all namespaces
-
-=item * Does not handle mixed content
-
-=item * The SOAP header is ignored
-
-=back
 
 =head1 AUTHOR
 

lib/SOAP/WSDL/Manual.pod

@@ -4,7 +4,7 @@
 
 SOAP::WSDL::Manual - accessing WSDL based web services
 
-=head1 Intro: Accessing a WSDL-based web service
+=head1 Accessing a WSDL-based web service
 
 =head2 Quick walk-through for the unpatient
 
@@ -57,6 +57,152 @@ classes and returned to the user as objects.
 To find out which class a particular XML node should be, SOAP::WSDL uses 
 typemaps. For every Web service, there's also a typemap created.
 
+=head2 Interface class creation
+
+To create interface classes, follow the steps above from 
+L<Quick walk-through for the unpatient|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:
+
+=over
+
+=item * Gather web service information
+
+You'll need to know at least a URL pointing to the web service's WSDL 
+definition.
+
+If you already know more - like which methods the service provides, or 
+how the XML messages look like, that's fine. All these things will help you 
+later.
+
+=item * Create WSDL bindings
+
+ perl wsdl2perl.pl -b base_dir URL 
+
+This will generate the perl bindings in the directory specified by base_dir.
+
+For more options, see L<wsdl2perl.pl> - you may want to specify class 
+prefixes for XML type and element classes, type maps and interface classes, 
+and you may even want to add custom typemap elements.
+
+=item * Check the result
+
+There should be a bunch of classes for types (in the MyTypes:: namespace by 
+default), elements (in MyElements::), and at least one typemap 
+(in MyTypemaps::) and one interface class (in MyInterfaces::).
+
+If you don't already know the details of the web service you're going to 
+instrument, it's now time to read the perldoc of the generated interface 
+classes. It will tell you what methods each service provides, and which 
+parameters they take.
+
+If the WSDL definition is informative about what these methods do, 
+the included perldoc will be, too.
+
+=item * Write a perl script (or module) accessing the web service.
+
+ use MyInterface::SERVICE_NAME;
+ my $service = MyInterface::SERVICE_NAME->new();
+ 
+ my $result = $service->SERVICE_METHOD();
+ die $result if not $result;
+ print $result;
+
+The above handling of errors ("die $result if not $result") may look a bit 
+strange - it is due to the nature of 
+L<SOAP::WSDL::SOAP::Typelib::Fault11|SOAP::WSDL::SOAP::Typelib::Fault11> 
+objects SOAP::WSDL uses for signalling failure.
+
+These objects are false in boolean context, but serialize to their XML structure 
+on stringification.
+
+You may, of course, access individual fault properties, too. To get a list of 
+fault properties, see L<SOAP::WSDL::SOAP::Typelib::Fault11>
+
+=back
+
+=head2 Adding missing information
+
+Sometimes, WSDL definitions are incomplete. In most of these cases, proper 
+fault definitions are missing. This means that though the specification sais 
+nothing about it, Fault messages include extra elements in the 
+E<lt>detailE<gt> section, or faults are even indicated by non-fault messages.
+
+There are two steps you need to perform for adding additional information.
+
+=over
+
+=item * Provide required type classes
+
+For each extra data type used in the XML messages, a type class has to be 
+created. 
+
+It is strongly discouraged to use the same namespace for hand-written and 
+generated classes - while generated classes may be many, you probably will 
+only implement a few by hand. These (precious) few classes may get lost 
+in the mass of (cheap) generated ones. Just imagine one of your co-workers 
+(or even yourself) deleting the whole bunch and re-generating everything 
+- oops - almost everything. You got the point.
+
+For simplicity, you probably just want to use builtin types wherever 
+possible - you are probably not interested in whether a fault detail's 
+error code is presented to you as a simpleType ranging from 1 to 10 
+(which you have to write) or as a int (which is a builtin type ready 
+to use). 
+
+Using builtin types for simpleType definitions may greatly reduce the 
+number of additional classes you need to implement.
+
+If the extra type classes you need include E<lt>complexType E<gt> 
+or E<lt>element /E<gt> definitions, see 
+L<SOAP::WSDL::SOAP::Typelib::ComplexType> and 
+L<SOAP::WSDL::SOAP::Typelib::Element> on how to create ComplexType 
+and Element type classes.
+
+=item * Provide a typemap snippet to wsdl2perl.pl
+
+SOAP::WSDL uses typemaps for finding out into which class' object
+a XML node should be transformed.
+
+Typemaps basically map the path of every XML element inside the Body 
+tag to a perl class.
+
+Typemap snippets have to look like this (which is actually the 
+default Fault typemap included in every generated one):
+
+ 'Fault' => 'SOAP::WSDL::SOAP::Typelib::Fault11',
+ 'Fault/faultcode' => 'SOAP::WSDL::XSD::Typelib::Builtin::anyURI',
+ 'Fault/faultactor' => 'SOAP::WSDL::XSD::Typelib::Builtin::anyURI',
+ 'Fault/faultstring' => 'SOAP::WSDL::XSD::Typelib::Builtin::string',
+ 'Fault/detail' => 'SOAP::WSDL::XSD::Typelib::Builtin::anyType',
+
+The lines are hash key - value pairs. The keys are the XPath 
+expression relative to the Body element. 
+
+If you don't know about XPath: They are just the names of the XML 
+tags, starting from the one inside E<lt>BodyE<gt> up to the current 
+one joined by /.
+
+One line for every XML node is required.
+
+You may use all builtin, generated or custom type class names as 
+values.
+
+Use wsdl2perl.pl -mi=FILE to include custom typemap snippets.
+
+Your extra statements are included last, so they override potential 
+typemap statements with the same keys.
+
+=back
+
+=head1 Accessing a web service without a WSDL definition
+
+=head1 Troubleshooting
+
+
 =head1 SEE ALSO
 
 L<SOAP::WSDL::Manual::Glossary> The meaning of all these words

lib/SOAP/WSDL/Manual/Glossary.pod

@@ -7,7 +7,7 @@ SOAP::WSDL::Manual::Glossary - Those acronyms and stuff
 =head2 web service
 
 Web services are RPC (Remote Procedure Call) interfaces accessible via 
-the internet, typically via HTTP(S). 
+some internet protocol, typically via HTTP(S). 
 
 =head2 SOAP
 
@@ -21,7 +21,7 @@ SOAP services accessible via postcards.
 
 Despite it's name, SOAP has nothing more to do with objects than 
 cars have with pets - SOAP messages may, but not neccessarily do 
-carry object, very much like your car may, but does not need to 
+carry objects, very much like your car may, but does not need to 
 carry your pet.
 
 =head2 WSDL

lib/SOAP/WSDL/Operation.pm

@@ -3,7 +3,10 @@ use strict;
 use warnings;
 use Class::Std::Storable;
 use base qw/SOAP::WSDL::Base/;
-
+
+# this class may be used for both soap::operation and wsdl::operation.
+# which one it is depends on context...
+
 my %operation_of :ATTR(:name<operation> :default<()>);
 my %input_of :ATTR(:name<input> :default<()>);
 my %output_of :ATTR(:name<output> :default<()>);

lib/SOAP/WSDL/Parser.pod

@@ -90,6 +90,29 @@ A class resolver package might look like this:
  };
  1;
 
+=head3 Skipping unwanted items
+
+Sometimes there's unneccessary information transported in SOAP messages.
+
+To skip XML nodes (including all child nodes), just edit the type map for 
+the message and set the type map entry to '__SKIP__'. 
+
+In the example above, EnqueueMessage/StuffIDontNeed and all child elements 
+are skipped.
+
+ my %class_list = (
+    'EnqueueMessage' => 'Typelib::TEnqueueMessage',
+    'EnqueueMessage/MMessage' => 'Typelib::TMessage',
+    'EnqueueMessage/MMessage/MRecipientURI' => 'SOAP::WSDL::XSD::Builtin::anyURI',
+    'EnqueueMessage/MMessage/MMessageContent' => 'SOAP::WSDL::XSD::Builtin::string',
+    'EnqueueMessage/StuffIDontNeed' => '__SKIP__',
+    'EnqueueMessage/StuffIDontNeed/Foo' => 'SOAP::WSDL::XSD::Builtin::string',
+    'EnqueueMessage/StuffIDontNeed/Bar' => 'SOAP::WSDL::XSD::Builtin::string',
+ );
+
+Note that only SOAP::WSDL::Expat::MessageParser implements skipping elements 
+at the time of writing.
+
 =head3 Creating type lib classes
 
 Every element must have a correspondent one in the type library.

lib/SOAP/WSDL/SAX/WSDLHandler.pm

@@ -3,13 +3,13 @@ use strict;
 use warnings;
 use Carp;
 use Class::Std::Storable;
-# use base qw(XML::SAX::Base);
 use SOAP::WSDL::TypeLookup;
 
 my %tree_of :ATTR(:name<tree> :default<{}>);
 my %order_of :ATTR(:name<order> :default<[]>);
 my %targetNamespace_of :ATTR(:name<targetNamespace> :default<()>);
 my %current_of :ATTR(:name<current> :default<()>);
+my %characters_of :ATTR();
 
 {
     # we have to implement our own new - we need a blessed Hash ref as $self
@@ -34,7 +34,6 @@ my %current_of :ATTR(:name<current> :default<()>);
             # ...we ignore em all...
             no strict qw(refs);
             foreach my $method ( qw(
-                characters
                 processing_instruction
                 ignorable_whitespace
                 set_document_locator
@@ -87,7 +86,8 @@ sub start_element {
         $element->{ NamespaceURI },
         $element->{ LocalName }
     );
-
+
+    $characters_of{ $ident } = q{};
     return if not $action;
     
     if ($action->{ type } eq 'CLASS') {
@@ -138,28 +138,41 @@ sub start_element {
             : values %{ $element->{ Attributes } } );
     }
 }
+
+sub characters {
+    $characters_of{ ident $_[0] } .= $_[1]->{ Data };
+}
 
 sub end_element {
-	my ($self, $element) = @_;
+    my ($self, $element) = @_;
     my $ident = ident $self;
 
-	my $action = SOAP::WSDL::TypeLookup->lookup(
+    my $action = SOAP::WSDL::TypeLookup->lookup(
-		$element->{ NamespaceURI },
+        $element->{ NamespaceURI },
-		$element->{ LocalName }
+        $element->{ LocalName }
-	) || {};
+    ) || {};
 
-	if ($action->{ type } &&  $action->{ type } eq 'CLASS' )
+    return if not ($action->{ type });
-	{
+    if ( $action->{ type } eq 'CLASS' )	{
-		$current_of{ $ident } = pop @{ $order_of{ $ident } };
+	$current_of{ $ident } = pop @{ $order_of{ $ident } };
-	}
+    }
+    elsif ($action->{ type } eq 'CONTENT' ) {
+        my $method = $action->{ method };
+        no strict qw(refs);
+        # strip of leading and trailing whitespace
+        $characters_of{ $ident } =~s{ ^ \s+ (.+) \s+ $ }{$1}xms;
+        # replace multi whitespace by one
+        $characters_of{ $ident } =~s{ \s+ }{ }xmsg;
+        $current_of{ $ident }->$method( $characters_of{ $ident } );
+    }
 }
 
 sub fatal_error {
-  die @_;
+    die @_;
 }
 
 sub get_data {
-	my $self = shift;
+    my $self = shift;
-	return $tree_of{ ident $self };
+    return $tree_of{ ident $self };
 }
 1;

lib/SOAP/WSDL/TypeLookup.pm

@@ -1,129 +1,157 @@
 package SOAP::WSDL::TypeLookup;
 
 my %TYPES = (
-	# wsdl:
+    # wsdl:
-	'http://schemas.xmlsoap.org/wsdl/' => {
+    'http://schemas.xmlsoap.org/wsdl/' => {
-		binding => {
+        binding => {
-			type => 'CLASS',
+            type => 'CLASS',
-			class => 'SOAP::WSDL::Binding',
+            class => 'SOAP::WSDL::Binding',
-		},
+        },
-		definitions => {
+        definitions => {
-			type => 'CLASS',
+            type => 'CLASS',
-			class => 'SOAP::WSDL::Definitions',
+            class => 'SOAP::WSDL::Definitions',
-		},
+        },
-		portType => {
+        portType => {
-			type => 'CLASS',
+            type => 'CLASS',
-			class => 'SOAP::WSDL::PortType',
+            class => 'SOAP::WSDL::PortType',
-		},
+        },
-		types => {
+        message => {
-			type => 'SKIP',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Message',
-		message => {
+        },
-			type => 'CLASS',
+        part => {
-			class => 'SOAP::WSDL::Message',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Part',
-		part => {
+        },
-			type => 'CLASS',
+        service => {
-			class => 'SOAP::WSDL::Part',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Service',
-		service => {
+        },
-			type => 'CLASS',
+        port => {
-			class => 'SOAP::WSDL::Service',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Port',
-		port => {
+        },
-			type => 'CLASS',
+        operation => {
-			class => 'SOAP::WSDL::Port',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Operation',
-		operation => {
+        },
-			type => 'CLASS',
+        input => {
-			class => 'SOAP::WSDL::Operation',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::OpMessage',
-		input => {
+        },
-			type => 'CLASS',
+        output => {
-			class => 'SOAP::WSDL::OpMessage',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::OpMessage',
-		output => {
+        },
-			type => 'CLASS',
+        fault => {
-			class => 'SOAP::WSDL::OpMessage',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::OpMessage',
-		fault => {
+        },
-			type => 'CLASS',
+        types => {
-			class => 'SOAP::WSDL::OpMessage',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::Types',
-		types => {
+        },
-			type => 'CLASS',
+        documentation => {
-			class => 'SOAP::WSDL::Types',
+            type => 'CONTENT',
-		}
+            method => 'set_documentation',
-	},
+        }
-	# soap:
+    },
-	'http://schemas.xmlsoap.org/wsdl/soap/' => {
+    # soap:
-		operation => {
+    'http://schemas.xmlsoap.org/wsdl/soap/' => {
-			type => 'CLASS',
+        operation => {
-			class => 'SOAP::WSDL::SoapOperation',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::SoapOperation',
-		binding => {
+        },
-			type => 'PARENT',
+        binding => {
-		},
+            type => 'PARENT',
-		body => {
+        },
-			type => 'PARENT',
+        body => {
-		},
+            type => 'PARENT',
-		address => {
+        },
-			type => 'PARENT',
+        address => {
-		}
+            type => 'PARENT',
-	},
+        }
-	'http://www.w3c.org/2001/XMLSchema' => {
+    },
-		schema => {
+    'http://www.w3.org/2001/XMLSchema' => {
-			type => 'CLASS',
+        schema => {
-			class => 'SOAP::WSDL::XSD::Schema',
+            type => 'CLASS',
-		},
+            class => 'SOAP::WSDL::XSD::Schema',
-		element => {
+        },
-			type => 'CLASS',
+        attribute => {
-			class => 'SOAP::WSDL::XSD::Element',
+            type => 'SKIP'      # not implemented yet
-		},
+        },
-		simpleType => {
+        attributeGroup => {
-			type => 'CLASS',
+            type => 'SKIP',     # not implemented yet
-			class => 'SOAP::WSDL::XSD::SimpleType',
+        },
-		},
+        key => {
-		complexType => {
+            type => 'SKIP',     # not implemented yet
-			type => 'CLASS',
+        },
-			class => 'SOAP::WSDL::XSD::ComplexType',
+        keyref => {
-		},
+            type => 'SKIP',     # not implemented yet
+        },
+        unique => {
+            type => 'SKIP',     # not implemented yet
+        },
+        notation => {
+            type => 'SKIP',     # not implemented yet
+        },      
+        annotation => {
+            type => 'SKIP',     # not implemented yet
+        },
+        appinfo => {
+            type => 'SKIP',     # not implemented yet
+        },
+        description => {
+            type => 'SKIP',     # not implemented yet
+        },
+        element => {
+            type => 'CLASS',
+            class => 'SOAP::WSDL::XSD::Element',
+        },
+        simpleType => {
+            type => 'CLASS',
+            class => 'SOAP::WSDL::XSD::SimpleType',
+        },
+        complexType => {
+            type => 'CLASS',
+            class => 'SOAP::WSDL::XSD::ComplexType',
+        },
         simpleContent => {
             type => 'METHOD',
             method => 'set_contentModel',
             value => 'simpleContent'
+        },
+        complexContent => {
+            type => 'METHOD',
+            method => 'set_contentModel',
+            value => 'complexContent'
+        },
+        restriction => {
+            type => 'METHOD',
+            method => 'set_restriction',
         },
-        complexContent => {
+        list => {
             type => 'METHOD',
-            method => 'set_contentModel',
+            method => 'set_list',
-            value => 'complexContent'
+        },
+	union => {
+            type => 'METHOD',
+            method => 'set_union',
+        },
+        enumeration => {
+            type => 'METHOD',
+            method => 'push_enumeration',
         },
-		restriction => {
-			type => 'METHOD',
-			method => 'set_restriction',
-		},
-		list => {
-			type => 'METHOD',
-			method => 'set_list',
-		},
-		union => {
-			type => 'METHOD',
-			method => 'set_union',
-		},
-		enumeration => {
-			type => 'METHOD',
-			method => 'push_enumeration',
-		},
         group => {
             type => 'METHOD',
             method => 'set_flavor',
             value => 'all',
         },
-		all => {
+	all => {
-			type => 'METHOD',
+            type => 'METHOD',
-			method => 'set_flavor',
+            method => 'set_flavor',
-            value => 'all',
+            value => 'all',
-		},
+        },
         choice => {
             type => 'METHOD',
             method => 'set_flavor',
@@ -133,16 +161,10 @@ my %TYPES = (
             type => 'METHOD',
             method => 'set_flavor',
             value => 'sequence',
-        },
+        },
-
+    },
-	},
 );
 
-# thei're equal (typo ?)
-$TYPES{	'http://www.w3.org/2001/XMLSchema' } = $TYPES{
-		'http://www.w3c.org/2001/XMLSchema'
-};
-
 
 sub lookup {
 	my $self = shift;

lib/SOAP/WSDL/XSD/Builtin.pm

@@ -0,0 +1,46 @@
+package SOAP::WSDL::XSD::Builtin;
+use strict;
+use warnings;
+use Class::Std::Storable;
+use base qw(SOAP::WSDL::Base);
+use Data::Dumper;
+
+sub serialize {
+    my ($self, $name, $value, $opt) = @_;
+    my $xml;
+    $opt->{ indent } ||= "";
+    $opt->{ attributes } ||= [];
+        
+    $xml .= $opt->{ indent } if ($opt->{ readable });
+    $xml .= '<' . join ' ', $name, @{ $opt->{ attributes } };
+    if ( $opt->{ autotype }) {
+        my $ns = $self->get_targetNamespace();
+        my $prefix = $opt->{ namespace }->{ $ns }
+            || die 'No prefix found for namespace '. $ns;
+        $xml .= ' type="' . $prefix . ':'
+          . $self->get_name() . '"' if ($self->get_name() );
+    }
+
+    if (defined $value)	{
+        $xml .= '>';
+        $xml .= "$value";
+        $xml .= '</' . $name . '>' ;
+    }
+    else {
+        $xml .= '/>';
+    }
+    $xml .= "\n" if ($opt->{ readable });
+    return $xml;
+}
+
+sub explain {
+    my ($self, $opt, $name ) = @_;
+    $opt->{ indent } = q{} if not defined $opt->{ indent };
+    return "$opt->{ indent }'$name' => \$someValue,\n"
+}
+
+sub toClass {
+    warn "# builtin";
+}
+
+1;

lib/SOAP/WSDL/XSD/ComplexType.pm

@@ -127,16 +127,15 @@ sub explain {
 
     return q{}  if not $flavor;          # empty complexType
     $opt->{ indent } ||= q{   };
-    my $xml = q{};
+    my $xml = q{};
-    $xml .= "$opt->{indent}\'$name'=> " if $name;
+    $xml .= "$opt->{indent}\'$name'=> {\n" if $name;
 
     if ( ($flavor eq "sequence") or ($flavor eq "all") ) {
-        $xml .= "{\n";
+        $opt->{ indent } .= "  ";
-        $opt->{ indent } .= "  ";
+        for my $element (@{ $self->get_element() }) {
-        $xml .= join q{}, map { $_->explain( $opt ) }
+            $xml .= $element->explain( $opt )
-            @{ $self->get_element() };
+        }
         $opt->{ indent } =~s/\s{2}$//;                     # step back
-        $xml .= "$opt->{ indent }},\n";
     }
     elsif ($flavor eq "complexContent")
     {
@@ -150,6 +149,11 @@ sub explain {
     {
         warn "found unsupported complexType definition $flavor";
     }
+
+
+    # if we're called inside a element...
+    $xml .= "$opt->{indent}},\n" if $name;
+
     return $xml;
 }
 
@@ -188,17 +192,17 @@ my %[% element.get_name %]_of :ATTR(:get<[% element.get_name %]>);
 [% END %]
 
 __PACKAGE__->_factory(
-    [ qw([% FOREACH element=self.get_element -%] 
+    [ qw([% FOREACH element=self.get_element -%]
-    [% element.get_name %] 
+    [% element.get_name %]
     [% END %]) ],
-    { 
+    {
-      [% FOREACH element=self.get_element %][% element.get_name %] => \%[% element.get_name %]_of, 
+      [% FOREACH element=self.get_element %][% element.get_name %] => \%[% element.get_name %]_of,
-      [% END %]  
+      [% END %]
     },
     {
-[%- 
+[%-
       FOREACH element=self.get_element;
-        IF (element.get_type);
+        IF (element.get_type);      # element type="..."
           split_name = element.get_type.split(':');
           prefix = split_name.0;
           localname = split_name.1;
@@ -206,8 +210,13 @@ __PACKAGE__->_factory(
       [% element.get_name %] => 'SOAP::WSDL::XSD::Typelib::Builtin::[% localname %]',
 [%        ELSE -%]
       [% element.get_name %] => '[% type_prefix %][% localname %]',
-[%-       END;
+[%-       END;
-        ELSIF (simpleType = element.first_simpleType); 
+        ELSIF (element.get_ref);    # element ref="..."
+          split_name = element.get_ref.split(':');
+          prefix = split_name.0;
+          localname = split_name.1; %]
+      [% element.get_name %] => '[% type_prefix %][% localname %]',          
+[%        ELSIF (simpleType = element.first_simpleType); 
           base = simpleType.get_base();
 %]
       # basic simple type handling: we treat atomic simple types 
@@ -233,18 +242,25 @@ sub get_xmlns { '[% self.get_targetNamespace %]' }
 1;
 
 __END__
+
+[% MACRO pod BLOCK %]=pod[% END %]
+[% MACRO cut BLOCK %]=cut[% END %]
+[% MACRO head1 BLOCK %]=head1[% END %]
+[% MACRO head2 BLOCK %]=head2[% END %]
+
+[% pod %]
+
+[% head1 %] NAME 
+
+[% type_prefix %][% self.get_name %]
 
-=pod
+[% head1 %] SYNOPSIS
 
-=head1 NAME [% type_prefix %][% self.get_name %]
+[% head1 %] DESCRIPTION
-
-=head1 SYNOPSIS
-
-=head1 DESCRIPTION
 
 Type class for the XML type [% self.get_name %]. 
 
-=head1 PROPERTIES
+[% head1 %] PROPERTIES
 
 The following properties may be accessed using get_PROPERTY / set_PROPERTY 
 methods:
@@ -265,7 +281,12 @@ methods:
 [%        ELSE -%]
       [% element.get_name %] => '[% type_prefix %][% localname %]',
 [%-       END;
-        ELSIF (simpleType = element.first_simpleType); 
+        ELSIF (element.get_ref);    # element ref="..."
+          split_name = element.get_ref.split(':');
+          prefix = split_name.0;
+          localname = split_name.1; %]
+      [% element.get_name %] => '[% type_prefix %][% localname %]',          
+[%      ELSIF (simpleType = element.first_simpleType); 
           base = simpleType.get_base();
           split_name = base.split(':');
           prefix = split_name.0;
@@ -288,7 +309,7 @@ Structure as perl hash:
 
  [% structure %]
 
-=cut
+[% cut %]
 
 EOT
 
@@ -300,26 +321,3 @@ sub _check_value {
 }
 1;
 
-=pod
-
-=head1 Bugs and limitations
-
-=over
-
-=item * attribute definitions
-
-Attribute definitions are ignored
-
-=item * abstract, block, final, mixed
-
-Handling of these attribute is not implemented yet.
-
-=item * simpleContent, complexContent, extension, restriction, group, choice
-
-Handling of these child elements is not implemented yet
-
-=item * explain may produce erroneous results
-
-=back
-
-=cut

lib/SOAP/WSDL/XSD/Element.pm

@@ -90,8 +90,8 @@ sub serialize {
     elsif (my $ref_name = $ref_of{ $ident }) {              # ref
         my ($prefix, $localname) = split /:/ , $ref_name;
         my $ns = $ns_map{ $prefix };
-        $type = $typelib->find_type( $ns, $localname );
+        $type = $typelib->find_element( $ns, $localname );
-        die "no type for $prefix:$localname" if (not $type);
+        die "no element for ref $prefix:$localname" if (not $type);
         return $type->serialize( $name, $value, $opt );
     }
 
@@ -111,19 +111,31 @@ sub serialize {
 sub explain {
 	my ($self, $opt, $name) = @_;
 	my $type;
-    my $text = q{};
+        my $text = q{};
 
 	# if we have a simple / complexType, explain right here
 	if ($type = $self->first_simpleType() )
 	{
-		$text .= $type->explain( $opt, $self->get_name() );
+            if ($opt->{ anonymous }) {
-		return $text;
+                delete $opt->{ anonymous };
+                return $type->explain( $opt, undef );
+            }
+            return $type->explain( $opt, $self->get_name() );
 	}
 	elsif ($type = $self->first_complexType() )
 	{
-		$text .= $type->explain( $opt, $self->get_name() );
+            if ($opt->{ anonymous }) {
-		return $text;
+                delete $opt->{ anonymous };
+                return $type->explain( $opt, undef );
+            }
+            return $type->explain( $opt, $self->get_name() );
 	}
+        elsif (my $element_name = $self->get_ref() ) {
+            my $element = $opt->{ wsdl }->first_types()->find_element(
+                $opt->{ wsdl }->_expand( $element_name )
+            );
+            return $element->explain( $opt, $self->get_name() );
+        }
 
 	# return if it's not a derived type - we don't handle
 	# other stuff yet.
@@ -137,13 +149,16 @@ sub explain {
 		$ns_map{ $prefix }, $localname
 	);
 
-    use Data::Dumper;
+        use Data::Dumper;
 	die "no type for $prefix:$localname ($ns_map{ $prefix })" 
 	   . Dumper $opt->{ wsdl }->first_types()->first_schema()->_DUMP
-	
+            if (not $type);
-	if (not $type);
+
-
+        if ($opt->{ anonymous }) {
-	return $text .= $type->explain( $opt, $self->get_name() );
+            delete $opt->{ anonymous };
+            return $text .= $type->explain( $opt, undef );
+        }
+	return $text .= $type->explain( $opt, $name || $self->get_name() );
 	return 'ERROR: '. $@;
 }
 
@@ -231,6 +246,7 @@ package [% element_prefix %][% self.get_name %];
 use strict;
 use Class::Std::Storable;
 use SOAP::WSDL::XSD::Typelib::Element;
+
 [% IF (type = self.first_simpleType) %]
 # <element name="[% self.get_name %]"><simpleType> definition
 use SOAP::WSDL::XSD::Typelib::SimpleType;
@@ -240,6 +256,17 @@ use base qw(
     [% type.flavor_class %]
     [% type.base_class($type_prefix) %]
 );
+[% ELSIF (ref_name = self.get_ref);
+    split_name = ref_name.split(':');
+    prefix = split_name.0;
+    localname = split_name.1;
+    ref_class = element_prefix _ localname;
+%]    
+# <element name="[% self.get_name %]" ref="[% ref_name %]"> definition
+# use [% ref_class %];
+use base qw(
+    [% ref_class %]
+);
 [% ELSIF (type = self.first_complexType) %]
 # atomic complexType
 # <element name="[% self.get_name %]"><complexType> definition
@@ -254,7 +281,7 @@ my %[% element.get_name %]_of :ATTR(:get<[% element.get_name %]>);
 [%      END %]
 
 __PACKAGE__->_factory(
-    [ qw([% FOREACH element = type.get_element %] 
+    [ qw([% FOREACH element = type.get_element %]
     [% element.get_name %]
     [% END %]) ],
     { 
@@ -267,10 +294,10 @@ __PACKAGE__->_factory(
         prefix = split_name.0;
         localname = split_name.1;
         IF nsmap.$prefix == 'http://www.w3.org/2001/XMLSchema' %]
-        [% element.get_name %] => 'SOAP::WSDL::XSD::Typelib::Builtin::[% localname %]',        
+        [% element.get_name %] => 'SOAP::WSDL::XSD::Typelib::Builtin::[% localname %]',
         [% ELSE %]
         [% element.get_name %] => '[% type_prefix %][% localname %]',
-        [% END %] 
+        [% END %]
       [% END %]
     }
 );
@@ -295,10 +322,6 @@ use base qw(
     SOAP::WSDL::XSD::Typelib::Element
     [% base_class %]
 );
-[% ELSIF (element = self.get_ref) 
-%]
-#   element ref"element" definition
-#   Sorry, we don't handle this yet... 
 [% END %]
 
 sub get_xmlns { '[% self.get_targetNamespace %]' }
@@ -313,18 +336,25 @@ __PACKAGE__->__set_ref('[% self.get_ref %]');
 
 
 __END__
+
+[% MACRO pod BLOCK %]=pod[% END %]
+[% MACRO cut BLOCK %]=cut[% END %]
+[% MACRO head1 BLOCK %]=head1[% END %]
+[% MACRO head2 BLOCK %]=head2[% END %]
+
+[% pod %]
+
+[% head1 %] NAME 
 
-=pod
+[% element_prefix %][% self.get_name %]
 
-=head1 NAME [% element_prefix %][% self.get_name %]
+[% head1 %] SYNOPSIS
 
-=head1 SYNOPSIS
+[% head1 %] DESCRIPTION
-
-=head1 DESCRIPTION
 
 Type class for the XML element [% self.get_name %]. 
 
-=head1 PROPERTIES
+[% head1 %] PROPERTIES
 
 The following properties may be accessed using get_PROPERTY / set_PROPERTY 
 methods:
@@ -335,7 +365,7 @@ methods:
 [%      END;
 END %]
 
-=head1 Object structure
+[% head1 %] Object structure
 
 [%- IF (type = self.first_complexType);
       FOREACH element = type.get_element;
@@ -359,8 +389,8 @@ Structure as perl hash:
  tree.
 
  [% structure %]
-
+
-=cut
+[% cut %]
 
 EOT
     
@@ -369,47 +399,4 @@ EOT
 
 1;
 
-__END__
 
-=pod
-
-=head1 NAME
-
-SOAP::WSDL::XSD::Element - XSD Element representation
-
-=head1 DESCRIPTION
-
-Represents a XML Schema Definition's Element element for serializing into
-various forms.
-
-=head1 Bugs and limitations
-
-=over
-
-=item * block
-
-Handling of the block attribute is not implemented yet.
-
-=item * final
-
-Handling of the final attribute is not implemented yet.
-
-=item * substitutionGroup
-
-Handling of the substitutionGroup attribute is not implemented yet
-
-=item * explain may produce erroneous results
-
-=back
-
-=head1 COPYING
-
-This module is part of SOAP-WSDL. See SOAP::WSDL for license.
-
-=head1 AUTHOR
-
-Insert @ instead of whitespace into e-mail.
-
- Martin Kutter E<lt>martin.kutter fen-net.deE<gt>
-
-=cut

lib/SOAP/WSDL/XSD/Primitive.pm

@@ -1,50 +0,0 @@
-package SOAP::WSDL::XSD::Primitive;
-use strict;
-use warnings;
-use Class::Std::Storable;
-use base qw(SOAP::WSDL::Base);
-use Data::Dumper;
-
-sub serialize
-{
-	my ($self, $name, $value, $opt) = @_;
-	my $xml;
-	$opt->{ indent } ||= "";
-        $opt->{ attributes } ||= [];
-        
-	$xml .= $opt->{ indent } if ($opt->{ readable });
-	$xml .= '<' . join ' ', $name, @{ $opt->{ attributes } };
-	if ( $opt->{ autotype })
-	{
-		my $ns = $self->get_targetNamespace();
-		my $prefix = $opt->{ namespace }->{ $ns }
-			|| die 'No prefix found for namespace '. $ns;
-		$xml .= ' type="' . $prefix . ':'
-			. $self->get_name() . '"' if ($self->get_name() );
-	}
-
-	if (defined $value)
-	{
-		$xml .= '>';
-		$xml .= "$value";
-		$xml .= '</' . $name . '>' ;
-	}
-	else
-	{
-		$xml .= '/>';
-	}
-	$xml .= "\n" if ($opt->{ readable });
-	return $xml;
-}
-
-sub explain
-{
-	my ($self, $opt, $name ) = @_;
-	$opt->{ indent } ||= "";
-	return "$opt->{ indent }'$name' => \$someValue,\n"
-}
-
-sub toClass {
-    warn "# primitive";
-}
-1;

lib/SOAP/WSDL/XSD/Schema.pm

@@ -7,6 +7,7 @@ use base qw(SOAP::WSDL::Base);
 # child elements
 my %type_of :ATTR(:name<type> :default<[]>);
 my %element_of :ATTR(:name<element> :default<[]>);
+my %group_of :ATTR(:name<group> :default<[]>);
 
 # attributes
 my %attributeFormDefault_of :ATTR(:name<attributeFormDefault> :default<()>);

lib/SOAP/WSDL/XSD/Schema/Builtin.pm

@@ -3,11 +3,11 @@ use strict;
 use warnings;
 use Class::Std::Storable;
 use SOAP::WSDL::XSD::Schema;
-use SOAP::WSDL::XSD::Primitive;
+use SOAP::WSDL::XSD::Builtin;
 use base qw(SOAP::WSDL::XSD::Schema);
 
 # all builtin types - add validation (e.g. content restrictions) later...
-my %PRIMITIVES = (
+my %BUILTINS = (
 	'string' => {},
 	'boolean' => {},
 	'decimal' => {},
@@ -50,9 +50,9 @@ sub START {
 	my $self = shift;
 	my @args = @_;
 
-	while (my ($name, $value) = each %PRIMITIVES )
+	while (my ($name, $value) = each %BUILTINS )
 	{
-		$self->push_type( SOAP::WSDL::XSD::Primitive->new({
+		$self->push_type( SOAP::WSDL::XSD::Builtin->new({
                 name => $name,
                 targetNamespace => 'http://www.w3.org/2001/XMLSchema',
             } )

lib/SOAP/WSDL/XSD/SimpleType.pm

@@ -43,8 +43,7 @@ sub set_union {
     }
 }
 
-sub push_enumeration
+sub push_enumeration {
-{
 	my $self = shift;
 	my @attr = @_;
 	my @attributes = @_;
@@ -101,13 +100,9 @@ sub _serialize_single {
 }
 
 sub explain {
-    my ($self, $opt, $name) = @_;
+	my ($self, $opt, $name ) = @_;
-    my $perl;
+	$opt->{ indent } = q{} if not defined $opt->{ indent };
-    $opt->{ indent } ||= "";
+	return "$opt->{ indent }'$name' => \$someValue,\n"
-    $perl .= $opt->{ indent } if ($opt->{ readable });
-    $perl .= q{'} . $name . q{' => $someValue };
-    $perl .= "\n" if ($opt->{ readable });
-    return $perl;
 }
 
 sub _check_value {
@@ -155,25 +150,4 @@ EOT
     return $code;
 }
 
-
 1;
-
-=pod
-
-=head1 Bugs and limitations
-
-=over
-
-=item * simpleContent, complexContent
-
-These child elements are not implemented yet
-
-=item * union
-
-union simpleType definitions probalbly serialize wrong
-
-=item * explain may produce erroneous results
-
-=back
-
-=cut

lib/SOAP/WSDL/XSD/Typelib/Builtin.pm

@@ -205,7 +205,26 @@ byte integer objects.
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::date
 
+date values are automatically converted into XML date strings during setting:
+
+ YYYY-MM-DD+zz:zz
+
+The time zone is set to the local time zone if not included.
+
+All input variants supported by Date::Parse are supported. You may even pass 
+in dateTime strings - the time part will be ignored. Note that 
+set_value is around 100 times slower when setting non-XML-time strings
+
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::dateTime
+
+dateTime values are automatically converted into XML dateTime strings during setting:
+
+ YYYY-MM-DDThh:mm:ss.nnnnnnn+zz:zz
+
+The optional nanoseconds parts is excluded in converted values, as it would always be 0.
+
+All input variants supported by Date::Parse are supported. Note that 
+set_value is around 100 times slower when setting non-XML-time strings
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::decimal
 
@@ -237,6 +256,8 @@ decimal is the base of all non-float numbers
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::IDREFS
 
+List of SOAP::WSDL::XSD::Typelib::Builtin::IDREF objects.
+
 Derived by SOAP::WSDL::XSD::Typelib::Builtin::list.
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::int
@@ -273,6 +294,18 @@ Derived by SOAP::WSDL::XSD::Typelib::Builtin::list.
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::time
 
+time values are automatically converted into XML time strings during setting:
+
+ hh:mm:ss.nnnnnnn+zz:zz
+ hh:mm:ss+zz:zz
+
+The time zone is set to the local time zone if not included. The optional 
+nanoseconds part is not included in converted values, as it would always be 0.
+
+All input variants supported by Date::Parse are supported. You may even pass 
+in dateTime strings - the date part will be ignored. Note that 
+set_value is around 100 times slower when setting non-XML-time strings
+
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::token
 
 =head2 SOAP::WSDL::XSD::Typelib::Builtin::unsignedByte

lib/SOAP/WSDL/XSD/Typelib/Builtin/anySimpleType.pm

@@ -29,6 +29,13 @@ sub as_bool :BOOLIFY {
     return $value_of { ident $_[0] };
 }
 
+sub _get_handlers {
+    my $parser = $_[1];
+    return {
+        Char => $parser->characters(),
+    }
+}
+
 Class::Std::initialize();   # make :BOOLIFY overloading serializable
 
 

lib/SOAP/WSDL/XSD/Typelib/Builtin/boolean.pm

@@ -40,7 +40,7 @@ sub serialize {
         , $self->end_tag($opt);
 }
 
-sub as_num :NUMERIFY {
+sub as_num :NUMERIFY :BOOLIFY {
     return $_[0]->get_value();
 }
 

lib/SOAP/WSDL/XSD/Typelib/Builtin/date.pm

@@ -2,6 +2,9 @@ package SOAP::WSDL::XSD::Typelib::Builtin::date;
 use strict;
 use warnings;
 
+use Date::Parse;
+use Date::Format;
+
 my %pattern_of          :ATTR(:name<pattern> :default<()>);
 my %enumeration_of      :ATTR(:name<enumeration> :default<()>);
 my %whiteSpace_of       :ATTR(:name<whiteSpace> :default<()>);
@@ -31,5 +34,32 @@ BEGIN {
 
 }
 
+sub set_value {
+    # use set_value from base class if we have a XML-DateTime format
+    #2037-12-31+01:00
+    if (
+        $_[1] =~ m{ ^\d{4} \- \d{2} \- \d{2} 
+            (:? [\+\-] \d{2} \: \d{2} )?$
+        }xms       
+    ) {
+        $_[0]->SUPER::set_value($_[1])
+    }
+    # use a combination of strptime and strftime for converting the date
+    # Unfortunately, strftime outputs the time zone as [+-]0000, whereas XML
+    # whants it as [+-]00:00
+    # We know that the latter part of the TZ is always :00 (there's no time 
+    # zone whith minute offset yet), so we just use substr to get the part 
+    # up to the last 2 timezone digits and append :00
+    # We leave out the optional nanoseconds part, as it would always be empty.
+    else {
+        # strptime sets empty values to undef - and strftime doesn't like that...
+        my @time_from = map { ! defined $_ ? 0 : $_ } strptime($_[1]);
+        my $time_str = strftime( '%Y-%m-%d%z', @time_from );
+        substr $time_str, -2, 0, ':';
+        $_[0]->SUPER::set_value($time_str);
+
+    }
+}
+
 1;
 

lib/SOAP/WSDL/XSD/Typelib/Builtin/dateTime.pm

@@ -3,6 +3,8 @@ use strict;
 use warnings;
 use Class::Std::Storable;
 use base qw(SOAP::WSDL::XSD::Typelib::Builtin::anySimpleType);
+use Date::Parse;
+use Date::Format;
 
 my %pattern_of          :ATTR(:name<pattern> :default<()>);
 my %enumeration_of      :ATTR(:name<enumeration> :default<()>);
@@ -30,8 +32,34 @@ BEGIN {
         }
         return $self;
     };
-
 }
-
+
-
+sub set_value {
+    # use set_value from base class if we have a XML-DateTime format
+    #2037-12-31T00:00:00.0000000+01:00
+    if (
+        $_[1] =~ m{ ^\d{4} \- \d{2} \- \d{2} 
+            T \d{2} \: \d{2} \: \d{2} (:? \. \d{1,7} )?
+            [\+\-] \d{2} \: \d{2} $
+        }xms       
+    ) {
+        $_[0]->SUPER::set_value($_[1])
+    }
+    # use a combination of strptime and strftime for converting the date
+    # strptime does not emit timezone info, so we're pretty fucked up here.
+    # 
+    # Unfortunately, strftime outputs the time zone as [+-]0000, whereas XML
+    # whants it as [+-]00:00
+    # We leave out the optional nanoseconds part, as it would always be empty.
+    else {
+        # strptime sets empty values to undef - and strftime doesn't like that...
+        my @time_from = map { ! defined $_ ? 0 : $_ } strptime($_[1]);
+        undef $time_from[-1];
+        
+        my $time_str = strftime( '%Y-%m-%dT%H:%M:%S%z', @time_from );
+        substr $time_str, -2, 0, ':';
+        $_[0]->SUPER::set_value($time_str);
+    }
+}
+
 1;

lib/SOAP/WSDL/XSD/Typelib/Builtin/time.pm

@@ -1,6 +1,8 @@
 package SOAP::WSDL::XSD::Typelib::Builtin::time;
 use strict;
 use warnings;
+use Date::Parse;
+use Date::Format;
 
 my %pattern_of          :ATTR(:name<pattern> :default<()>);
 my %enumeration_of      :ATTR(:name<enumeration> :default<()>);
@@ -30,4 +32,30 @@ BEGIN {
     };
 }
 
+sub set_value {
+    # use set_value from base class if we have a XML-Time format
+    # 00:00:00.0000000+01:00
+    if (
+        $_[1] =~ m{ ^ \d{2} \: \d{2} \: \d{2} (:? \. \d{1,7} )?
+            [\+\-] \d{2} \: \d{2} $
+        }xms       
+    ) {
+        $_[0]->SUPER::set_value($_[1])
+    }
+    # use a combination of strptime and strftime for converting the date
+    # Unfortunately, strftime outputs the time zone as [+-]0000, whereas XML
+    # whants it as [+-]00:00
+    # We leave out the optional nanoseconds part, as it would always be empty.
+    else {
+        # strptime sets empty values to undef - and strftime doesn't like that...
+        # we even need to set it to 1 to prevent a "Day '0' out of range 1..31" warning...
+        my @time_from = map { ! defined $_ ? 1 : $_ } strptime($_[1]);
+        my $time_str = strftime( '%H:%M:%S%z', @time_from );
+        substr $time_str, -2, 0, ':';
+        $_[0]->SUPER::set_value($time_str);
+
+    }
+}
+
+
 1;

lib/SOAP/WSDL/XSD/Typelib/Builtin/unsignedLong.pm

@@ -22,26 +22,3 @@ BEGIN {
     };
 }
 1;
-
-__END__
-
-=pod
-
-=head1 NAME
-
-SOAP::WSDL::XSD::Typelib::Builtin::unsignedLong - unsigned long integer objects
-
-=head1 DESCRIPTION
-
-Subclass of nonNegativeInteger.
-
-=head1 LICENSE
-
-This file is part of SOAP-WSDL. You may distribute/modify it under 
-the same terms as perl itself
-
-=head1 AUTHOR
-
-Martin Kutter E<lt>martin.kutter fen-net.deE<gt>
-
-=cut

lib/SOAP/WSDL/XSD/Typelib/ComplexType.pm

@@ -1,11 +1,11 @@
 #!/usr/bin/perl
 package SOAP::WSDL::XSD::Typelib::ComplexType;
 use strict;
+use warnings;
 use Carp;
 use SOAP::WSDL::XSD::Typelib::Builtin;
 use Scalar::Util qw(blessed);
 use Class::Std::Storable;
-
 use Data::Dumper;
 
 use base qw(SOAP::WSDL::XSD::Typelib::Builtin::anyType);
@@ -29,131 +29,147 @@ sub _factory {
         my $type = $CLASSES_OF{ $class }->{ $name }
             or die "No class given for $name";
 
+        # require all types here
         $type->isa('UNIVERSAL')
             or eval "require $type" 
                 or croak $@;
+
+        # check now, so we don't need to do it later...
+        my $is_list = $type->isa('SOAP::WSDL::XSD::Typelib::Builtin::list');
 
         *{ "$class\::set_$name" } = sub  {
             my ($self, $value) = @_;
-            
+
-            # we accept:
+#  The structure below looks rather weird, but is optimized for performance.
-            # a) objects
+#
-            # b) scalars            
+#  We could use sub calls for sure, but these are much slower. And the logic 
-            # c) list refs
+#  is not that easy:
-            # d) hash refs
+#
-            # e) mixed stuff of all of the above, so we have to 
+#  we accept:
-            # set our element to 
+#  a) objects
-            # a) value if it's an object
+#  b) scalars            
-            # b) New object with value for simple values
+#  c) list refs
-            # c 1) New object with value for list values and list type
+#  d) hash refs
-            # c 2) List ref of new objects with value for list values and non-list type
+#  e) mixed stuff of all of the above, so we have to set our element to 
-            # c + e) List ref of objects for list values (list of objects) and non-list type
+#  a) value if it's an object
-            # d) New object with values passed to new for HASH references
+#  b) New object of expected class with value for simple values
-            # 
+#  c 1) New object with value for list values and list type
-            # Die on non-ARRAY/HASH references - if you can define semantics 
+#  c 2) List ref of new objects with value for list values and non-list type
-            # for GLOB references, feel free to add them.
+#  c + e 1) List ref of objects for list values (list of objects) and non-list type
-            $attribute_ref->{ ident $self } = blessed $value
+#  c + e 2) List ref of new objects for list values (list of hashes) and non-list type
-                ? $value
+#  where the hash ref is passed to new as argument        
-                : ref $value 
+#  d) New object with values passed to new for HASH references
-                    ? ref $value eq 'ARRAY' 
+#
-                        ?  $type->isa('SOAP::WSDL::XSD::Typelib::Builtin::list')
+#  We throw an error on
-                            ? $type->new({ value => $value })
+#  a) list refs of list refs - don't know what to do with this (maybe use for lists of list types ?)
-                            : [ map { 
+#  b) wrong object types
-                                    blessed($_) 
+#  c) non-blessed non-ARRAY/HASH references - if you can define semantics 
-                                        ? ($_->isa('SOAP::WSDL::XSD::Typelib::Builtin::anyType'))
+#  for GLOB references, feel free to add them.
-                                            ? $_
+#  d) we should also die for non-blessed non-ARRAY/HASH references in lists but don't do yet - oh my ! 
-                                            : croak 'cannot use non-XSD object as value'
+
-                                        : $type->new({ value => $_ })
+            my $is_ref = ref $value;
-                                } @{ $value } 
+            $attribute_ref->{ ident $self } = ($is_ref) 
-                             ]
+                ? $is_ref eq 'ARRAY' 
-                    : ref $value eq 'HASH' 
+                    ? $is_list                             # remembered from outside closure 
+                        ? $type->new({ value => $value })  # list element - can take list ref as value
+                        : [ map {                          
+                            ref $_ 
+                              ? ref $_ eq 'HASH'
+                                  ? $type->new($_)
+                                  : ref $_ eq $type
+                                      ? $_
+                                      : croak "cannot use " . ref($_) . " reference as value for $name - $type required"
+                              : $type->new({ value => $_ })
+                            } @{ $value } 
+                         ]
+                    : $is_ref eq 'HASH' 
                         ?  $type->new( $value )
-                        :  die 'Cannot use non-ARRAY/HASH as data'
+                        :  $is_ref eq $type
+                            ? $value
+                            : die croak "cannot use $is_ref reference as value for $name - $type required"
                 : $type->new({ value => $value });                     
         };
 
         *{ "$class\::add_$name" } = sub {
-            my ($self, $value) = @_;
+            my $ident = ident $_[0];
-            my $ident = ident $self;
+            warn "attempting to add empty value to " . ref $_[0] 
-            if (not defined $value) {
+                if (not defined $_[1]);
-                warn "attempting to add empty value to " . ref $self;
+            
-            }
+            # first call
-            
+            return $attribute_ref->{ $ident } = $_[1]
-            return $attribute_ref->{ $ident } = $value
                 if not defined $attribute_ref->{ $ident };
 
-            # listify previous value if it's no list
+            # second call: listify previous value if it's no list
             $attribute_ref->{ $ident } = [  $attribute_ref->{ $ident } ]
                 if not ref $attribute_ref->{ $ident } eq 'ARRAY';
 
-            # add to list
+            # second and following: add to list
-            return push @{ $attribute_ref->{ $ident } }, $value;                                          
+            return push @{ $attribute_ref->{ $ident } }, $_[1];                                          
         };
         
-        *{ "$class\::START" } = sub {
-            my ($self, $ident, $args_of) = @_;
-        
-            # iterate over keys of arguments 
-            # and call set appropriate field in clase
-            map { ($ATTRIBUTES_OF{ $class }->{ $_ }) 
-               ? do {
-                    my $method = "set_$_";
-                    $self->$method( $args_of->{ $_ } );    
-               }
-               : $_ =~ m{ \A              # beginning of string
-                          xmlns           # xmlns 
-                    }xms  
-                    ? do {}
-                    : do { use Data::Dumper; 
-                        croak "unknown field $_ in $class. Valid fields are " 
-                          . join(', ', @{ $ELEMENTS_FROM{ $class } }) . "\n"
-                          . Dumper @_ };
-            # TODO maybe only warn for unknown fields ?
-        
-            } keys %$args_of;
-        };
-
-        # this serialize method works fine for <all> and <sequence>
-        # complextypes, as well as for <restriction><all> or
-        # <restriction><sequence>.
-        # But what about choice, group, extension ?
-        #
     }
+
+    *{ "$class\::START" } = sub {
+        my ($self, $ident, $args_of) = @_;
+        # iterate over keys of arguments 
+        # and call set appropriate field in clase
+        map { ($ATTRIBUTES_OF{ $class }->{ $_ }) 
+            ? do {
+                 my $method = "set_$_";
+                 $self->$method( $args_of->{ $_ } );
+           }
+           : $_ =~ m{ \A              # beginning of string
+                      xmlns           # xmlns 
+                }xms  
+                ? do {}
+                : do { use Data::Dumper; 
+                     croak "unknown field $_ in $class. Valid fields are:\n" 
+                     . join(', ', @{ $ELEMENTS_FROM{ $class } }) . "\n"
+                     . "Structure given:\n" . Dumper @_ };
+        } keys %$args_of;
+        return $self;
+    };
+
+
+    # this serialize method works fine for <all> and <sequence>
+    # complextypes, as well as for <restriction><all> or
+    # <restriction><sequence>.
+    # But what about choice, extension ?
     *{ "$class\::_serialize" } = sub {
-            my $ident = ident $_[0];
+        my $ident = ident $_[0];
-            # my $class = ref $_[0];
+        # my $class = ref $_[0];
-
+        # return concatenated return value of serialize call of all
-            # return concatenated return value of serialize call of all
+        # elements retrieved from get_elements expanding list refs.
-            # elements retrieved from get_elements expanding list refs.
+        # get_elements is inlined for performance.
-            # get_elements is inlined for performance.
+        return join q{} , map {     
-            return join q{} , map {     
+            my $element = $ATTRIBUTES_OF{ $class }->{ $_ }->{ $ident };
-                my $element = $ATTRIBUTES_OF{ $class }->{ $_ }->{ $ident };
+
-                
+            # do we have some content
-                if (defined $element) {       
+            if (defined $element) {
-                    $element = [ $element ]
+                $element = [ $element ]
-                        if not ref $element eq 'ARRAY';
+                    if not ref $element eq 'ARRAY';
-                    my $name = $_;
+                my $name = $_;
             
-                    map {
+                map {
-                        # serialize element elements with their own serializer
+                    # serialize element elements with their own serializer
-                        # but name them like they're named here.
+                    # but name them like they're named here.
-                        if ( $_->isa( 'SOAP::WSDL::XSD::Typelib::Element' ) ) {
+                    if ( $_->isa( 'SOAP::WSDL::XSD::Typelib::Element' ) ) {
-                                $_->serialize( { name => $name } );
+                            $_->serialize( { name => $name } );
-                        }
+                    }
-                        # serialize complextype elments (of other types) with their 
+                    # serialize complextype elments (of other types) with their 
-                        # serializer, but add element tags around.
+                    # serializer, but add element tags around.
-                        else {
+                    else {
-                            join q{}, $_->start_tag({ name => $name })
+                        join q{}, $_->start_tag({ name => $name })
-                                , $_->serialize()
+                            , $_->serialize()
-                                , $_->end_tag({ name => $name });       
+                            , $_->end_tag({ name => $name });       
-                        }
+                    }
-                    } @{ $element }
+                } @{ $element }
-                }
+            }
-                else {
+            else {
-                    q{};
+                 q{};
-                }        
+            }        
-            } (@{ $ELEMENTS_FROM{ $class } });
+        } (@{ $ELEMENTS_FROM{ $class } });
-        };
+    };
 
     *{ "$class\::serialize" } = sub {
             my ($self, $opt) = @_;
@@ -167,7 +183,7 @@ sub _factory {
     }
     
 }
-
+
 1;
 
 __END__
@@ -176,7 +192,82 @@ __END__
 
 =head1 NAME
 
-SOAP::WSDL::XSD::Typelib::ComplexType - ComplexType XML Schema definitions
+SOAP::WSDL::XSD::Typelib::ComplexType - complexType base class
+
+=head1 Subclassing
+
+ package MyComplexType;
+ use Class::Std::Storable
+ use base qw(SOAP::WSDL::XSD::Typelib::ComplexType);
+ 
+ __PACKAGE__->_factory(
+    \@elements_from,
+    \%attributes_of,
+    \%classes_of 
+ );
+
+When subclassing, the following methods are created in the subclass:
+
+=head2 new
+
+Constructor. For your convenience, new will accept data for the object's 
+properties in the following forms:
+
+ hash refs
+ 1) of scalars
+ 2) of list refs
+ 3) of hash refs
+ 4) of objects
+ 5) mixed stuff of all of the above 
+
+new() will set the data via the set_FOO methods to the object's element 
+properties. 
+
+Data passed to new must comply to the object's structure or new() will 
+complain. Objects passed must be of the expected type, or new() will 
+complain, too.
+
+Examples:
+
+ my $obj = MyClass->new({ MyName => $value });  
+ 
+ my $obj = MyClass->new({
+     MyName => { 
+         DeepName => $value 
+     },
+     MySecondName => $value,
+ });
+ 
+ my $obj = MyClass->new({
+     MyName => [
+        { DeepName => $value },
+        { DeepName => $other_value },
+     ],
+     MySecondName => $object,
+     MyThirdName => [ $object1, $object2 ],
+ });
+
+To be correct, SOAP::WSDL::XSD::Typelib::ComplexType will create a START 
+method, not new() - but new() will be created from Class::Std::Storable and 
+behave like stated above.
+
+=head2 set_FOO
+
+A mutator method for every element property. 
+
+For your convenience, the set_FOO methods will accept all kind of data you 
+can think of (and all combinations of them) as input - with the exception 
+of GLOBS and filehandles.
+
+This means you may set element properties by passing 
+
+ a) objects
+ b) scalars            
+ c) list refs
+ d) hash refs
+ e) mixed stuff of all of the above 
+
+Examples are similar to the examples provided for new() above.
 
 =head1 Bugs and limitations
 

lib/SOAP/WSDL/XSD/Typelib/Element.pm

@@ -63,27 +63,71 @@ sub end_tag {
 1;
 
 =pod
+
+=head1 NAME
+
+SOAP::WSDL::XSD::Typelib::Element - element base clase
 
 =head1 SYNOPSIS
+
+This example creates a class for this XML schema definition:
+
+ <element name="MyElement" type="xsd:string" nillable="1"
+   minOccurs="1" maxOccurs="1"/>
 
  package MyElement;
  use strict;
  use Class::Std::Storable;
  use base (
-    'SOAP::WSDL::XSD::Typelib::Element',
+    'SOAP::WSDL::XSD::Typelib::Element',
+    'SOAP::WSDL::XSD::Typelib::Builtin::string',
  );
 
  __PACKAGE__->__set_name('MyElementName');
  __PACKAGE__->__set_nillable(1);
  __PACKAGE__->__set_minOccurs(1);
  __PACKAGE__->__set_maxOccurs(1);
- __PACKAGE__->__set_ref(1);
+ __PACKAGE__->__set_ref(0);
+
+Now we create this XML schema definition type class:
+
+ <element name="MyElement2" ref="tns:MyElement"/>
+ 
+ package MyElement2;
+ use strict;
+ use Class::Std::Storable;
+ use base (
+    'SOAP::WSDL::XSD::Typelib::Element',
+    'MyElement'
+ );
 
+ __PACKAGE__->__set_name('MyElementName');
+ __PACKAGE__->__set_nillable(0);
+ __PACKAGE__->__set_ref(1);
+ 
+=head1 NOTES
+
+=over 
+
+=item * type="Foo"
+
+Implemented via inheritance.
+
+=item * ref="Foo"
+
+Implemented via inheritance, too. Calling 
+
+__PACKAGE__->__set_ref(1) is highly encouraged, though it has no 
+effect yet - it will probably be needed for serialization to XML 
+Schema definitions some day.
+
+=back
+ 
 =head1 BUGS AND LIMITATIONS
 
 =over
 
-=item * minOccurs maxOccurs ref not implemented
+=item * minOccurs maxOccurs not implemented
 
 These attributes are not yet supported, though they may be set as class
 properties via __PACKAGE__->__set_FOO methods.

lib/SOAP/WSDL/XSD/Typelib/SimpleType.pm

@@ -17,7 +17,7 @@ __END__
 
 =head1 NAME
 
-SOAP::WSDL::XSD::Typelib::SimpleType - simple type base class
+SOAP::WSDL::XSD::Typelib::SimpleType - simpleType base class
 
 =head1 DESCRIPTION
 

t/001_use.t

@@ -16,7 +16,7 @@ my @modules = qw(
     SOAP::WSDL::PortType
     SOAP::WSDL::Types
     SOAP::WSDL::SAX::WSDLHandler
-    SOAP::WSDL::XSD::Primitive
+    SOAP::WSDL::XSD::Builtin
     SOAP::WSDL::XSD::ComplexType
     SOAP::WSDL::XSD::SimpleType
     SOAP::WSDL::XSD::Element

t/002_sax.t

@@ -174,7 +174,7 @@ sub xml
         targetNamespace="urn:myNamespace"
         xmlns="http://schemas.xmlsoap.org/wsdl/"
         xmlns:tns="urn:myNamespace"
-        xmlns:xsd="http://www.w3c.org/2001/XMLSchema"
+        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
         xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
         xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
 >

t/006_client.t

@@ -37,7 +37,7 @@ $pod->output_string( \$output );
 $pod->parse_string_document( $soap->explain() );
 
 # print $output;
-
+
 SKIP: {
     skip_without_test_xml();
     is_xml( $soap->call( 'EnqueueMessage' , EnqueueMessage => {
@@ -48,10 +48,6 @@ SKIP: {
         }
     )
     , q{<SOAP-ENV:Envelope
-        xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
-        xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
-        xmlns:tns="http://www.example.org/MessageGateway2/"
-        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
         xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" >
     <SOAP-ENV:Body ><EnqueueMessage xmlns="http://www.example.org/MessageGateway2/"><MMessage>
                 <MRecipientURI>mailto:test@example.com</MRecipientURI>

t/008_client_wsdl_complexType.t

@@ -15,7 +15,7 @@ my $soap = SOAP::WSDL->new(
     wsdl => 'file:///' . $path .'/t/acceptance/wsdl/008_complexType.wsdl'
 )->wsdlinit();
 
-my $wsdl = $soap->{ _WSDL }->{ wsdl_definitions };
+my $wsdl = $soap->get_definitions;
 my $schema = $wsdl->first_types();
 my $type = $schema->find_type('Test' , 'testComplexTypeAll');
 my $element = $type->get_element()->[0];

t/014_sax_typelib.t

@@ -56,7 +56,8 @@ for my $element (@{ $wsdl->first_types()->get_schema()->[1]->get_type() } ) {
       next;
     }
     my $name = 'MessageGateway::' . $element->get_name();
-    ok eval $output, $name;
+    ok eval $output, $name
+        or die $@, $output;
 
     ok $name->can('serialize'), "$name\->can('serialize')";
 }

t/018_generator.t

@@ -0,0 +1,30 @@
+#!/usr/bin/perl -w
+use strict;
+use warnings;
+use Test::More tests => 1;
+use lib '../lib';
+use XML::LibXML;
+use SOAP::WSDL::SAX::WSDLHandler;
+use SOAP::WSDL::SAX::MessageHandler;
+use File::Path;
+use File::Basename;
+
+my $path = dirname __FILE__;
+
+my $filter = SOAP::WSDL::SAX::WSDLHandler->new();
+my $parser = XML::LibXML->new();
+$parser->set_handler( $filter );
+$parser->parse_file( "$path/../example/wsdl/globalweather.xml" );
+
+my $wsdl;
+ok( $wsdl = $filter->get_data() , "get object tree");
+
+$wsdl->create({
+  base_path => "$path/testlib",
+  typemap_prefix => "Test::Typemap::",
+  type_prefix => "Test::Type::",
+  element_prefix => "Test::Element::",
+  interface_prefix => "Test::Interface::",
+});
+
+rmtree "$path/testlib";

t/098_pod.t

@@ -2,26 +2,18 @@ use Test::More;
 eval "use Test::Pod 1.00";
 plan skip_all => "Test::Pod 1.00 required for testing POD" if $@;
 
-use Cwd;
+# perl Build test or make test run from top-level dir. 
-
+if ( -d '../t/' ) {
-my $dir = cwd;
+	@directories = ('../lib/');
-
-if ( $dir =~ /t$/ )
-{
-	@directories = ('../lib/', '../bin/');
 }
-else
+else {
-{
+	@directories = (); # empty - will work automatically
-	@directories = ();
 }
 
-my @files = all_pod_files(
+my @files = all_pod_files(@directories);
-	@directories
-);
 
 plan tests => scalar(@files);
 
-foreach my $module (@files)
+foreach my $module (@files){
-{
 	pod_file_ok( $module )
 }

t/SOAP/WSDL/02_port.t

@@ -1,4 +1,4 @@
-use Test::More tests => 10;
+use Test::More tests => 7;
 use strict;
 use warnings;
 use diagnostics;
@@ -26,22 +26,10 @@ ok( $soap = SOAP::WSDL->new(
 	wsdl => 'file:///' . $path . '/acceptance/wsdl/' . $name . '.wsdl'
 ), 'Instantiated object' );
 
-ok( $soap->wsdlinit(), 'parsed WSDL' );
-
 ok( ($soap->servicename('testService')  ), 'set service' );
-ok( ($soap->portname('testPort')  ) ,'set portname');
+ok( ($soap->portname('testPort2')  ) ,'set portname');
-
+ok( $soap->wsdlinit(), 'parsed WSDL' );
-ok( ($soap->portname() eq 'testPort' ), 
-"Found first port definition" );
-
-ok( ($soap->portname('testPort2') ), 
-"Found second port definition (based on URL)" );
-
-ok( ($soap->portname('testPort3') ), 
-"Found third port definition (based on Name)" );
 
 ok( $soap->wsdlinit( servicename => 'testService', portname => 'testPort'), 'parsed WSDL' );
 
-$soap->_wsdl_init_methods();
-
 ok( ($soap->portname() eq 'testPort' ), 'found port passed to wsdlinit');

t/SOAP/WSDL/03_complexType-all.t

@@ -59,14 +59,12 @@ TODO: {
 
 eval 
 { 
-	$xml = $soap->serializer->method( 
+	$xml = $soap->call('test', 
-		$soap->call('test', 
 			testAll => {
 				Test1 => 'Test 1',
 				Test2 => [ 'Test 2', 'Test 3' ]
 			}
-		) 
+		);
-	);
 };
 
 ok( ($@ =~m/illegal\snumber\sof\selements/),
@@ -74,13 +72,11 @@ ok( ($@ =~m/illegal\snumber\sof\selements/),
 );
 
 eval {
-	$xml = $soap->serializer->method( 
+	$xml = $soap->call('test', 
-		$soap->call('test', 
 			testAll => {
 				Test1 => 'Test 1',
 			}
-		) 
+		);
-	)
 };
 ok($@, 'Died on illegal number of elements (not enough)');
 

t/SOAP/WSDL/03_complexType-sequence.t

@@ -35,8 +35,6 @@ ok( $soap->wsdlinit(
 	servicename => 'testService',
 ), 'parsed WSDL' );
 $soap->no_dispatch(1);
-$soap->serializer()->envprefix('SOAP-ENV');
-$soap->serializer()->encprefix('SOAP-ENC');
 
 #4
 ok $xml = $soap->call('test', 
@@ -46,33 +44,32 @@ ok $xml = $soap->call('test',
 	}
 ), 'Serialized complexType';
 
-#5
+TODO: {
-eval 
+    local $TODO = "not implemented yet";
-{ 
+    #5
-	$xml = $soap->serializer->method( 
+    eval 
-		$soap->call('test', 
+    { 
-			testSequence => {
+            $xml = $soap->call('test', 
-				Test1 => 'Test 1',
+                            testSequence => {
-			}
+                                    Test1 => 'Test 1',
-		) 
+                            }
-	);
+                    );
-};
+    };
-ok( ($@),
+    ok( ($@),
-	"Died on illegal number of elements"
+            "Died on illegal number of elements"
-);
+    );
-
+    
-#6
+    #6
-eval 
+    eval 
-{ 
+    { 
-	$xml = $soap->serializer->method( 
+            $xml = $soap->call('test', 
-		$soap->call('test', 
+                            testSequence => {
-			testSequence => {
+                                    Test1 => 'Test 1',
-				Test1 => 'Test 1',
+                                    Test2 => [ 1, 2, 3, ]
-				Test2 => [ 1, 2, 3, ]
+                            }
-			}
+                    ); 
-		) 
+    };
-	);
+    ok( ($@),
-};
+            "Died on illegal number of elements"
-ok( ($@),
+    );
-	"Died on illegal number of elements"
+};
-);

t/SOAP/WSDL/04_element.t

@@ -1,4 +1,4 @@
-use Test::More tests => 6;
+use Test::More tests => 8;
 use strict;
 use warnings;
 use lib '../lib';
@@ -39,6 +39,16 @@ ok ($xml = $soap->call('test',
 	testElement1 => 'Test'
 ), 'Serialized (simple) element' );
 
+ok ($xml = $soap->call('testRef', 
+	testElementRef => 'Test'
+), 'Serialized (simple) element' );
+
+is $xml 
+    , q{<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" ><SOAP-ENV:Body><testElementRef  xmlns="urn:Test">Test</testElementRef>
+</SOAP-ENV:Body></SOAP-ENV:Envelope>}
+    , 'element ref serialization result'
+;
+
 TODO: {
     local $TODO="implement min/maxOccurs checks";
 

t/SOAP/WSDL/XSD/Typelib/Builtin/002_dateTime.t

@@ -0,0 +1,38 @@
+use Test::More tests => 4;
+use strict;
+use warnings;
+use lib '../lib';
+use Date::Parse;
+use Date::Format;
+
+sub timezone {
+    my @time = strptime shift;
+    my $tz = strftime('%z', @time);
+    substr $tz, -2, 0, ':';
+    return $tz;
+}
+
+use_ok('SOAP::WSDL::XSD::Typelib::Builtin::dateTime');
+my $obj;
+my %dates = (
+    '2007-12-31 12:32' => '2007-12-31T12:32:00', 
+    '2007-08-31 00:32' => '2007-08-31T00:32:00',
+    '30 Aug 2007' => '2007-08-30T00:00:00',
+);
+
+while (my ($date, $converted) = each %dates ) {
+
+    $obj = SOAP::WSDL::XSD::Typelib::Builtin::dateTime->new();
+    $obj->set_value( $date );
+    
+    is $obj->get_value() , $converted . timezone($date), 'conversion';
+}
+$obj->set_value('2007-12-31T00:00:00.0000000+01:00');
+
+# exit;
+
+#~ use Benchmark;
+#~ timethese 10000, {
+    #~ xml => sub { $obj->set_value('2037-12-31T00:00:00.0000000+01:00') },
+    #~ string => sub { $obj->set_value('2037-12-31') },
+#~ }

t/SOAP/WSDL/XSD/Typelib/Builtin/002_time.t

@@ -0,0 +1,25 @@
+use Test::More tests => 3;
+use strict;
+use warnings;
+use lib '../lib';
+
+use_ok('SOAP::WSDL::XSD::Typelib::Builtin::time');
+my $obj;
+
+$obj = SOAP::WSDL::XSD::Typelib::Builtin::time->new();
+
+$obj->set_value( '12:23:03' );
+is $obj->get_value() , '12:23:03+01:00', 'conversion';
+
+$obj->set_value( '12:23:03.12345+01:00' ), ;
+is $obj->get_value() , '12:23:03.12345+01:00', 'no conversion';
+
+
+
+# exit;
+
+#~ use Benchmark;
+#~ timethese 10000, {
+    #~ xml => sub { $obj->set_value('2037-12-31T00:00:00.0000000+01:00') },
+    #~ string => sub { $obj->set_value('2037-12-31') },
+#~ }

t/SOAP/WSDL/XSD/Typelib/Builtin/003_date.t

@@ -0,0 +1,36 @@
+use Test::More tests => 6;
+use strict;
+use warnings;
+use lib '../lib';
+use Date::Format;
+use Date::Parse;
+use_ok('SOAP::WSDL::XSD::Typelib::Builtin::date');
+my $obj;
+
+sub timezone {
+    my @time = strptime shift;
+    my $tz = strftime('%z', @time);
+    substr $tz, -2, 0, ':';
+    return $tz;
+}
+
+my %dates = (
+    '2007/12/31' => '2007-12-31', 
+    '2007:08:31' => '2007-08-31',
+    '30 Aug 2007' => '2007-08-30',
+);
+
+while (my ($date, $converted) = each %dates ) {
+
+    $obj = SOAP::WSDL::XSD::Typelib::Builtin::date->new();
+    $obj->set_value( $date );
+    
+    is $obj->get_value() , $converted . timezone($date), 'conversion';
+}
+
+$obj->set_value('2007-12-31T00:00:00.0000000+01:00');
+is $obj->get_value() , '2007-12-31+01:00', 'conversion from XML dateTime';
+
+$obj->set_value( '2037-12-31' );
+is $obj->get_value() , '2037-12-31', 'no conversion on match';
+

t/acceptance/wsdl/03_complexType-all.wsdl

@@ -1,72 +1,63 @@
 <?xml version="1.0"?>
-<definitions name="urn:Test"
+<definitions name="urn:Test" targetNamespace="urn:Test" xmlns:tns="urn:Test"
-	targetNamespace="urn:Test"
+  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-	xmlns:tns="urn:Test"
+  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
-	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
-	xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
-	xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
->
   <types>
     <xsd:schema targetNamespace="urn:Test">
       <xsd:complexType name="testComplexTypeAll">
-	<xsd:annotation>
+        <xsd:annotation>
-          <xsd:documentation>
+          <xsd:documentation>ComplexType Test</xsd:documentation>
-            ComplexType Test
+        </xsd:annotation>
-          </xsd:documentation>
-	</xsd:annotation>
         <xsd:all>
-          <xsd:element name="Test1" type="xsd:string"/>
+          <xsd:element name="Test1" type="xsd:string" />
-          <xsd:element name="Test2" type="xsd:string" minOccurs="1"/>
+          <xsd:element name="Test2" type="xsd:string" minOccurs="1" />
-        </xsd:all>
+        </xsd:all>
       </xsd:complexType>
 
-        <xsd:complexType name="testComplexTypeSequence">
+      <xsd:complexType name="testComplexTypeSequence">
-            <xsd:annotation>
+        <xsd:annotation>
-                <xsd:documentation>
+          <xsd:documentation>ComplexType Test</xsd:documentation>
-                    ComplexType Test
+        </xsd:annotation>
-                </xsd:documentation>
+        <xsd:sequence>
-            </xsd:annotation>
+          <xsd:element name="Test1" type="xsd:string" minOccurs="1" />
-            <xsd:sequence>
+          <xsd:element name="Test2" type="xsd:string" maxOccurs="1" />
-                <xsd:element name="Test1" type="xsd:string" minOccurs="1"/>
+        </xsd:sequence>
-                <xsd:element name="Test2" type="xsd:string" maxOccurs="1"/>
+      </xsd:complexType>
-            </xsd:sequence>
-        </xsd:complexType>
     </xsd:schema>
 
-	</types>
+  </types>
-	<message name="testRequest">
+  <message name="testRequest">
-		<part name="testAll" type="tns:testComplexTypeAll"/>
+    <part name="testAll" type="tns:testComplexTypeAll" />
-	</message>
+  </message>
-	<message name="testResponse">
+  <message name="testResponse">
-		<part name="testAll" type="tns:testComplexTypeAll"/>
+    <part name="testAll" type="tns:testComplexTypeAll" />
-	</message>
+  </message>
-	<portType name="testPort">
+  <portType name="testPort">
-		<operation name="test">
+    <operation name="test">
-			<documentation>
+      <documentation>Test-Methode</documentation>
-				Test-Methode
-			</documentation>
 
-			<input message="tns:testRequest"/>
+      <input message="tns:testRequest" />
-			<output message="tns:testResponse"/>
+      <output message="tns:testResponse" />
-		</operation>
+    </operation>
-	</portType>
+  </portType>
 
-	<binding type="tns:testPort" name="testBinding">
+  <binding type="tns:testPort" name="testBinding">
-		<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
+    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />
-                <operation name="test">
+    <operation name="test">
-                    <soap:operation soapAction="test">
+      <soap:operation soapAction="test">
-			<input>
+        <input>
-				<soap:body use="literal"/>
+          <soap:body use="literal" />
-			</input>
+        </input>
-			<output>
+        <output>
-				<soap:body use="literal"/>
+          <soap:body use="literal" />
-			</output>
+        </output>
-		</soap:operation>
+      </soap:operation>
-                </operation>
+    </operation>
-	</binding>
+  </binding>
-	<service name="testService">
+  <service name="testService">
-		<port name="testPort" binding="tns:testBinding">
+    <port name="testPort" binding="tns:testBinding">
-			<soap:address location="http://127.0.0.1/testPort" />
+      <soap:address location="http://127.0.0.1/testPort" />
-		</port>
+    </port>
-	</service>
+  </service>
-</definitions>
+</definitions>

t/acceptance/wsdl/04_element.wsdl

@@ -9,12 +9,17 @@
 	<types>
 		<xsd:schema targetNamespace="urn:Test">
 			<xsd:element name="testElement1" type="xsd:string" />
-			<xsd:element name="testElement2" type="xsd:int" />
+			<xsd:element name="testElement2" type="xsd:int" />
+            <xsd:element name="testElementRef" ref="tns:testElement1" />
 		</xsd:schema>
 	</types>
 	<message name="testRequest">
 		<part name="testAll" element="tns:testElement1"/>	
 	</message>
+    <message name="testRefRequest">
+      <part name="testAll" element="tns:testElementRef"/> 
+    </message>
+
 	<message name="testResponse">
 		<part name="testAll" type="tns:testElement1"/>		
 	</message>
@@ -27,10 +32,18 @@
 			<input message="tns:testRequest"/>
 			<output message="tns:testResponse"/>
 		</operation>
+        <operation name="testRef">
+          <documentation>
+            Test-Methode
+          </documentation>
+          
+          <input message="tns:testRefRequest"/>
+          <output message="tns:testResponse"/>
+        </operation>
 	</portType>
 
 	<binding type="tns:testPort" name="testBinding">
-            <operation name="test">
+      <operation name="test">
 		<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
 		<soap:operation soapAction="test">
 			<input>
@@ -40,7 +53,18 @@
 				<soap:body use="literal"/>
 			</output>
 		</soap:operation>
-            </operation>
+      </operation>
+      <operation name="testRef">
+        <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
+        <soap:operation soapAction="testRef">
+          <input>
+            <soap:body use="literal"/>
+          </input>
+          <output>
+            <soap:body use="literal"/>
+          </output>
+        </soap:operation>
+      </operation>      
 	</binding>
 	<service name="testService">
 		<port name="testPort" binding="tns:testBinding">