- From: Hugo Haas via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 02 Jun 2005 15:59:54 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory homer:/tmp/cvs-serv14196
Modified Files:
wsdl20-adjuncts.xml
Log Message:
LC75c
Index: wsdl20-adjuncts.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.xml,v
retrieving revision 1.52
retrieving revision 1.53
diff -C2 -d -r1.52 -r1.53
*** wsdl20-adjuncts.xml 27 May 2005 10:26:59 -0000 1.52
--- wsdl20-adjuncts.xml 2 Jun 2005 15:59:52 -0000 1.53
***************
*** 156,159 ****
--- 156,169 ----
</tr>
<tr>
+ <td rowspan="1" colspan="1">wsdl-x</td>
+ <td rowspan="1" colspan="1">
+ <attval>&wsdl-x-ns;</attval>
+ </td>
+ <td rowspan="1" colspan="1">A normative XML Schema <bibref ref="XMLSchemaP1"/>,
+ <bibref ref="XMLSchemaP2"/> document for the
+ <attval>&wsdl-x-ns;</attval>
+ namespace can be found at <loc href="&wsdl-x-ns;">&wsdl-x-ns;</loc>.</td>
+ </tr>
+ <tr>
<td rowspan="1" colspan="1">wsoap</td>
<td rowspan="1" colspan="1">
***************
*** 611,614 ****
--- 621,737 ----
<!-- *************************************************************** -->
+ <div1 id="ext">
+ <head>Predefined Extensions</head>
+
+ <div2 id='servref'>
+ <head>Service references</head>
+
+ <ednote>
+ <edtext>
+ Insert Umit's proposal as modified during F2F
+ </edtext>
+ </ednote>
+ </div2>
+
+ <div2 id='safety'>
+ <head>Operation safety</head>
+
+ <p>
+ This section defines an extension to WSDL 2.0 <bibref
+ ref="WSDL-PART1"/> which allows to mark an operation as a
+ safe interaction, as defined in <xspecref
+ href='http://www.w3.org/TR/2004/REC-webarch-20041215/#safe-interaction'>section
+ 3.4. Safe Interactions</xspecref> of <bibref
+ ref="webarch"/>.
+ </p>
+
+ <p>
+ This extension MAY be used for setting defaults in bindings,
+ such as in the HTTP binding defined in this document (see
+ <specref ref="http-operation-decl-mapping"/>).
+ </p>
+
+ <div3 id="safety-decl-relate">
+ <head>Relationship to WSDL Component Model</head>
+
+ <p>The safety extension adds the following property to the
+ Interface Operation component model (as defined in <bibref
+ ref="WSDL-PART1"/>):</p>
+
+ <ulist>
+ <item><p>{safety} REQUIRED. An <emph>xs:boolean</emph>
+ indicating whether the operation is asserted to be safe
+ for users of the described service to invoke. If this
+ property is false, then no assertion has been made about
+ the safety of the operation, thus the operation MAY or MAY
+ NOT be safe. However, an operation SHOULD be marked safe
+ if it meets the criteria for a safe interaction defined in
+ Section 3.5 of <bibref ref="webarch"/>.</p></item>
+ </ulist>
+ </div3>
+
+ <div3 id="safety-decl-xml">
+ <head>XML Representation</head>
+ <eg xml:space="preserve"><description>
+ <interface>
+ <operation name="<emph>xs:NCName</emph>" pattern="<emph>xs:anyURI</emph>"
+ <b>wsdlx:safe</b>="<emph>xs:boolean</emph>"? >
+ </operation>
+ </interface>
+ </description></eg>
+
+ <p>The XML representation for the safety extension is an
+ &AII; with the following Infoset properties: </p>
+ <ulist>
+ <item>
+ <p>An OPTIONAL <att>safe</att>
+ &AII; with the following
+ Infoset properties:</p>
+ <ulist>
+ <item>
+ <p>A [local name] of <att>safe</att>
+ </p>
+ </item>
+ <item>
+ <p>A [namespace name] of <attval>&wsdl-x-ns;</attval>
+ </p>
+ </item>
+ <item>
+ <p>A type of <emph>xs:boolean</emph></p>
+ </item>
+ </ulist>
+ </item>
+ </ulist>
+
+ </div3>
+
+ <div3 id="safety-decl-mapping">
+ <head>Mapping from XML Representation to Component Properties</head>
+ <p>See <specref ref="tab_safety_Mapping"/>.</p>
+
+ <table border="1" id="tab_safety_Mapping">
+ <caption>Mapping from XML Representation to Interface Operation Component Extension Properties</caption>
+ <tbody>
+ <tr>
+ <th rowspan="1" colspan="1">Property</th>
+ <th rowspan="1" colspan="1">Value</th>
+ </tr>
+ <tr>
+ <td>{safety}</td>
+ <td>
+ The actual value of the <att>safe</att> &AII;, if
+ present, otherwise the value <attval>false</attval>.
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div3>
+
+ </div2>
+
+ </div1>
+
+ <!-- *************************************************************** -->
+
<div1 id="styles">
<head>Predefined Operation Styles</head>
***************
*** 2507,2514 ****
<item><p><emph>HTTP Method Declaration.</emph>
When formulating the HTTP message to be transmitted, the
! HTTP request method MUST be what is defined by the
! <att>whttp:method</att> attribute on <el>operation</el>, or with
! the <att>whttp:methodDefault</att> attribute on
! <el>binding</el>.</p>
</item>
--- 2630,2635 ----
<item><p><emph>HTTP Method Declaration.</emph>
When formulating the HTTP message to be transmitted, the
! HTTP request method MUST be the value of the
! {http method} property of the corresponding Binding Operation component.</p>
</item>
***************
*** 3094,3099 ****
<att>whttp:method</att> &AII;, if present; otherwise, the
actual value of the <att>whttp:methodDefault</att>
! &AII;, as defined in <specref ref="http-default-method-decl"/>;
! otherwise, it is an error.</td>
</tr>
<tr>
--- 3215,3224 ----
<att>whttp:method</att> &AII;, if present; otherwise, the
actual value of the <att>whttp:methodDefault</att>
! &AII;, as defined in <specref
! ref="http-default-method-decl"/>; otherwise, if a
! {safety} property as defined in <specref ref="safety"
! /> is present on the bound Interface Operation
! component and has a value of <attval>true</attval>,
! the value <attval>GET</attval>; otherwise, it is an error.</td>
</tr>
<tr>
***************
*** 4305,4308 ****
--- 4430,4445 ----
available at http://www.w3.org/TR/soap12-part2/.
</bibl>
+ <bibl id="webarch" key="Web Architecture"
+ href="http://www.w3.org/TR/2004/REC-webarch-20041215/">
+ <titleref>Architecture of the World Wide Web, Volume
+ One</titleref>, I. Jacobs, and N. Walsh, Editors. World
+ Wide Web Consortium, 15 December 2004. This version of
+ the "Architecture of the World Wide Web, Volume One"
+ Recommendation is
+ http://www.w3.org/TR/2004/REC-webarch-20041215/. The <loc
+ href="http://www.w3.org/TR/webarch/">latest version of
+ "Architecture of the World Wide Web, Volume One"</loc> is
+ available at http://www.w3.org/TR/webarch/.
+ </bibl>
<bibl id="XML10" key="XML 1.0" href="http://www.w3.org/TR/2004/REC-xml-20040204/">
<titleref>Extensible Markup Language (XML) 1.0 (Third
***************
*** 4421,4429 ****
<!-- template
<tr>
! <td>200505</td>
<td></td>
<td></td>
</tr>
-->
<tr>
<td>20050527</td>
--- 4558,4574 ----
<!-- template
<tr>
! <td>200506</td>
<td></td>
<td></td>
</tr>
-->
+ <tr>
+ <td>20050602</td>
+ <td>HH</td>
+ <td><loc
+ href="http://www.w3.org/2002/ws/desc/4/lc-issues/issues.html#LC75c">LC75c</loc>:
+ introduced wsdlx namespace, moved safety to Part 2.</td>
+ </tr>
+
<tr>
<td>20050527</td>
Received on Thursday, 2 June 2005 16:00:01 UTC