NAME

Catalyst::Controller::SOAP::DocumentLiteralWrapped - Helper controller for SOAP

SYNOPSIS

use base qw(Catalyst::Controller::SOAP::DocumentLiteralWrapped);
__PACKAGE__->{config}{soap_action_prefix} = 'http://foo/bar/';

DESCRIPTION

Microsoft has defined a pseudo-standard for SOAP usage called Document/Literal Wrapped. This standard is a deviation of both the Document/Literal and of the RPC/Literal usages.

A Document/Literal service is supposed to have one operation per bind, as it's not techically possible to dispatch on the content of the Body. In fact, as the Body is used as "literal" the dispatching should not even look at it, it should be based on the port that received the request.

RPC/Literal, on the other hand, supports the use of several operations per bind, and the dispatching of this operations is based on the first and only child element of the message body, which defines the operation. The arguments are set as the parts of the message in the WSDL.

Document/Literal-Wrapped is a deviation of both, as the message should be interpreted as Document/Literal, but the dispatching requires an additional step of looking at the SOAPAction HTTP header, which will identify the proper operation to be dispatched.

This is plain wrong, as the SOAP Action information should be used for routing pourposes only and not for operation dispatch. Please see the SOAP standard. In fact, SOAP1.2 even makes SOAPAction optional.

WARNING

THIS MODULE IS HERE FOR COMPATIBILITY REASONS ONLY, SO YOU CAN USE WHEN IN NEED TO IMPLEMENT A LEGACY SERVICE THAT USES THIS PSEUDO-STANDARD. THIS USAGE SCENARIO SHOULD NOT BE PROMOTED BY ANY WAY. THE CORRECT WAY TO IMPLEMENT THE SAME FUNCTIONALITY IS BY USING RPC/Literal, THAT WILL PRODUCE THE EXACT SAME MESSAGE BODY.

USE

The operation is dispatched according to the SOAPAction header. The operation name is extracted by removing the given prefix and assuming the rest of the SOAPAction is the effective operation name (removing "s).

TODO

Well, here? nothing, all the work is done in the superclass.

AUTHOR

Daniel Ruoso <daniel@ruoso.com>

BUG REPORTS

Please submit all bugs regarding Catalyst::Controller::SOAP to bug-catalyst-controller-soap@rt.cpan.org

LICENSE

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.