index.html 13 KB

Raw Blame History Permalink

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8" />
<title>SOAP 1.1 Request Optional Response HTTP Binding</title>

<style type="text/css">
/*<![CDATA[*/
code           { font-family: monospace; }

div.constraint,
div.issue,
div.note,
div.notice     { margin-left: 2em; }

dt.label       { display: run-in; }

li, p           { margin-top: 0.3em;
                 margin-bottom: 0.3em; }

.diff-chg       { background-color: yellow; }
.diff-del       { background-color: red; text-decoration: line-through;}
.diff-add       { background-color: lime; }

table          { empty-cells: show; }

table caption {
        font-weight: normal;
        font-style: italic;
        text-align: left;
        margin-bottom: .5em;
}

div.issue {
  color: red;
}

div.exampleInner pre { margin-left: 1em;
                       margin-top: 0em; margin-bottom: 0em}
div.exampleOuter {border: 4px double gray;
                  margin: 0em; padding: 0em}
div.exampleInner { background-color: #d5dee3;
                   border-top-width: 4px;
                   border-top-style: double;
                   border-top-color: #d3d3d3;
                   border-bottom-width: 4px;
                   border-bottom-style: double;
                   border-bottom-color: #d3d3d3;
                   padding: 4px; margin: 0em }
div.exampleWrapper { margin: 4px }
div.exampleHeader { font-weight: bold;
                    margin: 4px}
