=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!!

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

=head1 METHODS

=head2 Constructors

$obj-E<gt>B<new>(OPTIONS)

=over 4

 Option            --Defined in     --Default
 encoding_ns         XML::Compile::SOAP  http://www.w3.org/2003/05/soap-encoding
 envelope_ns         XML::Compile::SOAP  http://www.w3.org/2003/05/soap-envelope
 header_fault                         error
 media_type          XML::Compile::SOAP  application/soap+xml
 rpc_ns                               http://www.w3.org/2003/05/soap-rpc
 schema_instance_ns  XML::Compile::SOAP  $schema_ns . '-instance'
 schema_ns           XML::Compile::SOAP  SCHEMA2001
 schemas             XML::Compile::SOAP  created internally
 version             XML::Compile::SOAP  'SOAP12'

. encoding_ns => URI

. envelope_ns => URI

. header_fault => <anything>

=over 4

SOAP1.1 defines a header fault type, which not present in SOAP 1.2,
where it is replaced by a C<notUnderstood> structure.

=back

. media_type => MIMETYPE

. rpc_ns => URI

. schema_instance_ns => URI

. schema_ns => URI

. schemas => C<XML::Compile::Schema> object

. version => STRING

=back

=head2 Accessors

$obj-E<gt>B<encodingNS>

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<envelopeNS>

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<prefixPreferences>(TABLE, NEW, [USED])

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<rpcNS>

=over 4

=back

$obj-E<gt>B<schemaInstanceNS>(() {shift->{schemains}})

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<schemaNS>

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<schemas>

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

$obj-E<gt>B<version>

=over 4

See L<XML::Compile::SOAP/"Accessors">

=back

=head2 Single messages

$obj-E<gt>B<compileMessage>(('SENDER'|'RECEIVER'), OPTIONS)

=over 4

See L<XML::Compile::SOAP/"Single messages">

=back

$obj-E<gt>B<importDefinitions>(XMLDATA, OPTIONS)

=over 4

See L<XML::Compile::SOAP/"Single messages">

=back

$obj-E<gt>B<messageStructure>(XML)

XML::Compile::SOAP12-E<gt>B<messageStructure>(XML)

=over 4

See L<XML::Compile::SOAP/"Single messages">

=back

=head2 Sender (internals)

$obj-E<gt>B<sender>(ARGS)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerCreateBody>(BODY-DEFS, NAMESPACE-TABLE, OPTS)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerCreateFault>(FAULT-DEFS, NAMESPACE-TABLE, FAULTTYPE)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerCreateHeader>(HEADER-DEFS, NS-TABLE, UNDERSTAND, DESTINATION, OPTS)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerCreateRpcEncoded>(NAMESPACE-TABLE)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerCreateRpcLiteral>(NAMESPACE-TABLE)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerEncstyleHook>(NAMESPACE-TABLE)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

$obj-E<gt>B<writerHook>(NAMESPACE, LOCAL, ACTIONS)

=over 4

See L<XML::Compile::SOAP/"Sender (internals)">

=back

=head2 Receiver (internals)

$obj-E<gt>B<readerEncstyleHook>

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

$obj-E<gt>B<readerHook>(NAMESPACE, LOCAL, ACTIONS)

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

$obj-E<gt>B<readerParseBody>(BODYDEF, OPTS)

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

$obj-E<gt>B<readerParseFaults>(FAULTSDEF)

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

$obj-E<gt>B<readerParseHeader>(HEADERDEF, OPTS)

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

$obj-E<gt>B<receiver>(ARGS)

=over 4

See L<XML::Compile::SOAP/"Receiver (internals)">

=back

=head2 Helpers

=head2 Transcoding

$obj-E<gt>B<replyMustUnderstandFault>(TYPE)

=over 4

See L<XML::Compile::SOAP/"Transcoding">

=back

$obj-E<gt>B<roleAbbreviation>(URI)

=over 4

See L<XML::Compile::SOAP/"Transcoding">

=back

$obj-E<gt>B<roleURI>(URI|STRING)

=over 4

See L<XML::Compile::SOAP/"Transcoding">

=back

=head1 DETAILS

=head1 SEE ALSO

This module is part of XML-Compile-SOAP distribution version 0.77,
built on August 15, 2008. Website: F<http://perl.overmeer.net/xml-compile/>

All modules in this suite:
L<XML::Compile>,
L<XML::Compile::SOAP>,
L<XML::Compile::SOAP::Daemon>,
L<XML::Compile::Tester>,
L<XML::Compile::Cache>,
L<XML::Rewrite>,
L<XML::Compile::Dumper>.

Please post questions or ideas to the mailinglist at
F<http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/xml-compile>
For life contact with other developers, visit the C<#xml-compile> channel
on C<irc.perl.org>.

=head1 LICENSE

Copyrights 2007-2008 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>