You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
305 lines
13 KiB
305 lines
13 KiB
<!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> © 2006 <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 />
|
|
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 />
|
|
3.1 <a href="#refs-norm">Normative
|
|
References</a><br />
|
|
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>
|