/*]]>*/
</style>
<link rel="stylesheet" type="text/css" href=
"http://www.w3.org/StyleSheets/TR/W3C-WG-NOTE.css" />
<link rel="contents" href="#contents" />
</head>
<body>
<div class="head">
<p><a href="http://www.w3.org/"><img src=
"http://www.w3.org/Icons/w3c_home" alt="W3C" height="48" width=
"72" /></a></p>
<h1>SOAP 1.1 Request Optional Response HTTP Binding</h1>
<h2>W3C Working Group Note 21 March 2006</h2>
<dl>
<dt>This version:</dt>
<dd><a href=
"http://www.w3.org/TR/2006/NOTE-soap11-ror-httpbinding-20060321/">http://www.w3.org/TR/2006/NOTE-soap11-ror-httpbinding-20060321/</a></dd>
<dt>Latest version:</dt>
<dd><a href=
"http://www.w3.org/TR/soap11-ror-httpbinding">http://www.w3.org/TR/soap11-ror-httpbinding</a></dd>
<dt>Editor:</dt>
<dd>David Orchard, BEA Systems</dd>
</dl>
<p class="copyright"><a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>&nbsp;©&nbsp;2006&nbsp;<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup>
(<a href="http://www.csail.mit.edu/"><acronym title=
"Massachusetts Institute of Technology">MIT</acronym></a>, <a href=
"http://www.ercim.org/"><acronym title=
"European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved.
W3C <a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
and <a href=
"http://www.w3.org/Consortium/Legal/copyright-documents">document
use</a> rules apply.</p>
</div>
<hr />
<div>
<h2><a name="abstract" id="abstract">Abstract</a></h2>
<p>SOAP Version 1.1 provides an HTTP binding for exchanging a
request and a response. This binding provides a "request optional
response" refinement that enables an HTTP response with status code
202 to have a SOAP envelope or to be empty.</p>
</div>
<div>
<h2><a name="status" id="status">Status of this Document</a></h2>
<p><em>This section describes the status of this document at the
time of its publication. Other documents may supersede this
document. A list of current W3C publications and the latest
revision of this technical report can be found in the <a href=
"http://www.w3.org/TR/">W3C technical reports index</a> at
http://www.w3.org/TR/.</em></p>
<p>This is a <a href=
"http://www.w3.org/2005/10/Process-20051014/tr.html#q75">Working
Group Note</a> produced by the <a href=
"http://www.w3.org/2002/ws/addr/">Web Services Addressing Working
Group</a> (WG), which is part of the <a href=
"http://www.w3.org/2002/ws/Activity">W3C Web Services Activity</a>.
It was produced while working on the <a href=
"http://www.w3.org/TR/ws-addr-soap/">Web Services Addressing 1.0 -
SOAP Binding</a> specification.</p>
<p>Comments on this document are invited and are to be sent to the
public <a href=
"mailto:public-ws-addressing-comments@w3.org">public-ws-addressing-comments@w3.org</a>
mailing list (<a href=
"http://lists.w3.org/Archives/Public/public-ws-addressing-comments/">public
archive</a>). If substantive comments are received, the Working
Group may revise this Working Group Note.</p>
<p>This document was produced by a group operating under the
<a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
February 2004 W3C Patent Policy</a>. This document is informative
only. W3C maintains a <a href=
"http://www.w3.org/2004/01/pp-impl/36696/status#specs">public list
of any patent disclosures</a> made in connection with the
deliverables of the group; that page also includes instructions for
disclosing a patent. An individual who has actual knowledge of a
patent which the individual believes contains <a href=
"http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">
Essential Claim(s)</a> must disclose the information in accordance
with <a href=
"http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">
section 6 of the W3C Patent Policy</a>.</p>
<p>Publication as a Working Group Note does not imply endorsement
by the W3C Membership. This is a draft document and may be updated,
replaced or obsoleted by other documents at any time. It is
inappropriate to cite this document as other than work in
progress.</p>
</div>
<hr />
<div class="toc">
<h2><a name="contents" id="contents">Table of Contents</a></h2>
<p class="toc">1. <a href="#intro">Introduction</a><br />
&nbsp;&nbsp;&nbsp;&nbsp;1.1 <a href="#notcon">Notational
Conventions</a><br />
2. <a href="#reqoptrespbinding">SOAP 1.1 request optional response
HTTP Binding</a><br />
3. <a href="#refs">References</a><br />
&nbsp;&nbsp;&nbsp;&nbsp;3.1 <a href="#refs-norm">Normative
References</a><br />
&nbsp;&nbsp;&nbsp;&nbsp;3.2 <a href="#refs-inform">Informative
References</a><br /></p>
<h3><a name="appendix" id="appendix">Appendix</a></h3>
<p class="toc">A. <a href="#acknowledgments">Acknowledgements</a>
(Non-Normative)<br /></p>
</div>
<hr />
<div class="body">
<div class="div1">
<h2><a name="intro" id="intro"></a>1. Introduction</h2>
<p>The SOAP 1.1 request optional response Binding (this document)
defines modification to the SOAP 1.1 HTTP Binding [<cite><a href=
"#soap11">SOAP 1.1</a></cite>] that enables an HTTP response with
status code 202 to have a SOAP envelope or to be empty.</p>
<div class="div2">
<h3><a name="notcon" id="notcon"></a>1.1 Notational
Conventions</h3>
<p>The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL"
in this document are to be interpreted as described in RFC 2119
[<cite><a href="#RFC2119">RFC 2119</a></cite>].</p>
<p>With the exception of examples and sections explicitly marked as
"Non-Normative", all parts of this specification are normative.</p>
</div>
</div>
<div class="div1">
<h2><a name="reqoptrespbinding" id="reqoptrespbinding"></a>2. SOAP
1.1 request optional response HTTP Binding</h2>
<p>This SOAP 1.1 request optional response HTTP binding, in
conjunction with the SOAP 1.1 binding [<cite><a href="#soap11">SOAP
1.1</a></cite>], can be used for sending request messages with an
optional SOAP response. This binding augments the SOAP 1.1 binding
by allowing that the HTTP [<cite><a href="#RFC2616">RFC
2616</a></cite>] response MAY have a 202 status code and the
response body MAY be empty. Note that the HTTP [<cite><a href=
"#RFC2616">RFC 2616</a></cite>] specification states "the 202
response is intentionally non-committal" and so any content in the
response body, including a SOAP Envelope, MAY not be an expected
SOAP response.</p>
</div>
<div class="div1">
<h2><a name="refs" id="refs"></a>3. References</h2>
<div class="div2">
<h3><a name="refs-norm" id="refs-norm"></a>3.1 Normative
References</h3>
<dl>
<dt class="label"><a name="soap11" id="soap11"></a>[SOAP 1.1]</dt>
<dd>W3C Note "<cite><a href=
"http://www.w3.org/TR/2000/NOTE-SOAP-20000508/">Simple Object
Access Protocol (SOAP) 1.1</a></cite>", Don Box, David Ehnebuske,
Gopal Kakivaya, Andrew Layman, Noah Mendelsohn, Henrik Nielsen,
Satish Thatte, Dave Winer, 8 May 2000.</dd>
<dt class="label"><a name="RFC2616" id="RFC2616"></a>[RFC
2616]</dt>
<dd>IETF "<cite><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC
2616: Hypertext Transfer Protocol -- HTTP/1.1</a></cite>", R.
Fielding, J. Gettys, J. C. Mogul, H. Frystyk, T. Berners-Lee,
January 1997.</dd>
<dt class="label"><a name="RFC2119" id="RFC2119"></a>[RFC
2119]</dt>
<dd>IETF "<cite><a href="http://www.ietf.org/rfc/rfc2119.txt">RFC
2119: Key words for use in RFCs to Indicate Requirement
Levels</a></cite>", S. Bradner, March 1997.</dd>
</dl>
</div>
<div class="div2">
<h3><a name="refs-inform" id="refs-inform"></a>3.2 Informative
References</h3>
<dl>
<dt class="label"><a name="SOAP-PART0" id="SOAP-PART0"></a>[SOAP
1.2 Part 0]</dt>
<dd>W3C Recommendation "<cite><a href=
"http://www.w3.org/TR/2003/REC-soap12-part0-20030624/">SOAP Version
1.2 Part 0: Primer</a></cite>", Nilo Mitra, 24 June 2003</dd>
<dt class="label"><a name="SOAP-PART1" id="SOAP-PART1"></a>[SOAP
1.2 Part 1]</dt>
<dd>W3C Recommendation "<cite><a href=
"http://www.w3.org/TR/2003/REC-soap12-part1-20030624/">SOAP Version
1.2 Part 1: Messaging Framework</a></cite>", Martin Gudgin, Marc
Hadley, Noah Mendelsohn, Jean-Jacques Moreau, Henrik Frystyk
Nielsen, 24 June 2003</dd>
<dt class="label"><a name="SOAP-PART2" id="SOAP-PART2"></a>[SOAP
1.2 Part 2]</dt>
<dd>W3C Recommendation "<cite><a href=
"http://www.w3.org/TR/2003/REC-soap12-part2-20030624/">SOAP Version
1.2 Part 2: Adjuncts Framework</a></cite>", Martin Gudgin, Marc
Hadley, Noah Mendelsohn, Jean-Jacques Moreau, Henrik Frystyk
Nielsen, 24 June 2003</dd>
<dt class="label"><a name="soap-media-type" id=
"soap-media-type"></a>[SOAP MediaType]</dt>
<dd>IETF "<cite><a href="http://www.ietf.org/rfc/rfc3902.txt">RFC
3902: The 'application/soap+xml' media type</a></cite>", M. Baker,
M. Nottingham, September, 2004.</dd>
<dt class="label"><a name="RFC3986" id="RFC3986"></a>[RFC
3986]</dt>
<dd>IETF "<cite><a href="http://www.ietf.org/rfc/rfc3986.txt">RFC
3986: Uniform Resource Identifiers (URI): Generic
Syntax</a></cite>", T. Berners-Lee, R. Fielding, L. Masinter,
January 2005.</dd>
</dl>
</div>
</div>
</div>
<div class="back">
<div class="div1">
<h2><a name="acknowledgments" id="acknowledgments"></a>A.
Acknowledgements (Non-Normative)</h2>
<p>This document is the work of the <a href=
"http://www.w3.org/2002/ws/addr/">W3C Web Service Addressing
Working Group</a>.</p>
<p>Members of the Working Group are (at the time of writing, and by
alphabetical order): Abbie Barbir (Nortel Networks), Andreas
Bjärlestam (ERICSSON), Dave Chappell (Sonic Software), Eran
Chinthaka (WSO2), Francisco Curbera (IBM Corporation), Glen Daniels
(Sonic Software), Vikas Deolaliker (Sonoa Systems, Inc.), Paul
Downey (BT), Jacques Durand (Fujitsu Limited), Robert Freund
(Hitachi, Ltd.), Marc Goodner (Microsoft Corporation), Arun Gupta
(Sun Microsystems, Inc.), Hugo Haas (W3C/ERCIM), Marc Hadley (Sun
Microsystems, Inc.), David Hull (TIBCO Software, Inc.), Yin-Leng
Husband (HP), David Illsley (IBM Corporation), Anish Karmarkar
(Oracle Corporation), Paul Knight (Nortel Networks), Philippe Le
Hégaret (W3C/MIT), Amelia Lewis (TIBCO Software, Inc.), Bozhong Lin
(IONA Technologies, Inc.), Mark Little (JBoss Inc.), Jonathan Marsh
(Microsoft Corporation), Jeff Mischkinsky (Oracle Corporation),
Nilo Mitra (ERICSSON), Eisaku Nishiyama (Hitachi, Ltd.), Ales Novy
(Systinet Inc.), David Orchard (BEA Systems, Inc.), Gilbert Pilz
(BEA Systems, Inc.), Tony Rogers (Computer Associates), Tom Rutt
(Fujitsu Limited), Davanum Srinivas (WSO2), Jiri Tejkl (Systinet
Inc.), Mike Vernal (Microsoft Corporation), Steve Vinoski (IONA
Technologies, Inc.), Katy Warr (IBM Corporation), Pete Wenzel (Sun
Microsystems, Inc.), Steve Winkler (SAP AG), Ümit Yalçinalp (SAP
AG), Prasad Yendluri (webMethods, Inc.).</p>
<p>Previous members of the Working Group were: Lisa Bahler (SAIC -
Telcordia Technologies), Rebecca Bergersen (IONA Technologies,
Inc.), Ugo Corda (Sun Microsystems, Inc.), Michael Eder (Nokia),
Yaron Goland (BEA Systems, Inc.), Marc Goodner (SAP AG), Martin
Gudgin (Microsoft Corporation), Mark Nottingham (BEA Systems,
Inc.), Mark Peel (Novell, Inc.), Harris Reynolds (webMethods,
Inc.), Rich Salz (IBM Corporation), Davanum Srinivas (Computer
Associates), Greg Truty (IBM Corporation).</p>
<p>The people who have contributed to <a href=
"http://lists.w3.org/Archives/Public/public-ws-addressing/">discussions
on public-ws-addressing@w3.org</a> are also gratefully
acknowledged.</p>
</div>
</div>
</body>
</html>