=encoding utf8

=head1 NAME

XML::Compile::SOAP12 - SOAP 1.2 protocol

=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

 # use either XML::Compile::SOAP12::Client or ::Server
 # See XML::Compile::SOAP for global usage examples.

=head1 DESCRIPTION

This module handles the SOAP protocol version 1.2.
See F<http://www.w3.org/TR/soap12/>).  Development of this module was
sponsored by "Momac", L<http://momac.net>.

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>.

Extends L<"DESCRIPTION" in XML::Compile::SOAP|XML::Compile::SOAP/"DESCRIPTION">.
 
=head1 METHODS

Extends L<"METHODS" in XML::Compile::SOAP|XML::Compile::SOAP/"METHODS">.
 
=head2 Constructors

Extends L<"Constructors" in XML::Compile::SOAP|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)

Inherited, see L<XML::Compile::SOAP/"Constructors">

=back

=head2 Accessors

Extends L<"Accessors" in XML::Compile::SOAP|XML::Compile::SOAP/"Accessors">.
 
=over 4

=item $obj-E<gt>B<mediaType>()

Inherited, see L<XML::Compile::SOAP/"Accessors">

=item $obj-E<gt>B<schemas>()

Inherited, see L<XML::Compile::SOAP/"Accessors">

=item $obj-E<gt>B<version>()

Inherited, see L<XML::Compile::SOAP/"Accessors">

=back

=head2 Single message

Extends L<"Single message" in XML::Compile::SOAP|XML::Compile::SOAP/"Single message">.
 
=over 4

=item $obj-E<gt>B<compileMessage>( <'SENDER'|'RECEIVER'>, %options )

 -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)

Inherited, see L<XML::Compile::SOAP/"Single message">

=back

=head2 Helpers

Extends L<"Helpers" in XML::Compile::SOAP|XML::Compile::SOAP/"Helpers">.
 
=head2 Transcoding

Extends L<"Transcoding" in XML::Compile::SOAP|XML::Compile::SOAP/"Transcoding">.
 
=over 4

=item $obj-E<gt>B<replyMustUnderstandFault>($type)

Inherited, see L<XML::Compile::SOAP/"Transcoding">

=item $obj-E<gt>B<roleAbbreviation>($uri)

Inherited, see L<XML::Compile::SOAP/"Transcoding">

=item $obj-E<gt>B<roleURI>($uri|STRING)

Inherited, see L<XML::Compile::SOAP/"Transcoding">

=back

=head1 DETAILS

Extends L<"DETAILS" in XML::Compile::SOAP|XML::Compile::SOAP/"DETAILS">.
 
=head1 SEE ALSO

This module is part of XML-Compile-SOAP12 distribution version 3.04,
built on December 09, 2015. 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-2015 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>