soap::wsdl::manual::glossary(3pm) [debian man page]

SOAP::WSDL::Manual::Glossary(3pm)			User Contributed Perl Documentation			 SOAP::WSDL::Manual::Glossary(3pm)

NAME

       SOAP::WSDL::Manual::Glossary - Those acronyms and stuff

Glossary
   web service
       Web services are RPC (Remote Procedure Call) interfaces accessible via some internet protocol, typically via HTTP(S).

   SOAP
       SOAP is (was - since 1.2 the name "SOAP" has no meaning any more) an acronym for Simple Object Access Protocol.	SOAP is a W3C
       recommendation. The latest version of the SOAP specification may be found at <http://www.w3.org/TR/soap/>.

       SOAP defines a protocol for message exchange between applications.  The most popular usage is to use SOAP for remote procedure calls (RPC).

       While one of the constituting aspects of a web service is its reachability via some internet protocol, you might as well define SOAP
       services accessible via postcards.

       Despite it's former name, SOAP has nothing more to do with objects than cars have with pets - SOAP messages may, but not necessarily do
       carry objects, very much like your car may, but does not need to carry your pet.

   WSDL
       WSDL is an acronym for Web Services Description Language.  WSDL is a W3C recommendation. The latest version of the WSDL specification may
       be found at <http://www.w3.org/TR/wsdl20/>.

       WSDL defines a XML-based language for describing web service interfaces, including SOAP interfaces.

   WS-I
       WS-I (Web Services Interoperability Organization) is an open industry organisation chartered to promote Web service interoperability across
       platforms, operating systems, and programming languages.

       WS-I publishes profiles, which provide implementation guidelines for how related Web services specifications should be used together for
       best interoperability. To date, WS-I has finalized the Basic Profile, Attachments Profile and Simple SOAP Binding Profile.

       SOAP::WSDL aims at complying to the WS-I Basic Profile (but does not implement full support yet).

   SOAP message styles
       rpc

       Meant for transporting a RPC message. All contents of the SOAP body are put into a top-level node named equal to the SOAP operation.

       WS-I Basic Profile allows the use of rpc message style.

       SOAP::WSDL does not support rpc message style yet.

       SOAP::Lite supports rpc message style only.

       document

       Meant for transporting arbitrary content. No additional nodes are inserted between the SOAP body and the actual content.

       WS-I Basic Profile allows the use of document message style.

   SOAP encoding styles
       encoded

       literal

LICENSE AND COPYRIGHT

       Copyright 2007 Martin Kutter.

       This file is part of SOAP-WSDL. You may distribute/modify it under the same terms as perl itself.

AUTHOR

       Martin Kutter <martin.kutter fen-net.de>

REPOSITORY INFORMATION

	$Rev: 391 $
	$LastChangedBy: kutterma $
	$Id: Glossary.pod 391 2007-11-17 21:56:13Z kutterma $
	$HeadURL: https://soap-wsdl.svn.sourceforge.net/svnroot/soap-wsdl/SOAP-WSDL/trunk/lib/SOAP/WSDL/Manual/Glossary.pod $

perl v5.10.1							    2010-12-21					 SOAP::WSDL::Manual::Glossary(3pm)

Check Out this Related Man Page

SOAP::WSDL::Deserializer::SOM(3pm)			User Contributed Perl Documentation			SOAP::WSDL::Deserializer::SOM(3pm)

NAME

       SOAP::WSDL::Deserializer::SOM - Deserializer SOAP messages into SOM objects

SYNOPSIS

	use SOAP::WSDL;
	use SOAP::WSDL::Deserializer::SOM;
	use SOAP::WSDL::Factory::Deserializer;
	SOAP::WSDL::Factory::Deserializer->register( '1.1', __PACKAGE__ );

DESCRIPTION

       Deserializer for creating SOAP::Lite's SOM object as result of a SOAP call.

       This package is here for two reasons:

       o   Compatibility

	   You don't have to change the rest of your SOAP::Lite based app when switching to SOAP::WSDL, but can just use
	   SOAP::WSDL::Deserializer::SOM to get back the same objects as you were used to.

       o   Completeness

	   SOAP::Lite covers much more of the SOAP specification than SOAP::WSDL.

	   SOAP::WSDL::Deserializer::SOM can be used for content which cannot be deserialized by SOAP::WSDL::Deserializer::SOAP11.  This may be
	   XML including mixed content, attachements and other XML data not (yet) handled by SOAP::WSDL::Deserializer::SOAP11.

       SOAP::WSDL::Deserializer::SOM is a subclass of SOAP::Deserializer from the SOAP::Lite package.

METHODS

   deserialize
       Deserializes a XML sting into a SOAP::SOM object. Returns a SOAP::Fault object on deserialization errors.

   generate_fault
       Dies with a SOAP::Fault object.

USAGE

       SOAP::WSDL::Deserializer will not autoregister itself - to use it for a particular SOAP version just use the following lines:

	my $soap_version = '1.1'; # or '1.2', further versions may appear.

	use SOAP::WSDL::Deserializer::SOM;
	use SOAP::WSDL::Factory::Deserializer;
	SOAP::WSDL::Factory::Deserializer->register( $soap_version, __PACKAGE__ );

DIFFERENCES FROM OTHER CLASSES

   Differences from SOAP::Lite
       o   No on_fault handler

	   You cannot specify what to do when an error occurs - SOAP::WSDL will return a SOAP::Fault object on transport errors.

   Differences from other SOAP::WSDL::Deserializer classes
       o   generate_fault

	   SOAP::WSDL::Deserializer::SOM will die with a SOAP::Fault object on calls to generate_fault.

	   This also means that a SOAP::Fault may be thrown as exception when using

LICENSE AND COPYRIGHT

       Copyright 2004-2007 Martin Kutter.

       This file is part of SOAP-WSDL. You may distribute/modify it under the same terms as perl itself.

AUTHOR

       Martin Kutter <martin.kutter fen-net.de>

REPOSITORY INFORMATION

	$Rev: 851 $
	$LastChangedBy: kutterma $
	$Id: SOM.pm 851 2009-05-15 22:45:18Z kutterma $
	$HeadURL: https://soap-wsdl.svn.sourceforge.net/svnroot/soap-wsdl/SOAP-WSDL/trunk/lib/SOAP/WSDL/Deserializer/SOM.pm $

perl v5.10.1							    2010-12-21					SOAP::WSDL::Deserializer::SOM(3pm)

Linux and UNIX Man Pages

soap::wsdl::manual::glossary(3pm) [debian man page]

Check Out this Related Man Page