This article is about the computer network protocol. For other uses, see Soap (disambiguation).

| This article's lead section may not adequately summarize key points of its contents. Please consider expanding the lead to provide an accessible overview of all important aspects of the article. (June 2012)

SOAP, originally defined as Simple Object Access Protocol, is a protocol specification for exchanging structured information in the implementation of Web Services in computer networks. It relies on Extensible Markup Language (XML) for its message format, and usually relies on other Application Layer protocols, most notably Hypertext Transfer Protocol (HTTP) and Simple Mail Transfer Protocol (SMTP), for message negotiation and transmission.

## Characteristics[edit]

SOAP can form the foundation layer of a web services protocol stack, providing a basic messaging framework upon which web services can be built. This XML based protocol consists of three parts: an envelope, which defines what is in the message and how to process it, a set of encoding rules for expressing instances of application-defined datatypes, and a convention for representing procedure calls and responses. SOAP has three major characteristics: Extensibility (security and WS-routing are among the extensions under development), Neutrality (SOAP can be used over any transport protocol such as HTTP, SMTP, TCP, or JMS) and Independence (SOAP allows for any programming model).

As an example of how SOAP procedures can be used, a SOAP message could be sent to a web site that has web services enabled, such as a real-estate price database, with the parameters needed for a search. The site would then return an XML-formatted document with the resulting data, e.g., prices, location, features. With the data being returned in a standardized machine-parsable format, it can then be integrated directly into a third-party web site or application.

The SOAP architecture consists of several layers of specifications for: message format, Message Exchange Patterns (MEP), underlying transport protocol bindings, message processing models, and protocol extensibility. SOAP is the successor of XML-RPC, though it borrows its transport and interaction neutrality and the envelope/header/body from elsewhere (probably from WDDX).[citation needed]

## History[edit]

SOAP structure

SOAP was designed as an object-access protocol in 1998 by Dave Winer, Don Box, Bob Atkinson, and Mohsen Al-Ghosein for Microsoft, where Atkinson and Al-Ghosein were working at the time.[1] The SOAP specification is currently maintained by the XML Protocol Working Group of the World Wide Web Consortium.

SOAP originally stood for 'Simple Object Access Protocol' but this acronym was dropped with Version 1.2 of the standard.[2] Version 1.2 became a W3C recommendation on June 24, 2003. The acronym is sometimes confused with SOA, which stands for Service-oriented architecture, but the acronyms are unrelated.

After SOAP was first introduced, it became the underlying layer of a more complex set of Web Services, based on Web Services Description Language (WSDL) and Universal Description Discovery and Integration (UDDI). These services, especially UDDI, have proved to be of far less interest, but an appreciation of them gives a more complete understanding of the expected role of SOAP compared to how web services have actually evolved.

## Specification[edit]

The SOAP specification defines the messaging framework which consists of:

- The SOAP processing model defining the rules for processing a SOAP message
- The SOAP extensibility model defining the concepts of SOAP features and SOAP modules
- The SOAP underlying protocol binding framework describing the rules for defining a binding to an underlying protocol that can be used for exchanging SOAP messages between SOAP nodes
- The SOAP message construct defining the structure of a SOAP message

### Processing model[edit]

The SOAP processing model describes a distributed processing model, its participants, the SOAP nodes, and how a SOAP receiver processes a SOAP message. The following SOAP nodes are defined:

- SOAP sender

A SOAP node that transmits a SOAP message.

- SOAP receiver

A SOAP node that accepts a SOAP message.

- SOAP message path

The set of SOAP nodes through which a single SOAP message passes.

- Initial SOAP sender (Originator)

The SOAP sender that originates a SOAP message at the starting point of a SOAP message path.

- SOAP intermediary

A SOAP intermediary is both a SOAP receiver and a SOAP sender and is targetable from within a SOAP message. It processes the SOAP header blocks targeted at it and acts to forward a SOAP message towards an ultimate SOAP receiver.

- Ultimate SOAP receiver

The SOAP receiver that is a final destination of a SOAP message. It is responsible for processing the contents of the SOAP body and any SOAP header blocks targeted at it. In some circumstances, a SOAP message might not reach an ultimate SOAP receiver, for example because of a problem at a SOAP intermediary. An ultimate SOAP receiver cannot also be a SOAP intermediary for the same SOAP message.

## Transport methods[edit]

Both SMTP and HTTP are valid application layer protocols used as Transport for SOAP, but HTTP has gained wider acceptance as it works well with today's Internet infrastructure; specifically, HTTP works well with network firewalls. SOAP may also be used over HTTPS (which is the same protocol as HTTP at the application level, but uses an encrypted transport protocol underneath) with either simple or mutual authentication; this is the advocated WS-I method to provide web service security as stated in the WS-I Basic Profile 1.1.

This is a major advantage over other distributed protocols like GIOP/IIOP or DCOM which are normally filtered by firewalls. SOAP over AMQP is yet another possibility that some implementations support.[3]

There is also the SOAP-over-UDP OASIS standard.

## Message format[edit]

