=encoding utf8
=head1 NAME
XML::Compile::SOAP12 - base class for SOAP1.2 implementation
=head1 INHERITANCE
XML::Compile::SOAP12
is a XML::Compile::SOAP
XML::Compile::SOAP12 is extended by
XML::Compile::SOAP12::Client
XML::Compile::SOAP12::Server
=head1 SYNOPSIS
**WARNING** Implementation not finished: not usable!!
I am looking for companies who will sponsor the two weeks of
development time I need to complete this module.
=head1 DESCRIPTION
This module handles the SOAP protocol version 1.2.
See F<http://www.w3.org/TR/soap12/>).
The client specifics are implemented in L<XML::Compile::SOAP12::Client|XML::Compile::SOAP12::Client>,
and the server needs can be found in L<XML::Compile::SOAP12::Server|XML::Compile::SOAP12::Server>.
See L<documentation in the base class|XML::Compile::SOAP/"DESCRIPTION">.
=head1 METHODS
See L<documentation in the base class|XML::Compile::SOAP/"METHODS">.
=head2 Constructors
See L<documentation in the base class|XML::Compile::SOAP/"Constructors">.
=over 4
=item $obj-E<gt>B<new>(OPTIONS)
-Option --Defined in --Default
header_fault error
media_type XML::Compile::SOAP application/soap+xml
schemas XML::Compile::SOAP created internally
=over 2
=item header_fault => <anything>
SOAP1.1 defines a header fault type, which not present in SOAP 1.2,
where it is replaced by a C<notUnderstood> structure.
=item media_type => MIMETYPE
=item schemas => C<XML::Compile::Cache> object
=back
=item XML::Compile::SOAP12-E<gt>B<register>(URI, ENVNS)
See L<XML::Compile::SOAP/"Constructors">
=back
=head2 Accessors
See L<documentation in the base class|XML::Compile::SOAP/"Accessors">.
=over 4
=item $obj-E<gt>B<mediaType>()
See L<XML::Compile::SOAP/"Accessors">
=item $obj-E<gt>B<schemas>()
See L<XML::Compile::SOAP/"Accessors">
=item $obj-E<gt>B<version>()
See L<XML::Compile::SOAP/"Accessors">
=back
=head2 Single message
See L<documentation in the base class|XML::Compile::SOAP/"Single message">.
=over 4
=item $obj-E<gt>B<compileMessage>(('SENDER'|'RECEIVER'), OPTIONS)
=pod
# faults are always possible
my @bparts = @{$args{body}{parts} || []};
my $w = $self->schemas->writer('env12:Fault'
, include_namespaces => sub {$_[0] ne SOAP11ENV && $_[2]}
);
push @bparts,
{ name => 'Fault'
, element => pack_type(SOAP11ENV, 'Fault')
, writer => $w
};
local $args{body}{parts} = \@bparts;
-Option --Defined in --Default
body XML::Compile::SOAP []
destination XML::Compile::SOAP []
faults XML::Compile::SOAP []
header XML::Compile::SOAP undef
mustUnderstand XML::Compile::SOAP []
procedure XML::Compile::SOAP undef
role XML::Compile::SOAP ULTIMATE
roles XML::Compile::SOAP []
=over 2
=item body => ENTRIES|HASH
=item destination => ARRAY-OF-PAIRS
=item faults => ENTRIES|HASH
=item header => ENTRIES|HASH
=item mustUnderstand => STRING|ARRAY-OF-STRING
=item procedure => TYPE
=item role => URI|ARRAY-OF-URI
=item roles => ARRAY-OF-URI
=back
=item $obj-E<gt>B<messageStructure>(XML)
=item XML::Compile::SOAP12-E<gt>B<messageStructure>(XML)
See L<XML::Compile::SOAP/"Single message">
=back
=head2 Helpers
See L<documentation in the base class|XML::Compile::SOAP/"Helpers">.
=head2 Transcoding
See L<documentation in the base class|XML::Compile::SOAP/"Transcoding">.
=over 4
=item $obj-E<gt>B<replyMustUnderstandFault>(TYPE)
See L<XML::Compile::SOAP/"Transcoding">
=item $obj-E<gt>B<roleAbbreviation>(URI)
See L<XML::Compile::SOAP/"Transcoding">
=item $obj-E<gt>B<roleURI>(URI|STRING)
See L<XML::Compile::SOAP/"Transcoding">
=back
=head1 DETAILS
See L<documentation in the base class|XML::Compile::SOAP/"DETAILS">.
=head1 SEE ALSO
This module is part of XML-Compile-SOAP12 distribution version 3.00,
built on January 06, 2014. Website: F<http://perl.overmeer.net/xml-compile/>
Other distributions in this suite:
L<XML::Compile>,
L<XML::Compile::SOAP>,
L<XML::Compile::WSDL11>,
L<XML::Compile::SOAP12>,
L<XML::Compile::SOAP::Daemon>,
L<XML::Compile::SOAP::WSA>,
L<XML::Compile::C14N>,
L<XML::Compile::WSS>,
L<XML::Compile::WSS::Signature>,
L<XML::Compile::Tester>,
L<XML::Compile::Cache>,
L<XML::Compile::Dumper>,
L<XML::Compile::RPC>,
L<XML::Rewrite>
and
L<XML::LibXML::Simple>.
Please post questions or ideas to the mailinglist at
F<http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/xml-compile> .
For live contact with other developers, visit the C<#xml-compile> channel
on C<irc.perl.org>.
=head1 LICENSE
Copyrights 2009-2014 by [Mark Overmeer]. For other contributors see ChangeLog.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>