- From: Sanjiva Weerawarana <sweeraw@dev.w3.org>
- Date: Wed, 23 Jun 2004 19:18:37 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20 In directory hutz:/tmp/cvs-serv16618 Modified Files: wsdl20-bindings.html wsdl20-bindings.xml Log Message: updated rest of soap binding Index: wsdl20-bindings.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-bindings.xml,v retrieving revision 1.39 retrieving revision 1.40 diff -C2 -d -r1.39 -r1.40 *** wsdl20-bindings.xml 23 Jun 2004 18:25:44 -0000 1.39 --- wsdl20-bindings.xml 23 Jun 2004 19:18:35 -0000 1.40 *************** *** 78,82 **** </header> <body> ! <!-- ******************************************************************* --> <div1 id="intro"> <head>Introduction</head> --- 78,84 ---- </header> <body> ! ! <!-- *************************************************************** --> ! <div1 id="intro"> <head>Introduction</head> *************** *** 191,195 **** </div2> </div1> ! <!-- ******************************************************************* --> <div1 id="soap-binding"> <head>WSDL SOAP Binding</head> --- 193,199 ---- </div2> </div1> ! ! <!-- *************************************************************** --> ! <div1 id="soap-binding"> <head>WSDL SOAP Binding</head> *************** *** 249,309 **** <!-- +++++++++ --> - <div2 id="soap-syntax"> - <head>XML Syntax Summary (Non-Normative)</head> - <eg xml:space="preserve"> - <definitions > - <binding name="<emph>xs:NCName</emph>" interface="<emph>xs:QName</emph>"? type="<emph>xs:anyURI</emph>" - <b>wsoap:protocol</b>="<emph>xs:anyURI</emph>" - <b>wsoap:mepDefault</b>="<emph>xs:anyURI</emph>"? > - <documentation />? - - <<b>wsoap:module</b> uri="<emph>xs:anyURI</emph>" required="<emph>xs:boolean</emph>"? > - <documentation />? - <property ... />? - </<b>wsoap:module</b>>* - - <feature ... />* - <property ... />* - - <fault ref="<emph>xs:QName</emph>" - <b>wsoap:code</b>="<emph>xs:QName</emph>" - <b>wsoap:subcodes</b>="<emph>list of xs:QName</emph>" > - <documentation />? - </fault>* - - <operation ref="<emph>xs:QName</emph>" - <b>wsoap:mep</b>="<emph>xs:anyURI</emph>"? - <b>wsoap:action</b>="<emph>xs:anyURI</emph>"? > - <documentation />? - - <<b>wsoap:module</b> ... />* - - <input messageLabel="<emph>xs:NCName</emph>"? > - <documentation />? - <<b>wsoap:module</b> ... />* - <feature ... />* - <property ... />* - </input>* - - <output messageLabel="<emph>xs:NCName</emph>"? > - <documentation />? - <<b>wsoap:module</b> ... />* - <feature ... />* - <property ... />* - </output>* - </operation>* - - </binding> - - <service> - <endpoint name="<emph>xs:NCName</emph>" binding="<emph>xs:QName</emph>" address="<emph>xs:anyURI</emph>"? > - <documentation />? - <endpoint> - </service> - </definitions> - </eg> - </div2> - - <!-- +++++++++ --> <div2 id="soap-defaults"> --- 253,256 ---- *************** *** 439,442 **** --- 386,390 ---- <div3 id="soap-binding-decl-xml"> <head>XML Representation</head> + <eg xml:space="preserve"><definitions > <binding name="<emph>xs:NCName</emph>" interface="<emph>xs:QName</emph>"? type="<emph>xs:anyURI</emph>" *************** *** 447,451 **** </eg> <p>The XML representation for specifying the SOAP protocol ! is an &AII; with the following Infoset properties: </p> <ulist> <item> --- 395,400 ---- </eg> <p>The XML representation for specifying the SOAP protocol ! is a REQUIRED &AII; with the following Infoset properties: </p> ! <ulist> <item> *************** *** 462,467 **** <div3 id="soap-binding-decl-mapping"> ! <head>Mapping Between Binding Component Extension Properties ! and XML Representation</head> <table border="1" id="tab_SOAP_Binding_Mapping"> --- 411,418 ---- <div3 id="soap-binding-decl-mapping"> ! <head>Mapping Between Component Properties and XML ! Representation</head> ! ! <p>See <specref ref="tab_SOAP_Binding_Mapping"/>.</p> <table border="1" id="tab_SOAP_Binding_Mapping"> *************** *** 510,513 **** --- 461,465 ---- <div3 id="soap-default-mep-decl-xml"> <head>XML Representation</head> + <eg xml:space="preserve"><definitions > <binding name="<emph>xs:NCName</emph>" interface="<emph>xs:QName</emph>"? type="<emph>xs:anyURI</emph>" *************** *** 518,523 **** </definitions> </eg> ! <p>The XML representation for specifying the default SOAP MEP ! is an &AII; with the following Infoset properties: </p> <ulist> <item> --- 470,478 ---- </definitions> </eg> ! ! <p>The XML representation for specifying the default SOAP ! MEP is an OPTIONAL &AII; with the following Infoset ! properties: </p> ! <ulist> <item> *************** *** 600,618 **** <eg xml:space="preserve"><definitions > ! <binding > ! <<b>wsoap:module</b> uri="uri" ! required="boolean"? > ! <property ... />? ! </<b>wsoap:module</b>> ! <operation> ! <<b>wsoap:module</b> ... />* ! <input> ! <<b>wsoap:module</b> ... />* ! </input> ! <output> ! <<b>wsoap:module</b> ... />* ! </output> ! </operation> ! </binding> </definitions> </eg> --- 555,573 ---- <eg xml:space="preserve"><definitions > ! <binding > ! <<b>wsoap:module</b> uri="uri" ! required="boolean"? > ! <property ... />? ! </<b>wsoap:module</b>> ! <operation> ! <<b>wsoap:module</b> ... />* ! <input> ! <<b>wsoap:module</b> ... />* ! </input> ! <output> ! <<b>wsoap:module</b> ... />* ! </output> ! </operation> ! </binding> </definitions> </eg> *************** *** 687,696 **** </div3> <div3 id="soap-module-decl-mapping"> ! <head>Mapping Between SOAP Module's XML Representation to Component ! Properties</head> ! <p>The mapping between the properties of the SOAP Module component ! and the XML representation of the <el>wsoap:module</el> ! &EII; is as ! described in <specref ref="tab_SOAP_Module_Mapping"/>.</p> <table border="1" id="tab_SOAP_Module_Mapping"> <caption>Mapping between SOAP Module Component Properties and XML --- 642,650 ---- </div3> <div3 id="soap-module-decl-mapping"> ! <head>Mapping Between Component Properties and XML ! Representation</head> ! ! <p>See <specref ref="tab_SOAP_Module_Mapping"/>.</p> ! <table border="1" id="tab_SOAP_Module_Mapping"> <caption>Mapping between SOAP Module Component Properties and XML *************** *** 719,832 **** <div2 id="soap-fault-decl"> ! <head>Indicating a SOAP Fault</head> <div3 id="soap-fault-decl-relate"> <head>Relationship to WSDL Component Model</head> ! <p>The SOAP Fault component adds a new property named {soap fault} ! to the Fault component (defined in <bibref ref="WSDL-PART1"/>).</p> ! </div3> ! <div3 id="soap-fault-decl-property"> ! <head>SOAP Fault Component</head> ! <p>A given Fault component is declared to be a SOAP fault by the ! presence of the SOAP Fault component.</p> ! <p>The properties of the SOAP Fault component are as follows:</p> <ulist> ! <item> ! <p>{fault code} A QName as defined by <bibref ref="XML10"/>. ! The value of this property identifies a possible SOAP fault ! (see <bibref ref="SOAP12-PART1"/>) for the operation in scope.</p> ! </item> ! <item> ! <p>{fault subcodes} A list of QName's, space separated. ! The value of this property identifies one or more subcodes ! for this SOAP fault.</p> </item> </ulist> </div3> <div3 id="soap-fault-decl-xml"> ! <head>XML Representation of SOAP Fault Component</head> ! <eg xml:space="preserve"><fault ref="xs:QName" ! <b>wsoap:code</b>="xs:QName" ! <b>wsoap:subcodes</b>="list of xs:QName" /> ! </fault>* </eg> ! <p>The XML representation for a SOAP Fault component is an &EII; ! with the following Infoset properties: </p> <ulist> ! <item> ! <p>A [local name] of <el>fault</el> ! </p> ! </item> ! <item> ! <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p> ! </item> ! <item> ! <p>One or more &AII;s amongst its [attributes] as follows:</p> <ulist> ! <item> ! <p>A REQUIRED <att>code</att> ! &AII; with the following ! Infoset properties:</p> ! <ulist> ! <item> ! <p>A [local name] of <att>code</att> ! </p> ! </item> ! <item> ! <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p> ! </item> ! </ulist> ! </item> ! <item> ! <p>An OPTIONAL <att>subcodes</att> ! &AII; with the ! following Infoset properties:</p> ! <ulist> ! <item> ! <p>A [local name] of <att>subcodes</att> ! </p> ! </item> ! <item> ! <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p> ! </item> ! </ulist> ! </item> ! <item> ! <p>Zero or more namespace qualified &AII;s. The [namespace ! name] of such &AII;s MUST NOT be <attval>http://www.w3.org/@@@@/@@/wsdl</attval> and ! MUST NOT be <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval>. </p> ! </item> </ulist> </item> ! <item> ! <p>Zero or more &EII; amongst its [children], in order, as ! follows:</p> ! <olist> ! <item> ! <p>An OPTIONAL <el>documentation</el> ! &EII;.</p> ! </item> ! <item> ! <p>Zero or more namespace-qualified &EII;s amongst its ! [children]. The [namespace name] of such &EII;s MUST NOT be ! <attval>http://www.w3.org/@@@@/@@/wsdl</attval> and MUST NOT be ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval>.</p> ! </item> ! </olist> </item> </ulist> </div3> <div3 id="soap-fault-decl-mapping"> ! <head>Mapping Between SOAP Fault's XML Representation to Component ! Properties</head> ! <p>The mapping between the properties of the SOAP Fault component ! and the XML representation of the <el>wsoap:fault</el> ! &EII; is as ! described in <specref ref="tab_SOAP_Fault_Mapping"/>.</p> <table border="1" id="tab_SOAP_Fault_Mapping"> <caption>Mapping between SOAP Fault Component Properties and XML --- 673,753 ---- <div2 id="soap-fault-decl"> ! <head>Binding Faults</head> ! ! <div3 id="soap-fault-decl-description"> ! <head>Description</head> ! ! <p>For every Interface Fault component contained in an ! Interface component, a mapping to a SOAP Fault must be ! described. This binding specification allows the user to ! indicate the SOAP fault code and subcodes that are ! transmitted for a given Interface Fault component.</p> ! </div3> ! <div3 id="soap-fault-decl-relate"> <head>Relationship to WSDL Component Model</head> ! ! <p>The SOAP Fault binding adds the following ! properties to the WSDL component model (as defined in <bibref ! ref="WSDL-PART1"/>):</p> ! <ulist> ! <item><p>{soap fault code}, a QName as defined by <bibref ! ref="XML10"/>, to the Binding Fault component. The value ! of this property identifies a possible SOAP fault (see ! <bibref ref="SOAP12-PART1"/>) for the operation in ! scope.</p> </item> ! ! <item><p>{soap fault subcodes}, a list of QNames, to the ! Binding Fault component. The value of this property ! identifies one or more subcodes for this SOAP fault.</p> </item> </ulist> </div3> + <div3 id="soap-fault-decl-xml"> ! <head>XML Representation</head> ! ! <eg xml:space="preserve"><definitions > ! <binding > ! <fault ref="xs:QName" ! <b>wsoap:code</b>="xs:QName" ! <b>wsoap:subcodes</b>="list of xs:QName"? /> ! </fault>* ! </binding> ! </definitions> </eg> ! ! <p>The XML representation for binding a SOAP Fault are two ! &AII;s with the following Infoset properties: </p> ! <ulist> ! <item><p>wsoap:code REQUIRED &AII;</p> <ulist> ! <item><p>A [local name] of <el>code</el></p></item> ! ! <item> <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p></item> </ulist> </item> ! <item><p>wsoap:subcodes OPTIONAL &AII;</p> ! <ulist> ! <item><p>A [local name] of <el>subcodes</el></p></item> ! ! <item> <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p></item> ! </ulist> </item> </ulist> </div3> + <div3 id="soap-fault-decl-mapping"> ! <head>Mapping Between Component Properties and XML ! Representation</head> ! ! <p>See <specref ref="tab_SOAP_Fault_Mapping"/>.</p> ! <table border="1" id="tab_SOAP_Fault_Mapping"> <caption>Mapping between SOAP Fault Component Properties and XML *************** *** 851,993 **** </div3> </div2> <!-- +++++++++ --> <div2 id="soap-operation-decl"> ! <head>Indicating a SOAP Operation</head> <div3 id="soap-operation-decl-relate"> <head>Relationship to WSDL Component Model</head> ! <p>The SOAP Operation component adds a new property named {soap operation} ! to the Operation component (defined in <bibref ref="WSDL-PART1"/>).</p> ! </div3> ! <div3 id="soap-operation-decl-property"> ! <head>SOAP Operation Component</head> ! <p>A given Operation component is declared to be a SOAP message exchange ! by the presence of the SOAP Operation component.</p> ! <p>The properties of the SOAP Operation component are as follows:</p> <ulist> ! <item> ! <p>{message exchange pattern} An absolute URI as ! defined by <bibref ref="RFC2396"/>. The value of this property ! identifies, if present, the SOAP Message Exchange Pattern (MEP) (as ! defined by <bibref ref="SOAP12-PART1"/>) for this specific operation. ! Otherwise, the {default message exchange pattern} of the SOAP Binding ! component applies. One or the other MUST be present.</p> ! <p>The SOAP MEP identified by {message exchange pattern} ! MUST be compatible with the {pattern} of the Interface ! Operation component (see <bibref ref="WSDL-PART1"/>).</p> ! </item> ! <item> ! <p>{Web method} A string value indicating, if present, the ! value for the SOAP Web Method Feature (as defined by <bibref ref="SOAP12-PART1"/>) for this specific operation. Otherwise, ! the {default Web method} of the SOAP Binding component applies. ! One or the other MUST be present</p> ! </item> ! <item> ! <p>{action} An absolute URI as defined by <bibref ref="RFC2396"/>. The value of this property identifies the value ! of the SOAP Action Features (as defined by <bibref ref="SOAP12-PART1"/>) for this specific operation.</p> </item> </ulist> </div3> <div3 id="soap-operation-decl-xml"> ! <head>XML Representation of SOAP Operation Component</head> ! <eg xml:space="preserve"><definitions> ! <binding> ! <operation> ! <<b>wsoap:operation</b> action="xs:anyURI" /> ? ! </operation> ! </binding> </definitions> </eg> ! <p>The XML representation for a SOAP Operation component is an &EII; ! with the following Infoset properties: </p> <ulist> ! <item> ! <p>A [local name] of <el>operation</el> ! </p> ! </item> ! <item> ! <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p> ! </item> ! <item> ! <p>One or more &AII;s amongst its [attributes] as follows:</p> <ulist> ! <item> ! <p>A REQUIRED <att>mep</att> ! &AII; with the following ! Infoset properties:</p> ! <ulist> ! <item> ! <p>A [local name] of <att>mep</att> ! </p> ! </item> ! <item> ! <p>A [namespace name] which has no value</p> ! </item> ! </ulist> ! </item> ! <item> ! <p>An OPTIONAL <att>webMethod</att> ! &AII; with the ! following Infoset properties:</p> ! <ulist> ! <item> ! <p>A [local name] of <att>webMethod</att> ! </p> ! </item> ! <item> ! <p>A [namespace name] which has no value</p> ! </item> ! </ulist> ! </item> ! <item> ! <p>An OPTIONAL <att>action</att> ! &AII; with the ! following Infoset properties:</p> ! <ulist> ! <item> ! <p>A [local name] of <att>action</att> ! </p> ! </item> ! <item> ! <p>A [namespace name] which has no value</p> ! </item> ! </ulist> ! </item> ! <item> ! <p>Zero or more namespace qualified &AII;s. The [namespace ! name] of such &AII;s MUST NOT be <attval>http://www.w3.org/@@@@/@@/wsdl</attval> and ! MUST NOT be <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval>. </p> ! </item> </ulist> </item> ! <item> ! <p>Zero or more &EII; amongst its [children], in order, as ! follows:</p> ! <olist> ! <item> ! <p>An OPTIONAL <el>documentation</el> ! &EII;.</p> ! </item> ! <item> ! <p>Zero or more namespace-qualified &EII;s amongst its ! [children]. The [namespace name] of such &EII;s MUST NOT be ! <attval>http://www.w3.org/@@@@/@@/wsdl</attval> and MUST NOT be ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval>.</p> ! </item> ! </olist> </item> </ulist> </div3> <div3 id="soap-operation-decl-mapping"> ! <head>Mapping Between SOAP Operation's XML Representation to Component ! Properties</head> ! <p>The mapping between the properties of the SOAP Operation component ! and the XML representation of the <el>wsoap:operation</el> ! &EII; is as ! described in <specref ref="tab_SOAP_Operation_Mapping"/>.</p> <table border="1" id="tab_SOAP_Operation_Mapping"> ! <caption>Mapping between SOAP Operation Component Properties and XML ! Representation</caption> <tbody> <tr> --- 772,869 ---- </div3> </div2> + <!-- +++++++++ --> + <div2 id="soap-operation-decl"> ! <head>Binding Operations</head> ! ! <div3 id="soap-operation-decl-description"> ! <head>Description</head> ! ! <p>For every Interface Operation component contained in an ! Interface component, in addition to the default binding ! rules described in <specref ref="soap-defaults"/>, there may ! be additional binding information to be specified. This ! binding specification allows the user to indicate the SOAP ! Message Exchange Pattern (MEP) and a value for the SOAP ! Action Feature (see <bibref ref="SOAP12-PART2"/>) on a ! per-operation basis.</p> ! </div3> ! <div3 id="soap-operation-decl-relate"> <head>Relationship to WSDL Component Model</head> ! ! <p>The SOAP Operation binding specification adds the ! following property to the WSDL component model (as defined ! in <bibref ref="WSDL-PART1"/>):</p> ! <ulist> ! <item><p>{soap mep}, an absolute URI as defined by <bibref ! ref="RFC2396"/>, to the Binding Operation component. The ! value of this property identifies the SOAP Message ! Exchange Pattern (MEP) (as defined by <bibref ! ref="SOAP12-PART1"/>) for this specific operation. If no ! specific value is assigned, then the value assigned by the ! default rules apply (see <specref ! ref="soap-defaults"/>). It is an error for this property ! to not have a value (which MAY happen if the default rules ! are not applicable).</p></item> ! ! <item><p>{soap action}, an absolute URI as defined by <bibref ! ref="RFC2396"/>, to the Binding Operation component. The ! value of this property identifies the value of the SOAP ! Action Feature (as defined by <bibref ! ref="SOAP12-PART1"/>) for this specific operation.</p> </item> </ulist> </div3> + <div3 id="soap-operation-decl-xml"> ! <head>XML Representation</head> ! ! <eg xml:space="preserve"><definitions > ! <binding > ! <operation ref="<emph>xs:QName</emph>" ! <b>wsoap:mep</b>="<emph>xs:anyURI</emph>"? ! <b>wsoap:action</b>="<emph>xs:anyURI</emph>"? > ! </operation> ! </binding> </definitions> </eg> ! ! <p>The XML representation for binding an Operation are two ! &AII;s with the following Infoset properties: </p> ! <ulist> ! <item><p>wsoap:mep OPTIONAL &AII;</p> <ulist> ! <item><p>A [local name] of <el>mep</el></p></item> ! ! <item> <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p></item> </ulist> </item> ! <item><p>wsoap:action OPTIONAL &AII;</p> ! <ulist> ! <item><p>A [local name] of <el>action</el></p></item> ! ! <item> <p>A [namespace name] of ! <attval>http://www.w3.org/@@@@/@@/wsdl/soap12</attval> ! </p></item> ! </ulist> </item> </ulist> </div3> + <div3 id="soap-operation-decl-mapping"> ! <head>Mapping Between Component Properties and XML ! Representation</head> ! ! <p>See <specref ref="tab_SOAP_Operation_Mapping"/>.</p> ! <table border="1" id="tab_SOAP_Operation_Mapping"> ! <caption>Mapping between SOAP Operation Component ! Properties and XML Representation</caption> <tbody> <tr> *************** *** 996,1014 **** </tr> <tr> ! <td rowspan="1" colspan="1">{message exchange pattern}</td> ! <td rowspan="1" colspan="1">The actual value of the <att>mep</att> ! &AII;.</td> ! </tr> ! <tr> ! <td rowspan="1" colspan="1">{Web method}</td> ! <td rowspan="1" colspan="1">The actual value of the <att>webMethod</att> ! &AII;.</td> ! <td rowspan="1" colspan="1"> ! </td> </tr> <tr> ! <td rowspan="1" colspan="1">{action}</td> ! <td rowspan="1" colspan="1">The actual value of the <att>action</att> ! &AII;.</td> </tr> </tbody> --- 872,888 ---- </tr> <tr> ! <td rowspan="1" colspan="1">{soap mep}</td> <td ! rowspan="1" colspan="1">The actual value of the ! <att>wsoap:mep</att> &AII;, if present. If not, the ! actual value of the <att>wsoap:mepDefault</att> &AII; ! of the parent wsdl:binding &EII;, if present. If not ! the value as defined by the default SOAP binding rules ! (see <specref ref="soap-defaults"/>), if ! applicable.</td> </tr> <tr> ! <td rowspan="1" colspan="1">{soap action}</td> ! <td rowspan="1" colspan="1">The actual value of the ! <att>action</att> &AII;., if any.</td> </tr> </tbody> *************** *** 1016,1021 **** </div3> </div2> </div1> ! <!-- ******************************************************************* --> <div1 id="http-binding"> <head>WSDL HTTP Binding</head> --- 890,957 ---- </div3> </div2> + + <!-- +++++++++ --> + + <div2 id="soap-syntax"> + <head>XML Syntax Summary (Non-Normative)</head> + + <eg xml:space="preserve"> + <definitions > + <binding name="<emph>xs:NCName</emph>" interface="<emph>xs:QName</emph>"? type="<emph>xs:anyURI</emph>" + <b>wsoap:protocol</b>="<emph>xs:anyURI</emph>" + <b>wsoap:mepDefault</b>="<emph>xs:anyURI</emph>"? > + <documentation />? + + <<b>wsoap:module</b> uri="<emph>xs:anyURI</emph>" required="<emph>xs:boolean</emph>"? > + <documentation />? + <property ... />? + </<b>wsoap:module</b>>* + + <feature ... />* + <property ... />* + + <fault ref="<emph>xs:QName</emph>" + <b>wsoap:code</b>="<emph>xs:QName</emph>" + <b>wsoap:subcodes</b>="<emph>list of xs:QName</emph>"? > + <documentation />? + </fault>* + + <operation ref="<emph>xs:QName</emph>" + <b>wsoap:mep</b>="<emph>xs:anyURI</emph>"? + <b>wsoap:action</b>="<emph>xs:anyURI</emph>"? > + <documentation />? + + <<b>wsoap:module</b> ... />* + + <input messageLabel="<emph>xs:NCName</emph>"? > + <documentation />? + <<b>wsoap:module</b> ... />* + <feature ... />* + <property ... />* + </input>* + + <output messageLabel="<emph>xs:NCName</emph>"? > + <documentation />? + <<b>wsoap:module</b> ... />* + <feature ... />* + <property ... />* + </output>* + </operation>* + + </binding> + + <service> + <endpoint name="<emph>xs:NCName</emph>" binding="<emph>xs:QName</emph>" address="<emph>xs:anyURI</emph>"? > + <documentation />? + <endpoint> + </service> + </definitions> + </eg> + </div2> + </div1> ! ! <!-- *************************************************************** --> ! <div1 id="http-binding"> <head>WSDL HTTP Binding</head> *************** *** 2416,2419 **** --- 2352,2361 ---- <td>20040624</td> <td>SW</td> + <td>Update the rest of the SOAP binding stuff and consistified + everything.</td> + </tr> + <tr> + <td>20040624</td> + <td>SW</td> <td>Cleaned up how SOAP modules were described. Added default SOAP MEP stuff.</td> Index: wsdl20-bindings.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-bindings.html,v retrieving revision 1.34 retrieving revision 1.35 diff -C2 -d -r1.34 -r1.35 *** wsdl20-bindings.html 23 Jun 2004 18:25:44 -0000 1.34 --- wsdl20-bindings.html 23 Jun 2004 19:18:35 -0000 1.35 *************** *** 83,91 **** <hr><div class="toc"> <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#soap-binding">WSDL SOAP Binding</a><br>3. <a href="#http-binding">WSDL HTTP Binding</a><br>4. <a href="#References">References</a><br>A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>B. <a href="#changelog">Part 3 Change Log</a> (Non-Normative)<br></p></div><hr><div class="toc"> ! <h2><a name="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="#soap-binding">WSDL SOAP Binding</a><br> 2.1 <a href="#soap-syntax">XML Syntax Summary (Non-Normative)</a><br> 2.2 <a href="#soap-defaults">Default Binding Rules</a><br> 2.3 <a href="#soap-binding-decl">Identifying a SOAP Binding</a><br> 2.4 <a href="#soap-protocol">Specifying the SOAP Protocol</a><br> 2.4.1 <a href="#soap-protocol-description">Description</a><br> 2.4.2 <a href="#soap-protocol-relate">Relationship to WSDL Component Model</a><br> 2.4.3 <a href="#soap-binding-decl-xml">XML Representation</a><br> 2.4.4 <a href="#soap-binding-decl-mapping">Mapping Between Binding Component Extension Properties ! and XML Representation</a><br> 2.5 <a href="#soap-default-mep-decl">Specifying the Default SOAP MEP</a><br> 2.5.1 <a href="#soap-default-mep-decl-description">Description</a><br> 2.5.2 <a href="#soap-default-mep-decl-relate">Relationship to WSDL Component Model</a><br> 2.5.3 <a href="#soap-default-mep-decl-xml">XML Representation</a><br> 2.6 <a href="#soap-module-decl">Declaring SOAP Modules</a><br> 2.6.1 <a href="#soap-module-decl-description">Description</a><br> 2.6.2 <a href="#soap-module-decl-relate">Relationship to WSDL Component Model</a><br> 2.6.3 <a href="#soap-module-decl-property">SOAP Module Component</a><br>   ; 2.6.4 <a href="#soap-module-decl-xml">XML Representation</a><br> 2.6.5 <a href="#soap-module-decl-mapping">Mapping Between SOAP Module's XML Representation to Component ! Properties</a><br> 2.7 <a href="#soap-fault-decl">Indicating a SOAP Fault</a><br> 2.7.1 <a href="#soap-fault-decl-relate">Relationship to WSDL Component Model</a><br> 2.7.2 <a href="#soap-fault-decl-property">SOAP Fault Component</a><br> 2.7.3 <a href="#soap-fault-decl-xml">XML Representation of SOAP Fault Component</a><br> 2.7.4 <a href="#soap-fault-decl-mapping">Mapping Between SOAP Fault's XML Representation to Component ! Properties</a><br> 2.8 <a href="#soap-operation-decl">Indicating a SOAP Operation</a><br> 2.8.1 <a href="#soap-operation-decl-relate">Relationship to WSDL Component Model</a><br> 2.8.2 <a href="#soap-operation-decl-property">SOAP Operation Component</a><br> 2.8.3 <a href="#soap-operation-decl-xml">XML Representation of SOAP Operation Component</a><br> 2.8.4 <a href="#soap-operation-decl-mapping">Mapping Between SOAP Operation's XML Representation to Component ! Properties</a><br>3. <a href="#http-binding">WSDL HTTP Binding</a><br> 3.1 <a href="#http-syntax">HTTP Syntax Summary (Non-Normative)</a><br> 3.2 <a href="#http-binding-decl">Indicating an HTTP Binding</a><br> 3.2.1 <a href="#http-binding-decl-relate">Relationship to WSDL Component Model</a><br> 3.2.2 <a href="#http-binding-decl-property">HTTP Binding Component</a><br> 3.2.3 <a href="#http-binding-decl-xml">XML Representation of HTTP Binding Component</a><br> 3.2.4 <a href="#http-binding-decl-mapping">Mapping Between HTTP Binding's XML Representation to Component Properties</a><br> 3.3 <a href="#_http_binding_methodDefault">Default Binding Rules</a><br> 3.4 <a href="#http-operation-decl">Indicating an HTTP Operation</a><br> 3.4.1 <a href="#http-operation-decl-relate">Relationship to WSDL Component Model</a><br> 3.4.2 <a href="#http-operation-decl-property">HTTP Operation Component</a><br> 3.4.3 <a href="#http-operation-decl-xml">XML Representation of HTTP Operation Component</a><br> 3.4.4 <a href="#http-operation-decl-mapping">Mapping Between HTTP Operation's XML Representation to Component Properties</a><br> 3.5 <a href="#_operation_styles">Operation Styles</a><br> 3.5.1 <a href="#_operation_uri_style">URI Style</a><br> 3.5.2 <a href="#_operation_multipart_style">Multipart style</a><br> 3.6 <a href="#_http_serialization">Serialization format of instance data</a><br> 3.6.1 <a href="#_http_x-www-form-urlencoded">Serialization as application/x-www-form-urlencoded --- 83,91 ---- <hr><div class="toc"> <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#soap-binding">WSDL SOAP Binding</a><br>3. <a href="#http-binding">WSDL HTTP Binding</a><br>4. <a href="#References">References</a><br>A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>B. <a href="#changelog">Part 3 Change Log</a> (Non-Normative)<br></p></div><hr><div class="toc"> ! <h2><a name="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="#soap-binding">WSDL SOAP Binding</a><br> 2.1 <a href="#soap-defaults">Default Binding Rules</a><br> 2.2 <a href="#soap-binding-decl">Identifying a SOAP Binding</a><br> 2.3 <a href="#soap-protocol">Specifying the SOAP Protocol</a><br> 2.3.1 <a href="#soap-protocol-description">Description</a><br> 2.3.2 <a href="#soap-protocol-relate">Relationship to WSDL Component Model</a><br> 2.3.3 <a href="#soap-binding-decl-xml">XML Representation</a><br> 2.3.4 <a href="#soap-binding-decl-mapping">Mapping Between Component Properties and XML ! Representation</a><br> 2.4 <a href="#soap-default-mep-decl">Specifying the Default SOAP MEP</a><br> 2.4.1 <a href="#soap-default-mep-decl-description">Description</a><br> 2.4.2 <a href="#soap-default-mep-decl-relate">Relationship to WSDL Component Model</a><br> 2.4.3 <a href="#soap-default-mep-decl-xml">XML Representation</a><br> 2.5 <a href="#soap-module-decl">Declaring SOAP Modules</a><br> 2.5.1 <a href="#soap-module-decl-description">Description</a><br> 2.5.2 <a href="#soap-module-decl-relate">Relationship to WSDL Component Model</a><br> 2.5.3 <a href="#soap-module-decl-property">SOAP Module Component</a><br> & nbsp; 2.5.4 <a href="#soap-module-decl-xml">XML Representation</a><br> 2.5.5 <a href="#soap-module-decl-mapping">Mapping Between Component Properties and XML ! Representation</a><br> 2.6 <a href="#soap-fault-decl">Binding Faults</a><br> 2.6.1 <a href="#soap-fault-decl-description">Description</a><br> 2.6.2 <a href="#soap-fault-decl-relate">Relationship to WSDL Component Model</a><br> 2.6.3 <a href="#soap-fault-decl-xml">XML Representation</a><br> 2.6.4 <a href="#soap-fault-decl-mapping">Mapping Between Component Properties and XML ! Representation</a><br> 2.7 <a href="#soap-operation-decl">Binding Operations</a><br> 2.7.1 <a href="#soap-operation-decl-description">Description</a><br> 2.7.2 <a href="#soap-operation-decl-relate">Relationship to WSDL Component Model</a><br> 2.7.3 <a href="#soap-operation-decl-xml">XML Representation</a><br> 2.7.4 <a href="#soap-operation-decl-mapping">Mapping Between Component Properties and XML ! Representation</a><br> 2.8 <a href="#soap-syntax">XML Syntax Summary (Non-Normative)</a><br>3. <a href="#http-binding">WSDL HTTP Binding</a><br> 3.1 <a href="#http-syntax">HTTP Syntax Summary (Non-Normative)</a><br> 3.2 <a href="#http-binding-decl">Indicating an HTTP Binding</a><br> 3.2.1 <a href="#http-binding-decl-relate">Relationship to WSDL Component Model</a><br> 3.2.2 <a href="#http-binding-decl-property">HTTP Binding Component</a><br> 3.2.3 <a href="#http-binding-decl-xml">XML Representation of HTTP Binding Component</a><br> 3.2.4 <a href="#http-binding-decl-mapping">Mapping Between HTTP Binding's XML Representation to Component Properties</a><br> 3.3 <a href="#_http_binding_methodDefault">Default Binding Rules</a><br> 3.4 <a href="#http-operation-decl">Indicating an HTTP Operation</a><br> 3.4.1 <a href="#http-operation-decl-relate">Relationship to WSDL Component Model</a><br> 3.4.2 <a href="#http-operation-decl-property">HTTP Operation Component</a><br> 3.4.3 <a href="#http-operation-decl-xml">XML Representation of HTTP Operation Component</a><br> 3.4.4 <a href="#http-operation-decl-mapping">Mapping Between HTTP Operation's XML Representation to Component Properties</a><br> 3.5 <a href="#_operation_styles">Operation Styles</a><br> 3.5.1 <a href="#_operation_uri_style">URI Style</a><br> 3.5.2 <a href="#_operation_multipart_style">Multipart style</a><br> 3.6 <a href="#_http_serialization">Serialization format of instance data</a><br> 3.6.1 <a href="#_http_x-www-form-urlencoded">Serialization as application/x-www-form-urlencoded *************** *** 95,99 **** --- 95,101 ---- Properties</a><br>4. <a href="#References">References</a><br> 4.1 <a href="#Normative-References">Normative References</a><br> 4.2 <a href="#Informative-References">Informative References</a><br></p> <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>B. <a href="#changelog">Part 3 Change Log</a> (Non-Normative)<br> B.1 <a href="#wsdl-spec-changelog">WSDL Specification Changes</a><br> B.2 <a href="#xml-schema-changes">XML Schema Changes</a><br></p></div><hr><div class="body"> + + <div class="div1"> *************** *** 211,215 **** --- 213,219 ---- </div> </div> + + <div class="div1"> *************** *** 269,334 **** - <div class="div2"> - - <h3><a name="soap-syntax"></a>2.1 XML Syntax Summary (Non-Normative)</h3> - <div class="exampleInner"><pre> - <definitions > - <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" - <b>wsoap:protocol</b>="<em>xs:anyURI</em>" - <b>wsoap:mepDefault</b>="<em>xs:anyURI</em>"? > - <documentation />? - - <<b>wsoap:module</b> uri="<em>xs:anyURI</em>" required="<em>xs:boolean</em>"? > - <documentation />? - <property ... />? - </<b>wsoap:module</b>>* - - <feature ... />* - <property ... />* - - <fault ref="<em>xs:QName</em>" - <b>wsoap:code</b>="<em>xs:QName</em>" - <b>wsoap:subcodes</b>="<em>list of xs:QName</em>" > - <documentation />? - </fault>* - - <operation ref="<em>xs:QName</em>" - <b>wsoap:mep</b>="<em>xs:anyURI</em>"? - <b>wsoap:action</b>="<em>xs:anyURI</em>"? > - <documentation />? - - <<b>wsoap:module</b> ... />* - - <input messageLabel="<em>xs:NCName</em>"? > - <documentation />? - <<b>wsoap:module</b> ... />* - <feature ... />* - <property ... />* - </input>* - - <output messageLabel="<em>xs:NCName</em>"? > - <documentation />? - <<b>wsoap:module</b> ... />* - <feature ... />* - <property ... />* - </output>* - </operation>* - - </binding> - - <service> - <endpoint name="<em>xs:NCName</em>" binding="<em>xs:QName</em>" address="<em>xs:anyURI</em>"? > - <documentation />? - <endpoint> - </service> - </definitions> - </pre></div> - </div> - - <div class="div2"> ! <h3><a name="soap-defaults"></a>2.2 Default Binding Rules</h3> <ul> --- 273,280 ---- <div class="div2"> ! <h3><a name="soap-defaults"></a>2.1 Default Binding Rules</h3> <ul> *************** *** 410,414 **** <div class="div2"> ! <h3><a name="soap-binding-decl"></a>2.3 Identifying a SOAP Binding</h3> <p>A Binding component (defined in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]) --- 356,360 ---- <div class="div2"> ! <h3><a name="soap-binding-decl"></a>2.2 Identifying a SOAP Binding</h3> <p>A Binding component (defined in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]) *************** *** 422,430 **** <div class="div2"> ! <h3><a name="soap-protocol"></a>2.4 Specifying the SOAP Protocol</h3> <div class="div3"> ! <h4><a name="soap-protocol-description"></a>2.4.1 Description</h4> <p>Every SOAP binding MUST indicate what SOAP protocol is in --- 368,376 ---- <div class="div2"> ! <h3><a name="soap-protocol"></a>2.3 Specifying the SOAP Protocol</h3> <div class="div3"> ! <h4><a name="soap-protocol-description"></a>2.3.1 Description</h4> <p>Every SOAP binding MUST indicate what SOAP protocol is in *************** *** 446,450 **** <div class="div3"> ! <h4><a name="soap-protocol-relate"></a>2.4.2 Relationship to WSDL Component Model</h4> <p>The SOAP protocol specification adds the following --- 392,396 ---- <div class="div3"> ! <h4><a name="soap-protocol-relate"></a>2.3.2 Relationship to WSDL Component Model</h4> <p>The SOAP protocol specification adds the following *************** *** 461,465 **** <div class="div3"> ! <h4><a name="soap-binding-decl-xml"></a>2.4.3 XML Representation</h4> <div class="exampleInner"><pre><definitions > <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" --- 407,412 ---- <div class="div3"> ! <h4><a name="soap-binding-decl-xml"></a>2.3.3 XML Representation</h4> ! <div class="exampleInner"><pre><definitions > <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" *************** *** 470,474 **** </pre></div> <p>The XML representation for specifying the SOAP protocol ! is an <em>attribute information item</em> with the following Infoset properties: </p> <ul> <li> --- 417,422 ---- </pre></div> <p>The XML representation for specifying the SOAP protocol ! is a REQUIRED <em>attribute information item</em> with the following Infoset properties: </p> ! <ul> <li> *************** *** 486,491 **** <div class="div3"> ! <h4><a name="soap-binding-decl-mapping"></a>2.4.4 Mapping Between Binding Component Extension Properties ! and XML Representation</h4> <a name="tab_SOAP_Binding_Mapping"></a><br><table border="1"> --- 434,441 ---- <div class="div3"> ! <h4><a name="soap-binding-decl-mapping"></a>2.3.4 Mapping Between Component Properties and XML ! Representation</h4> ! ! <p>See <a href="#tab_SOAP_Binding_Mapping">Table 2-1</a>.</p> <a name="tab_SOAP_Binding_Mapping"></a><br><table border="1"> *************** *** 511,519 **** <div class="div2"> ! <h3><a name="soap-default-mep-decl"></a>2.5 Specifying the Default SOAP MEP</h3> <div class="div3"> ! <h4><a name="soap-default-mep-decl-description"></a>2.5.1 Description</h4> <p>Every Binding Operation component of a SOAP binding MUST --- 461,469 ---- <div class="div2"> ! <h3><a name="soap-default-mep-decl"></a>2.4 Specifying the Default SOAP MEP</h3> <div class="div3"> ! <h4><a name="soap-default-mep-decl-description"></a>2.4.1 Description</h4> <p>Every Binding Operation component of a SOAP binding MUST *************** *** 528,532 **** <div class="div3"> ! <h4><a name="soap-default-mep-decl-relate"></a>2.5.2 Relationship to WSDL Component Model</h4> <p>The default SOAP MEP specification is a syntactic --- 478,482 ---- <div class="div3"> ! <h4><a name="soap-default-mep-decl-relate"></a>2.4.2 Relationship to WSDL Component Model</h4> <p>The default SOAP MEP specification is a syntactic *************** *** 537,541 **** <div class="div3"> ! <h4><a name="soap-default-mep-decl-xml"></a>2.5.3 XML Representation</h4> <div class="exampleInner"><pre><definitions > <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" --- 487,492 ---- <div class="div3"> ! <h4><a name="soap-default-mep-decl-xml"></a>2.4.3 XML Representation</h4> ! <div class="exampleInner"><pre><definitions > <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" *************** *** 546,551 **** </definitions> </pre></div> ! <p>The XML representation for specifying the default SOAP MEP ! is an <em>attribute information item</em> with the following Infoset properties: </p> <ul> <li> --- 497,505 ---- </definitions> </pre></div> ! ! <p>The XML representation for specifying the default SOAP ! MEP is an OPTIONAL <em>attribute information item</em> with the following Infoset ! properties: </p> ! <ul> <li> *************** *** 567,575 **** <div class="div2"> ! <h3><a name="soap-module-decl"></a>2.6 Declaring SOAP Modules</h3> <div class="div3"> ! <h4><a name="soap-module-decl-description"></a>2.6.1 Description</h4> <p>In SOAP, it is permissible for specification interaction --- 521,529 ---- <div class="div2"> ! <h3><a name="soap-module-decl"></a>2.5 Declaring SOAP Modules</h3> <div class="div3"> ! <h4><a name="soap-module-decl-description"></a>2.5.1 Description</h4> <p>In SOAP, it is permissible for specification interaction *************** *** 584,588 **** <div class="div3"> ! <h4><a name="soap-module-decl-relate"></a>2.6.2 Relationship to WSDL Component Model</h4> <p>The SOAP Module component adds the following --- 538,542 ---- <div class="div3"> ! <h4><a name="soap-module-decl-relate"></a>2.5.2 Relationship to WSDL Component Model</h4> <p>The SOAP Module component adds the following *************** *** 609,613 **** <div class="div3"> ! <h4><a name="soap-module-decl-property"></a>2.6.3 SOAP Module Component</h4> <p>The SOAP Module component identifies a SOAP module that --- 563,567 ---- <div class="div3"> ! <h4><a name="soap-module-decl-property"></a>2.5.3 SOAP Module Component</h4> <p>The SOAP Module component identifies a SOAP module that *************** *** 627,648 **** <div class="div3"> ! <h4><a name="soap-module-decl-xml"></a>2.6.4 XML Representation</h4> <div class="exampleInner"><pre><definitions > ! <binding > ! <<b>wsoap:module</b> uri="uri" ! required="boolean"? > ! <property ... />? ! </<b>wsoap:module</b>> ! <operation> ! <<b>wsoap:module</b> ... />* ! <input> ! <<b>wsoap:module</b> ... />* ! </input> ! <output> ! <<b>wsoap:module</b> ... />* ! </output> ! </operation> ! </binding> </definitions> </pre></div> --- 581,602 ---- <div class="div3"> ! <h4><a name="soap-module-decl-xml"></a>2.5.4 XML Representation</h4> <div class="exampleInner"><pre><definitions > ! <binding > ! <<b>wsoap:module</b> uri="uri" ! required="boolean"? > ! <property ... />? ! </<b>wsoap:module</b>> ! <operation> ! <<b>wsoap:module</b> ... />* ! <input> ! <<b>wsoap:module</b> ... />* ! </input> ! <output> ! <<b>wsoap:module</b> ... />* ! </output> ! </operation> ! </binding> </definitions> </pre></div> *************** *** 718,727 **** <div class="div3"> ! <h4><a name="soap-module-decl-mapping"></a>2.6.5 Mapping Between SOAP Module's XML Representation to Component ! Properties</h4> ! <p>The mapping between the properties of the SOAP Module component ! and the XML representation of the <code>wsoap:module</code> ! <em>element information item</em> is as ! described in <a href="#tab_SOAP_Module_Mapping">Table 2-2</a>.</p> <a name="tab_SOAP_Module_Mapping"></a><br><table border="1"> <caption>Table 2-2. Mapping between SOAP Module Component Properties and XML --- 672,680 ---- <div class="div3"> ! <h4><a name="soap-module-decl-mapping"></a>2.5.5 Mapping Between Component Properties and XML ! Representation</h4> ! ! <p>See <a href="#tab_SOAP_Module_Mapping">Table 2-2</a>.</p> ! <a name="tab_SOAP_Module_Mapping"></a><br><table border="1"> <caption>Table 2-2. Mapping between SOAP Module Component Properties and XML *************** *** 751,868 **** <div class="div2"> ! <h3><a name="soap-fault-decl"></a>2.7 Indicating a SOAP Fault</h3> <div class="div3"> ! <h4><a name="soap-fault-decl-relate"></a>2.7.1 Relationship to WSDL Component Model</h4> ! <p>The SOAP Fault component adds a new property named {soap fault} ! to the Fault component (defined in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]).</p> </div> <div class="div3"> ! <h4><a name="soap-fault-decl-property"></a>2.7.2 SOAP Fault Component</h4> ! <p>A given Fault component is declared to be a SOAP fault by the ! presence of the SOAP Fault component.</p> ! <p>The properties of the SOAP Fault component are as follows:</p> <ul> ! <li> ! <p>{fault code} A QName as defined by [<cite><a href="#XML10">XML 1.0</a></cite>]. ! The value of this property identifies a possible SOAP fault ! (see [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for the operation in scope.</p> ! </li> ! <li> ! <p>{fault subcodes} A list of QName's, space separated. ! The value of this property identifies one or more subcodes ! for this SOAP fault.</p> </li> </ul> </div> <div class="div3"> ! <h4><a name="soap-fault-decl-xml"></a>2.7.3 XML Representation of SOAP Fault Component</h4> ! <div class="exampleInner"><pre><fault ref="xs:QName" ! <b>wsoap:code</b>="xs:QName" ! <b>wsoap:subcodes</b>="list of xs:QName" /> ! </fault>* </pre></div> ! <p>The XML representation for a SOAP Fault component is an <em>element information item</em> ! with the following Infoset properties: </p> <ul> ! <li> ! <p>A [local name] of <code>fault</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p> ! </li> ! <li> ! <p>One or more <em>attribute information item</em>s amongst its [attributes] as follows:</p> <ul> ! <li> ! <p>A REQUIRED <code>code</code> ! <em>attribute information item</em> with the following ! Infoset properties:</p> ! <ul> ! <li> ! <p>A [local name] of <code>code</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p> ! </li> ! </ul> ! </li> ! <li> ! <p>An OPTIONAL <code>subcodes</code> ! <em>attribute information item</em> with the ! following Infoset properties:</p> ! <ul> ! <li> ! <p>A [local name] of <code>subcodes</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p> ! </li> ! </ul> ! </li> ! <li> ! <p>Zero or more namespace qualified <em>attribute information item</em>s. The [namespace ! name] of such <em>attribute information item</em>s MUST NOT be "http://www.w3.org/@@@@/@@/wsdl" and ! MUST NOT be "http://www.w3.org/@@@@/@@/wsdl/soap12". </p> ! </li> </ul> </li> ! <li> ! <p>Zero or more <em>element information item</em> amongst its [children], in order, as ! follows:</p> ! <ol> ! <li> ! <p>An OPTIONAL <code>documentation</code> ! <em>element information item</em>.</p> ! </li> ! <li> ! <p>Zero or more namespace-qualified <em>element information item</em>s amongst its ! [children]. The [namespace name] of such <em>element information item</em>s MUST NOT be ! "http://www.w3.org/@@@@/@@/wsdl" and MUST NOT be ! "http://www.w3.org/@@@@/@@/wsdl/soap12".</p> ! </li> ! </ol> </li> </ul> </div> <div class="div3"> ! <h4><a name="soap-fault-decl-mapping"></a>2.7.4 Mapping Between SOAP Fault's XML Representation to Component ! Properties</h4> ! <p>The mapping between the properties of the SOAP Fault component ! and the XML representation of the <code>wsoap:fault</code> ! <em>element information item</em> is as ! described in <a href="#tab_SOAP_Fault_Mapping">Table 2-3</a>.</p> <a name="tab_SOAP_Fault_Mapping"></a><br><table border="1"> <caption>Table 2-3. Mapping between SOAP Fault Component Properties and XML --- 704,786 ---- <div class="div2"> ! <h3><a name="soap-fault-decl"></a>2.6 Binding Faults</h3> ! <div class="div3"> ! <h4><a name="soap-fault-decl-description"></a>2.6.1 Description</h4> ! ! <p>For every Interface Fault component contained in an ! Interface component, a mapping to a SOAP Fault must be ! described. This binding specification allows the user to ! indicate the SOAP fault code and subcodes that are ! transmitted for a given Interface Fault component.</p> </div> + <div class="div3"> ! <h4><a name="soap-fault-decl-relate"></a>2.6.2 Relationship to WSDL Component Model</h4> ! ! <p>The SOAP Fault binding adds the following ! properties to the WSDL component model (as defined in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]):</p> ! <ul> ! <li><p>{soap fault code}, a QName as defined by [<cite><a href="#XML10">XML 1.0</a></cite>], to the Binding Fault component. The value ! of this property identifies a possible SOAP fault (see ! [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for the operation in ! scope.</p> </li> ! ! <li><p>{soap fault subcodes}, a list of QNames, to the ! Binding Fault component. The value of this property ! identifies one or more subcodes for this SOAP fault.</p> </li> </ul> </div> + <div class="div3"> ! <h4><a name="soap-fault-decl-xml"></a>2.6.3 XML Representation</h4> ! ! <div class="exampleInner"><pre><definitions > ! <binding > ! <fault ref="xs:QName" ! <b>wsoap:code</b>="xs:QName" ! <b>wsoap:subcodes</b>="list of xs:QName"? /> ! </fault>* ! </binding> ! </definitions> </pre></div> ! ! <p>The XML representation for binding a SOAP Fault are two ! <em>attribute information item</em>s with the following Infoset properties: </p> ! <ul> ! <li><p>wsoap:code REQUIRED <em>attribute information item</em></p> <ul> ! <li><p>A [local name] of <code>code</code> </p></li> ! ! <li> <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p></li> </ul> </li> ! <li><p>wsoap:subcodes OPTIONAL <em>attribute information item</em></p> ! <ul> ! <li><p>A [local name] of <code>subcodes</code> </p></li> ! ! <li> <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p></li> ! </ul> </li> </ul> </div> + <div class="div3"> ! <h4><a name="soap-fault-decl-mapping"></a>2.6.4 Mapping Between Component Properties and XML ! Representation</h4> ! ! <p>See <a href="#tab_SOAP_Fault_Mapping">Table 2-3</a>.</p> ! <a name="tab_SOAP_Fault_Mapping"></a><br><table border="1"> <caption>Table 2-3. Mapping between SOAP Fault Component Properties and XML *************** *** 887,1034 **** </div> </div> <div class="div2"> ! <h3><a name="soap-operation-decl"></a>2.8 Indicating a SOAP Operation</h3> <div class="div3"> ! <h4><a name="soap-operation-decl-relate"></a>2.8.1 Relationship to WSDL Component Model</h4> ! <p>The SOAP Operation component adds a new property named {soap operation} ! to the Operation component (defined in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]).</p> </div> <div class="div3"> ! <h4><a name="soap-operation-decl-property"></a>2.8.2 SOAP Operation Component</h4> ! <p>A given Operation component is declared to be a SOAP message exchange ! by the presence of the SOAP Operation component.</p> ! <p>The properties of the SOAP Operation component are as follows:</p> <ul> ! <li> ! <p>{message exchange pattern} An absolute URI as ! defined by [<cite><a href="#RFC2396">IETF RFC 2396</a></cite>]. The value of this property ! identifies, if present, the SOAP Message Exchange Pattern (MEP) (as ! defined by [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for this specific operation. ! Otherwise, the {default message exchange pattern} of the SOAP Binding ! component applies. One or the other MUST be present.</p> ! <p>The SOAP MEP identified by {message exchange pattern} ! MUST be compatible with the {pattern} of the Interface ! Operation component (see [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]).</p> ! </li> ! <li> ! <p>{Web method} A string value indicating, if present, the ! value for the SOAP Web Method Feature (as defined by [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for this specific operation. Otherwise, ! the {default Web method} of the SOAP Binding component applies. ! One or the other MUST be present</p> ! </li> ! <li> ! <p>{action} An absolute URI as defined by [<cite><a href="#RFC2396">IETF RFC 2396</a></cite>]. The value of this property identifies the value ! of the SOAP Action Features (as defined by [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for this specific operation.</p> </li> </ul> </div> <div class="div3"> ! <h4><a name="soap-operation-decl-xml"></a>2.8.3 XML Representation of SOAP Operation Component</h4> ! <div class="exampleInner"><pre><definitions> ! <binding> ! <operation> ! <<b>wsoap:operation</b> action="xs:anyURI" /> ? ! </operation> ! </binding> </definitions> </pre></div> ! <p>The XML representation for a SOAP Operation component is an <em>element information item</em> ! with the following Infoset properties: </p> <ul> ! <li> ! <p>A [local name] of <code>operation</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p> ! </li> ! <li> ! <p>One or more <em>attribute information item</em>s amongst its [attributes] as follows:</p> <ul> ! <li> ! <p>A REQUIRED <code>mep</code> ! <em>attribute information item</em> with the following ! Infoset properties:</p> ! <ul> ! <li> ! <p>A [local name] of <code>mep</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] which has no value</p> ! </li> ! </ul> ! </li> ! <li> ! <p>An OPTIONAL <code>webMethod</code> ! <em>attribute information item</em> with the ! following Infoset properties:</p> ! <ul> ! <li> ! <p>A [local name] of <code>webMethod</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] which has no value</p> ! </li> ! </ul> ! </li> ! <li> ! <p>An OPTIONAL <code>action</code> ! <em>attribute information item</em> with the ! following Infoset properties:</p> ! <ul> ! <li> ! <p>A [local name] of <code>action</code> ! </p> ! </li> ! <li> ! <p>A [namespace name] which has no value</p> ! </li> ! </ul> ! </li> ! <li> ! <p>Zero or more namespace qualified <em>attribute information item</em>s. The [namespace ! name] of such <em>attribute information item</em>s MUST NOT be "http://www.w3.org/@@@@/@@/wsdl" and ! MUST NOT be "http://www.w3.org/@@@@/@@/wsdl/soap12". </p> ! </li> </ul> </li> ! <li> ! <p>Zero or more <em>element information item</em> amongst its [children], in order, as ! follows:</p> ! <ol> ! <li> ! <p>An OPTIONAL <code>documentation</code> ! <em>element information item</em>.</p> ! </li> ! <li> ! <p>Zero or more namespace-qualified <em>element information item</em>s amongst its ! [children]. The [namespace name] of such <em>element information item</em>s MUST NOT be ! "http://www.w3.org/@@@@/@@/wsdl" and MUST NOT be ! "http://www.w3.org/@@@@/@@/wsdl/soap12".</p> ! </li> ! </ol> </li> </ul> </div> <div class="div3"> ! <h4><a name="soap-operation-decl-mapping"></a>2.8.4 Mapping Between SOAP Operation's XML Representation to Component ! Properties</h4> ! <p>The mapping between the properties of the SOAP Operation component ! and the XML representation of the <code>wsoap:operation</code> ! <em>element information item</em> is as ! described in <a href="#tab_SOAP_Operation_Mapping">Table 2-4</a>.</p> <a name="tab_SOAP_Operation_Mapping"></a><br><table border="1"> ! <caption>Table 2-4. Mapping between SOAP Operation Component Properties and XML ! Representation</caption> <tbody> <tr> --- 805,902 ---- </div> </div> + + <div class="div2"> ! <h3><a name="soap-operation-decl"></a>2.7 Binding Operations</h3> ! <div class="div3"> ! <h4><a name="soap-operation-decl-description"></a>2.7.1 Description</h4> ! ! <p>For every Interface Operation component contained in an ! Interface component, in addition to the default binding ! rules described in <a href="#soap-defaults"><b>2.1 Default Binding Rules</b></a>, there may ! be additional binding information to be specified. This ! binding specification allows the user to indicate the SOAP ! Message Exchange Pattern (MEP) and a value for the SOAP ! Action Feature (see [<cite><a href="#SOAP12-PART2">SOAP 1.2 Part 2: Adjuncts</a></cite>]) on a ! per-operation basis.</p> </div> + <div class="div3"> ! <h4><a name="soap-operation-decl-relate"></a>2.7.2 Relationship to WSDL Component Model</h4> ! ! <p>The SOAP Operation binding specification adds the ! following property to the WSDL component model (as defined ! in [<cite><a href="#WSDL-PART1">WSDL 2.0 Core Language</a></cite>]):</p> ! <ul> ! <li><p>{soap mep}, an absolute URI as defined by [<cite><a href="#RFC2396">IETF RFC 2396</a></cite>], to the Binding Operation component. The ! value of this property identifies the SOAP Message ! Exchange Pattern (MEP) (as defined by [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for this specific operation. If no ! specific value is assigned, then the value assigned by the ! default rules apply (see <a href="#soap-defaults"><b>2.1 Default Binding Rules</b></a>). It is an error for this property ! to not have a value (which MAY happen if the default rules ! are not applicable).</p></li> ! ! <li><p>{soap action}, an absolute URI as defined by [<cite><a href="#RFC2396">IETF RFC 2396</a></cite>], to the Binding Operation component. The ! value of this property identifies the value of the SOAP ! Action Feature (as defined by [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]) for this specific operation.</p> </li> </ul> </div> + <div class="div3"> ! <h4><a name="soap-operation-decl-xml"></a>2.7.3 XML Representation</h4> ! ! <div class="exampleInner"><pre><definitions > ! <binding > ! <operation ref="<em>xs:QName</em>" ! <b>wsoap:mep</b>="<em>xs:anyURI</em>"? ! <b>wsoap:action</b>="<em>xs:anyURI</em>"? > ! </operation> ! </binding> </definitions> </pre></div> ! ! <p>The XML representation for binding an Operation are two ! <em>attribute information item</em>s with the following Infoset properties: </p> ! <ul> ! <li><p>wsoap:mep OPTIONAL <em>attribute information item</em></p> <ul> ! <li><p>A [local name] of <code>mep</code> </p></li> ! ! <li> <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p></li> </ul> </li> ! <li><p>wsoap:action OPTIONAL <em>attribute information item</em></p> ! <ul> ! <li><p>A [local name] of <code>action</code> </p></li> ! ! <li> <p>A [namespace name] of ! "http://www.w3.org/@@@@/@@/wsdl/soap12" ! </p></li> ! </ul> </li> </ul> </div> + <div class="div3"> ! <h4><a name="soap-operation-decl-mapping"></a>2.7.4 Mapping Between Component Properties and XML ! Representation</h4> ! ! <p>See <a href="#tab_SOAP_Operation_Mapping">Table 2-4</a>.</p> ! <a name="tab_SOAP_Operation_Mapping"></a><br><table border="1"> ! <caption>Table 2-4. Mapping between SOAP Operation Component ! Properties and XML Representation</caption> <tbody> <tr> *************** *** 1037,1055 **** </tr> <tr> ! <td rowspan="1" colspan="1">{message exchange pattern}</td> ! <td rowspan="1" colspan="1">The actual value of the <code>mep</code> ! <em>attribute information item</em>.</td> ! </tr> ! <tr> ! <td rowspan="1" colspan="1">{Web method}</td> ! <td rowspan="1" colspan="1">The actual value of the <code>webMethod</code> ! <em>attribute information item</em>.</td> ! <td rowspan="1" colspan="1"> ! </td> </tr> <tr> ! <td rowspan="1" colspan="1">{action}</td> ! <td rowspan="1" colspan="1">The actual value of the <code>action</code> ! <em>attribute information item</em>.</td> </tr> </tbody> --- 905,920 ---- </tr> <tr> ! <td rowspan="1" colspan="1">{soap mep}</td> <td rowspan="1" colspan="1">The actual value of the ! <code>wsoap:mep</code> <em>attribute information item</em>, if present. If not, the ! actual value of the <code>wsoap:mepDefault</code> <em>attribute information item</em> ! of the parent wsdl:binding <em>element information item</em>, if present. If not ! the value as defined by the default SOAP binding rules ! (see <a href="#soap-defaults"><b>2.1 Default Binding Rules</b></a>), if ! applicable.</td> </tr> <tr> ! <td rowspan="1" colspan="1">{soap action}</td> ! <td rowspan="1" colspan="1">The actual value of the ! <code>action</code> <em>attribute information item</em>., if any.</td> </tr> </tbody> *************** *** 1057,1062 **** --- 922,990 ---- </div> </div> + + + + <div class="div2"> + + <h3><a name="soap-syntax"></a>2.8 XML Syntax Summary (Non-Normative)</h3> + + <div class="exampleInner"><pre> + <definitions > + <binding name="<em>xs:NCName</em>" interface="<em>xs:QName</em>"? type="<em>xs:anyURI</em>" + <b>wsoap:protocol</b>="<em>xs:anyURI</em>" + <b>wsoap:mepDefault</b>="<em>xs:anyURI</em>"? > + <documentation />? + + <<b>wsoap:module</b> uri="<em>xs:anyURI</em>" required="<em>xs:boolean</em>"? > + <documentation />? + <property ... />? + </<b>wsoap:module</b>>* + + <feature ... />* + <property ... />* + + <fault ref="<em>xs:QName</em>" + <b>wsoap:code</b>="<em>xs:QName</em>" + <b>wsoap:subcodes</b>="<em>list of xs:QName</em>"? > + <documentation />? + </fault>* + + <operation ref="<em>xs:QName</em>" + <b>wsoap:mep</b>="<em>xs:anyURI</em>"? + <b>wsoap:action</b>="<em>xs:anyURI</em>"? > + <documentation />? + + <<b>wsoap:module</b> ... />* + + <input messageLabel="<em>xs:NCName</em>"? > + <documentation />? + <<b>wsoap:module</b> ... />* + <feature ... />* + <property ... />* + </input>* + + <output messageLabel="<em>xs:NCName</em>"? > + <documentation />? + <<b>wsoap:module</b> ... />* + <feature ... />* + <property ... />* + </output>* + </operation>* + + </binding> + + <service> + <endpoint name="<em>xs:NCName</em>" binding="<em>xs:QName</em>" address="<em>xs:anyURI</em>"? > + <documentation />? + <endpoint> + </service> + </definitions> + </pre></div> + </div> + </div> + + <div class="div1"> *************** *** 1266,1269 **** --- 1194,1198 ---- <li> <p>An OPTIONAL <code>documentation</code> + <em>element information item</em>.</p> </li> *************** *** 2441,2444 **** --- 2370,2379 ---- <td rowspan="1" colspan="1">20040624</td> <td rowspan="1" colspan="1">SW</td> + <td rowspan="1" colspan="1">Update the rest of the SOAP binding stuff and consistified + everything.</td> + </tr> + <tr> + <td rowspan="1" colspan="1">20040624</td> + <td rowspan="1" colspan="1">SW</td> <td rowspan="1" colspan="1">Cleaned up how SOAP modules were described. Added default SOAP MEP stuff.</td>
Received on Wednesday, 23 June 2004 15:18:37 UTC