XML was chosen as the standard message format because of its widespread use by major corporations and open source development efforts. Additionally, a wide variety of freely available tools significantly eases the transition to a SOAP-based implementation. The somewhat lengthy syntax of XML can be both a benefit and a drawback. While it promotes readability for humans, facilitates error detection, and avoids interoperability problems such as byte-order (Endianness), it can slow processing speed and can be cumbersome. For example, CORBA, GIOP, ICE, and DCOM use much shorter, binary message formats. On the other hand, hardware appliances are available to accelerate processing of XML messages.[4][5] Binary XML is also being explored as a means for streamlining the throughput requirements of XML.

## Example message[edit]

    POST /InStock HTTP/1.1
    Host: www.example.org
    Content-Type: application/soap xml; charset=utf-8
    Content-Length: 299
    SOAPAction: "http://www.w3.org/2003/05/soap-envelope"

     version="1.0"?>
     xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
      >
      >
      >
         xmlns:m="http://www.example.org/stock">
          >IBM>
        >
      >
    >

## Technical critique[edit]

### Advantages[edit]

- SOAP is versatile enough to allow for the use of different transport protocols. The standard stacks use HTTP as a transport protocol, but other protocols such as JMS[6] and SMTP[7] are also usable.
- Since the SOAP model tunnels fine in the HTTP get/response model, it can tunnel easily over existing firewalls and proxies, without modifications to the SOAP protocol, and can use the existing infrastructure.

### Disadvantages[edit]

- Because of the verbose XML format, SOAP can be considerably slower than competing middleware technologies such as CORBA or ICE. This may not be an issue when only small messages are sent.[8] To improve performance for the special case of XML with embedded binary objects, the Message Transmission Optimization Mechanism was introduced.
- When relying on HTTP as a transport protocol and not using WS-Addressing or an ESB, the roles of the interacting parties are fixed. Only one party (the client) can use the services of the other. Developers must use polling instead of notification in these common cases.

## See also[edit]

- SOAP with Attachments
- SOAP with Attachments API for Java
- List of web service protocols
- Message Transmission Optimization Mechanism - MTOM
- XML-binary Optimized Packaging - XOP
- Extensible User Interface Protocol (XUP)?? a SOAP-based UI protocol
- SOAPjr?? a hybrid of SOAP and JR (JSON-RPC)
- WebSocket
- Web Services Security

## References[edit]

1. ^ "Exclusive .NET Developer's Journal "Indigo" Interview with Microsoft's Don Box". Dotnet.sys-con.com. Retrieved 2012-10-04.
2. ^ "SOAP Version 1.2 Part 1: Messaging Framework (Second Edition)". W3C. April 27, 2007. Retrieved 2012-06-15. "Note: In previous versions of this specification the SOAP name was an acronym. This is no longer the case. (Underneath section 1. Introduction)"
3. ^ SOAP Mapping [dead link]
4. ^ "IBM Datapower". 306.ibm.com. 2011-11-30. Retrieved 2012-10-04.
5. ^ "IBM Zurich XML Accelerator Engine" (PDF). Retrieved 2012-10-04.
6. ^ "SOAP over Java Message Service 1.0". W3C. June 4, 2009. Retrieved 2011-02-01.
7. ^ "SOAP Version 1.2 Part 0: Primer". W3C. December 17, 2001. Retrieved 2011-02-01.
8. ^ Olson, Mike; Ogbuji, Uche (July 3, 2002). "The Python Web services developer: Messaging technologies compared". IBM developerWorks. Retrieved 2011-02-01.

- Beno?t Marchal, "Soapbox: Why I'm using SOAP", IBM, [1]
- Uche Ogbuji, "Tutorial: XML messaging with SOAP", Principal Consultant, Fourthought, Inc.

## External links[edit]

- W3C SOAP page
- SOAP Version 1.2 specification
- Create SOAP Message in Java

World Wide Web Consortium
Products and standards |
Recommendations | Canonical XML CDF CSS DOM Geolocation API HTML ITS MathML OWL P3P PLS RDF RDF Schema SISR SKOS SMIL SOAP SRGS SSML SVG SPARQL Timed Text VoiceXML WSDL XForms XHTML XHTML+RDFa XInclude XLink XML XML Base XML Encryption XML Events XML Information Set XML namespace XML Schema XML Signature XOP XPath 1.0, 2.0 XPointer XProc XQuery XSL XSL-FO XSLT (elements)
Notes | XAdES XHTML+SMIL XUP
Working drafts | CCXML CURIE HTML5 InkML JSON-LD RIF SCXML SMIL Timesheets sXBL WICD XFDL XFrames XBL XMLHttpRequest
Guidelines | Web Content Accessibility Guidelines
Initiative | Multimodal Interaction Activity Markup Validation Service Web Accessibility Initiative WebPlatform
Deprecated | C-HTML HDML JSSS PGML VML XHTML+MathML+SVG
Organizations | World Wide Web Foundation SVG Working Group CSS Working Group HTML Working Group WebOnt W3C Device Description Working Group WHATWG
Software | Agora Argo Arena Amaya CERN httpd Libwww Line Mode Browser
Conference-related | IW3C2 World Wide Web Conference WWW1