|new||For use by non-web scripts. Call this with a hash of attributes. Currently only the target_namespace key is used. It sets the namespace. Once you get your object, you can call soap_out on it as you would in a Gantry conroller.|
Only for use by Gantry.pm.
This is used to register steal_post_body as a pre init callback with Gantry.
Not for external use.
Just a carefully timed call to consume_post_body exported by each engine. This is registered as a pre_init callback, so it gets the body before normal form parameter parsing would.
You may retrieve with the post body with get_post_body (also exported by each engine). No processing of the request is done. You will receive whatever the SOAP client generated. That should be XML, but even that depends on the client.
|soap_current_time||Returns the UTC in SOAP format.|
|soap_serialize_xml||This method is registered as a callback. Durning the post_init phase it will create a hash from the $self->get_post_body() and store the result in $self->params();|
|soap_namespace||Called internally to retrieve the namespace for the XML tags in your SOAP response. Call soap_namespace_set if you need to set a particular namespace (some clients will care). Otherwise, the default namespace http://example.com/ns will be used.|
|soap_namespace_set||Use this to set the namespace for your the tags in your XML response. The default namespace is http://example.com/ns.|
Call this with the data to return to the client. If that client cares about the namespace of the tags in the response, call soap_namespace_set first. See the SYNOPSIS for an example of the structure you must pass to this method. See the DESCRIPTION for an explanation of what you can put in the structure.
You should return the value returned from this method directly. It turns off all templating and sets the content type to text/xml.
Mostly for internal use.
soap_out uses this to turn your structure of return values into an XML snippet. If you need to re-implement soap_out, you could call this directly. The initial call should pass the same structure soap_out expects and (optionally) a pretty print flag. The returned value is the snippet of return params only. You would then need to build the SOAP envelope, etc.
|return_error||This method returns a fault XML packet for you. Use it instead of die or croak.|
|do_wsdl||This method uses the wsdldoc.tt in your template path to return a WSDL file to your client. The view.data passed to that template comes directly from a call to get_soap_ops, which you must implement (even it it returns nothing).|
For clients. Sends the xml to the SOAP server. You must have called
new with action_url and post_to_url for this method to work. In
particular, servers which use this as a plugin cannot normally call
this method. First, they must call new to make an object of this
Parameters: an object of this class, the xml to send (get it from calling soap_out).
Returns: response from remote server (actually whatever request on the LWP user agent retruns, try calling content on that object)
Phil Crow, <email@example.com> Tim Keefer, <firstname.lastname@example.org<gt>
Copyright (c) 2007, Phil Crow
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.
|perl v5.20.3||GANTRY::PLUGINS::SOAP::DOC (3)||2016-04-03|