- From: Arthur Ryman via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 07 Dec 2006 16:30:09 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20 In directory hutz:/tmp/cvs-serv10264/wsdl20 Modified Files: wsdl20.tex wsdl20.toc wsdl20-z-ie.html wsdl20-z.html wsdl20.html wsdl20-adjuncts.html wsdl20-adjuncts.xml build.xml wsdl20-primer.html adjuncts-assertion-summary.xml Added Files: adjuncts-message-assertion-table.xml Log Message: Fixed CR094. Index: wsdl20-adjuncts.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.html,v retrieving revision 1.155 retrieving revision 1.156 diff -C 2 -d -r1.155 -r1.156 *** wsdl20-adjuncts.html 22 Nov 2006 15:59:45 -0000 1.155 --- wsdl20-adjuncts.html 7 Dec 2006 16:30:06 -0000 1.156 *************** *** 1,13 **** ! <!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 http-equiv="Content-Type" content= ! "text/html; charset=utf-8" /> ! <title>Web Services Description Language (WSDL) Version 2.0 Part 2: ! Adjuncts</title> ! ! <style type="text/css" xml:space="preserve"> [...18180 lines suppressed...] ! <td rowspan="1" colspan="1">Simplified the introduction; referred to Part1 for a longer introduction</td> ! </tr> ! <tr> ! <td rowspan="1" colspan="1">20020221</td> ! <td rowspan="1" colspan="1">JJM</td> ! <td rowspan="1" colspan="1">Renamed to "Part 2: Bindings"</td> ! </tr> ! <tr> ! <td rowspan="1" colspan="1">20020221</td> ! <td rowspan="1" colspan="1">JJM</td> ! <td rowspan="1" colspan="1">Created from http://www.w3.org/TR/2001/NOTE-wsdl-20010315</td> ! </tr> ! </tbody> ! </table><br> ! </div> ! </div> ! ! </div> ! </body></html> \ No newline at end of file Index: adjuncts-assertion-summary.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/adjuncts-assertion-summary.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -C 2 -d -r1.3 -r1.4 *** adjuncts-assertion-summary.xml 27 Mar 2006 18:03:49 -0000 1.3 --- adjuncts-assertion-summary.xml 7 Dec 2006 16:30:07 -0000 1.4 *************** *** 26,29 **** --- 26,38 ---- </table> + <table width="100%" id="message-assertion-summary" border="1"> + <caption> + Summary of Assertions about Messages + </caption> + <col width="20%" /> + <col width="80%" /> + &message-assertion-table; + </table> + <table width="100%" id="exchange-assertion-summary" border="1"> <caption> Index: build.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/build.xml,v retrieving revision 1.38 retrieving revision 1.39 diff -C 2 -d -r1.38 -r1.39 *** build.xml 11 Nov 2006 19:43:51 -0000 1.38 --- build.xml 7 Dec 2006 16:30:07 -0000 1.39 *************** *** 27,30 **** --- 27,33 ---- ChangeLog: + 2006-12-07: Arthur Ryman <ryman@ca.ibm.com> + - added adjuncts-message-assertion-table.xml entity generation + 2006-11-11: Arthur Ryman <ryman@ca.ibm.com> - added adjuncts-exchange-assertion-table.xml entity generation *************** *** 131,134 **** --- 134,138 ---- <delete file="adjuncts-document-assertion-table.xml" /> <delete file="adjuncts-exchange-assertion-table.xml" /> + <delete file="adjuncts-message-assertion-table.xml" /> <delete file="component-table.xml" /> <delete file="component-assertion-table.xml" /> *************** *** 152,155 **** --- 156,160 ---- <touch file="adjuncts-document-assertion-table.xml" /> <touch file="adjuncts-exchange-assertion-table.xml" /> + <touch file="adjuncts-message-assertion-table.xml" /> <touch file="component-table.xml" /> <touch file="component-assertion-table.xml" /> *************** *** 174,177 **** --- 179,185 ---- <param name="class" expression="exchange" /> </xslt> + <xslt in="wsdl20-adjuncts.xml" out="adjuncts-message-assertion-table.xml" style="assertion-table.xsl" force="yes"> + <param name="class" expression="message" /> + </xslt> <xslt in="wsdl20.xml" out="component-assertion-table.xml" style="assertion-table.xsl" force="yes"> <param name="class" expression="component" /> Index: wsdl20.toc =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.toc,v retrieving revision 1.31 retrieving revision 1.32 diff -C 2 -d -r1.31 -r1.32 *** wsdl20.toc 11 Nov 2006 19:43:48 -0000 1.31 --- wsdl20.toc 7 Dec 2006 16:30:02 -0000 1.32 *************** *** 1,171 **** ! \contentsline {chapter}{\numberline {1}Introduction}{3}{chapter.1} ! \contentsline {section}{\numberline {1.1}Web Service}{3}{section.1.1} ! \contentsline {section}{\numberline {1.2}Document Conformance}{4}{section.1.2} ! \contentsline {section}{\numberline {1.3}The Meaning of a Service Description}{4}{section.1.3} ! \contentsline {section}{\numberline {1.4}Notational Conventions}{4}{section.1.4} ! \contentsline {subsection}{\numberline {1.4.1}RFC 2119 Keywords}{5}{subsection.1.4.1} ! \contentsline {subsection}{\numberline {1.4.2}RFC 3986 Namespaces}{5}{subsection.1.4.2} ! \contentsline {subsection}{\numberline {1.4.3}XML Schema anyURI}{5}{subsection.1.4.3} ! \contentsline {subsection}{\numberline {1.4.4}Prefixes and Namespaces Used in This Specification}{5}{subsection.1.4.4} ! \contentsline {subsection}{\numberline {1.4.5}Terms Used in This Specification}{6}{subsection.1.4.5} ! \contentsline {subsection}{\numberline {1.4.6}XML Information Set Properties}{6}{subsection.1.4.6} ! \contentsline {subsection}{\numberline {1.4.7}WSDL 2.0 Component Model Properties}{6}{subsection.1.4.7} ! \contentsline {subsection}{\numberline {1.4.8}Z Notation}{7}{subsection.1.4.8} ! \contentsline {subsection}{\numberline {1.4.9}BNF Pseudo-Schemas}{7}{subsection.1.4.9} ! \contentsline {subsection}{\numberline {1.4.10}Assertions}{8}{subsection.1.4.10} ! \contentsline {chapter}{\numberline {2}Component Model}{9}{chapter.2} ! \contentsline {section}{\numberline {2.1}Description}{20}{section.2.1} ! \contentsline {subsection}{\numberline {2.1.1}The Description Component}{20}{subsection.2.1.1} ! \contentsline {subsection}{\numberline {2.1.2}XML Representation of Description Component}{28}{subsection.2.1.2} ! \contentsline {subsubsection}{\texttt {targetNamespace} \textit {attribute information item}}{30}{section*.3} ! \contentsline {subsection}{\numberline {2.1.3}Mapping Description's XML Representation to Component Properties}{30}{subsection.2.1.3} ! \contentsline {section}{\numberline {2.2}Interface}{32}{section.2.2} ! \contentsline {subsection}{\numberline {2.2.1}The Interface Component}{32}{subsection.2.2.1} ! \contentsline {subsection}{\numberline {2.2.2}XML Representation of Interface Component}{37}{subsection.2.2.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {interface} [owner element]}{38}{section*.4} ! \contentsline {subsubsection}{\texttt {extends} \textit {attribute information item}}{38}{section*.5} ! \contentsline {subsubsection}{\texttt {styleDefault} \textit {attribute information item}}{39}{section*.6} ! \contentsline {subsection}{\numberline {2.2.3}Mapping Interface's XML Representation to Component Properties}{39}{subsection.2.2.3} ! \contentsline {section}{\numberline {2.3}Interface Fault}{40}{section.2.3} ! \contentsline {subsection}{\numberline {2.3.1}The Interface Fault Component}{40}{subsection.2.3.1} ! \contentsline {subsection}{\numberline {2.3.2}XML Representation of Interface Fault Component}{43}{subsection.2.3.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {fault} [owner element]}{44}{section*.7} ! \contentsline {subsubsection}{\texttt {element} \textit {attribute information item} with \texttt {fault} [owner element]}{44}{section*.8} ! \contentsline {subsection}{\numberline {2.3.3}Mapping Interface Fault's XML Representation to Component Properties}{44}{subsection.2.3.3} ! \contentsline {section}{\numberline {2.4}Interface Operation}{45}{section.2.4} ! \contentsline {subsection}{\numberline {2.4.1}The Interface Operation Component}{45}{subsection.2.4.1} ! \contentsline {subsubsection}{Message Exchange Pattern}{49}{section*.9} ! \contentsline {subsubsection}{Operation Style}{50}{section*.10} ! \contentsline {subsection}{\numberline {2.4.2}XML Representation of Interface Operation Component}{51}{subsection.2.4.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {operation} [owner element]}{52}{section*.11} ! \contentsline {subsubsection}{\texttt {pattern} \textit {attribute information item} with \texttt {operation} [owner element]}{53}{section*.12} ! \contentsline {subsubsection}{\texttt {style} \textit {attribute information item} with \texttt {operation} [owner element]}{53}{section*.13} ! \contentsline {subsection}{\numberline {2.4.3}Mapping Interface Operation's XML Representation to Component Properties}{53}{subsection.2.4.3} ! \contentsline {section}{\numberline {2.5}Interface Message Reference}{54}{section.2.5} ! \contentsline {subsection}{\numberline {2.5.1}The Interface Message Reference Component}{54}{subsection.2.5.1} ! \contentsline {subsection}{\numberline {2.5.2}XML Representation of Interface Message Reference Component}{57}{subsection.2.5.2} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{58}{section*.14} ! \contentsline {subsubsection}{\texttt {element} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{58}{section*.15} ! \contentsline {subsection}{\numberline {2.5.3}Mapping Interface Message Reference's XML Representation to Component Properties}{58}{subsection.2.5.3} ! \contentsline {section}{\numberline {2.6}Interface Fault Reference}{59}{section.2.6} ! \contentsline {subsection}{\numberline {2.6.1}The Interface Fault Reference Component}{59}{subsection.2.6.1} ! \contentsline {subsection}{\numberline {2.6.2}XML Representation of Interface Fault Reference}{62}{subsection.2.6.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {infault}, or \texttt {outfault} [owner element]}{63}{section*.16} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {infault}, or \texttt {outfault} [owner element]}{64}{section*.17} ! \contentsline {subsection}{\numberline {2.6.3}Mapping Interface Fault Reference's XML Representation to Component Properties}{64}{subsection.2.6.3} ! \contentsline {section}{\numberline {2.7}Binding}{65}{section.2.7} ! \contentsline {subsection}{\numberline {2.7.1}The Binding Component}{65}{subsection.2.7.1} ! \contentsline {subsection}{\numberline {2.7.2}XML Representation of Binding Component}{69}{subsection.2.7.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {binding} [owner element]}{70}{section*.18} ! \contentsline {subsubsection}{\texttt {interface} \textit {attribute information item} with \texttt {binding} [owner element]}{70}{section*.19} ! \contentsline {subsubsection}{\texttt {type} \textit {attribute information item} with \texttt {binding} [owner element]}{70}{section*.20} ! \contentsline {subsubsection}{Binding extension elements}{70}{section*.21} ! \contentsline {subsection}{\numberline {2.7.3}Mapping Binding's XML Representation to Component Properties}{71}{subsection.2.7.3} ! \contentsline {section}{\numberline {2.8}Binding Fault}{72}{section.2.8} ! \contentsline {subsection}{\numberline {2.8.1}The Binding Fault Component}{72}{subsection.2.8.1} ! \contentsline {subsection}{\numberline {2.8.2}XML Representation of Binding Fault Component}{74}{subsection.2.8.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {fault} [owner element]}{75}{section*.22} ! \contentsline {subsubsection}{Binding Fault extension elements}{75}{section*.23} ! \contentsline {subsection}{\numberline {2.8.3}Mapping Binding Fault's XML Representation to Component Properties}{75}{subsection.2.8.3} ! \contentsline {section}{\numberline {2.9}Binding Operation}{76}{section.2.9} ! \contentsline {subsection}{\numberline {2.9.1}The Binding Operation Component}{76}{subsection.2.9.1} ! \contentsline {subsection}{\numberline {2.9.2}XML Representation of Binding Operation Component}{79}{subsection.2.9.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {operation} [owner element]}{80}{section*.24} ! \contentsline {subsubsection}{Binding Operation extension elements}{80}{section*.25} ! \contentsline {subsection}{\numberline {2.9.3}Mapping Binding Operation's XML Representation to Component Properties}{80}{subsection.2.9.3} ! \contentsline {section}{\numberline {2.10}Binding Message Reference}{81}{section.2.10} ! \contentsline {subsection}{\numberline {2.10.1}The Binding Message Reference Component}{81}{subsection.2.10.1} ! \contentsline {subsection}{\numberline {2.10.2}XML Representation of Binding Message Reference Component}{83}{subsection.2.10.2} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{84}{section*.26} ! \contentsline {subsubsection}{Binding Message Reference extension elements}{84}{section*.27} ! \contentsline {subsection}{\numberline {2.10.3}Mapping Binding Message Reference's XML Representation to Component Properties}{85}{subsection.2.10.3} ! \contentsline {section}{\numberline {2.11}Binding Fault Reference}{86}{section.2.11} ! \contentsline {subsection}{\numberline {2.11.1}The Binding Fault Reference Component}{86}{subsection.2.11.1} ! \contentsline {subsection}{\numberline {2.11.2}XML Representation of Binding Fault Reference Component}{88}{subsection.2.11.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {infault} or \texttt {outfault} [owner element]}{89}{section*.28} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {infault} or \texttt {outfault} [owner element]}{89}{section*.29} ! \contentsline {subsubsection}{Binding Fault Reference extension elements}{89}{section*.30} ! \contentsline {subsection}{\numberline {2.11.3}Mapping Binding Fault Reference's XML Representation to Component Properties}{89}{subsection.2.11.3} ! \contentsline {section}{\numberline {2.12}Service}{91}{section.2.12} ! \contentsline {subsection}{\numberline {2.12.1}The Service Component}{91}{subsection.2.12.1} ! \contentsline {subsection}{\numberline {2.12.2}XML Representation of Service Component}{92}{subsection.2.12.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {service} [owner element]}{93}{section*.31} ! \contentsline {subsubsection}{\texttt {interface} \textit {attribute information item} with \texttt {service} [owner element]}{94}{section*.32} ! \contentsline {subsection}{\numberline {2.12.3}Mapping Service's XML Representation to Component Properties}{94}{subsection.2.12.3} ! \contentsline {section}{\numberline {2.13}Endpoint}{94}{section.2.13} ! \contentsline {subsection}{\numberline {2.13.1}The Endpoint Component}{94}{subsection.2.13.1} ! \contentsline {subsection}{\numberline {2.13.2}XML Representation of Endpoint Component}{96}{subsection.2.13.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {endpoint} [owner element]}{97}{section*.33} ! \contentsline {subsubsection}{\texttt {binding} \textit {attribute information item} with \texttt {endpoint} [owner element]}{98}{section*.34} ! \contentsline {subsubsection}{\texttt {address} \textit {attribute information item} with \texttt {endpoint} [owner element]}{98}{section*.35} ! \contentsline {subsubsection}{Endpoint extension elements}{98}{section*.36} ! \contentsline {subsection}{\numberline {2.13.3}Mapping Endpoint's XML Representation to Component Properties}{98}{subsection.2.13.3} ! \contentsline {section}{\numberline {2.14}XML Schema 1.0 Simple Types Used in the Component Model}{99}{section.2.14} ! \contentsline {section}{\numberline {2.15}Equivalence of Components}{100}{section.2.15} ! \contentsline {section}{\numberline {2.16}Symbol Spaces}{100}{section.2.16} ! \contentsline {section}{\numberline {2.17}QName resolution}{101}{section.2.17} ! \contentsline {section}{\numberline {2.18}Comparing URIs and IRIs}{101}{section.2.18} ! \contentsline {chapter}{\numberline {3}Types}{102}{chapter.3} ! \contentsline {section}{\numberline {3.1}Using W3C XML Schema Description Language}{103}{section.3.1} ! \contentsline {subsection}{\numberline {3.1.1}Importing XML Schema}{104}{subsection.3.1.1} ! \contentsline {subsubsection}{\texttt {namespace} \textit {attribute information item}}{105}{section*.37} ! \contentsline {subsubsection}{ \texttt {schemaLocation} \textit {attribute information item} }{105}{section*.38} ! \contentsline {subsection}{\numberline {3.1.2}Inlining XML Schema}{106}{subsection.3.1.2} ! \contentsline {subsection}{\numberline {3.1.3}References to Element Declarations and Type Definitions}{107}{subsection.3.1.3} ! \contentsline {section}{\numberline {3.2}Using Other Schema Languages}{107}{section.3.2} ! \contentsline {section}{\numberline {3.3}Describing Messages that Refer to Services and Endpoints}{108}{section.3.3} ! \contentsline {subsection}{\numberline {3.3.1} \texttt {wsdlx:interface} \textit {attribute information item} }{108}{subsection.3.3.1} ! \contentsline {subsection}{\numberline {3.3.2} \texttt {wsdlx:binding} \textit {attribute information item} }{108}{subsection.3.3.2} ! \contentsline {subsection}{\numberline {3.3.3}\texttt {wsdlx:interface} and \texttt {wsdlx:binding} Consistency}{109}{subsection.3.3.3} ! \contentsline {subsection}{\numberline {3.3.4}Use of \texttt {wsdlx:interface} and \texttt {wsdlx:binding} with \texttt {xs:anyURI}}{109}{subsection.3.3.4} ! \contentsline {chapter}{\numberline {4}Modularizing WSDL 2.0 descriptions}{110}{chapter.4} ! \contentsline {section}{\numberline {4.1}Including Descriptions}{110}{section.4.1} ! \contentsline {subsection}{\numberline {4.1.1}\texttt {location} \textit {attribute information item} with \texttt {include} [owner element]}{111}{subsection.4.1.1} ! \contentsline {section}{\numberline {4.2}Importing Descriptions}{112}{section.4.2} ! \contentsline {subsection}{\numberline {4.2.1}\texttt {namespace} \textit {attribute information item}}{113}{subsection.4.2.1} ! \contentsline {subsection}{\numberline {4.2.2}\texttt {location} \textit {attribute information item} with \texttt {import} [owner element]}{114}{subsection.4.2.2} ! \contentsline {section}{\numberline {4.3}Extensions}{114}{section.4.3} ! \contentsline {chapter}{\numberline {5}Documentation}{116}{chapter.5} ! \contentsline {chapter}{\numberline {6}Language Extensibility}{117}{chapter.6} ! \contentsline {section}{\numberline {6.1}Element based Extensibility}{117}{section.6.1} ! \contentsline {subsection}{\numberline {6.1.1}Mandatory extensions}{118}{subsection.6.1.1} ! \contentsline {subsection}{\numberline {6.1.2}\texttt {required} \textit {attribute information item}}{119}{subsection.6.1.2} ! \contentsline {section}{\numberline {6.2}Attribute-based Extensibility}{119}{section.6.2} ! \contentsline {section}{\numberline {6.3}Extensibility Semantics}{119}{section.6.3} ! \contentsline {chapter}{\numberline {7}Locating WSDL 2.0 Documents}{121}{chapter.7} ! \contentsline {section}{\numberline {7.1}\texttt {wsdli:wsdlLocation} \textit {attribute information item}}{121}{section.7.1} ! \contentsline {chapter}{\numberline {8}Conformance}{123}{chapter.8} ! \contentsline {section}{\numberline {8.1}XML Information Set Conformance}{123}{section.8.1} ! \contentsline {chapter}{\numberline {9}XML Syntax Summary (Non-Normative)}{124}{chapter.9} ! \contentsline {chapter}{\numberline {10}References}{128}{chapter.10} ! \contentsline {section}{\numberline {10.1}Normative References}{128}{section.10.1} ! \contentsline {section}{\numberline {10.2}Informative References}{129}{section.10.2} ! \contentsline {chapter}{\numberline {A}The application/wsdl+xml Media Type}{132}{appendix.A} ! \contentsline {section}{\numberline {A.1}Registration}{132}{section.A.1} ! \contentsline {section}{\numberline {A.2}Fragment Identifiers}{133}{section.A.2} ! \contentsline {subsection}{\numberline {A.2.1}The Description Component}{138}{subsection.A.2.1} ! \contentsline {subsection}{\numberline {A.2.2}The Element Declaration Component}{138}{subsection.A.2.2} ! \contentsline {subsection}{\numberline {A.2.3}The Type Definition Component}{139}{subsection.A.2.3} ! \contentsline {subsection}{\numberline {A.2.4}The Interface Component}{140}{subsection.A.2.4} ! \contentsline {subsection}{\numberline {A.2.5}The Interface Fault Component}{141}{subsection.A.2.5} ! \contentsline {subsection}{\numberline {A.2.6}The Interface Operation Component}{142}{subsection.A.2.6} ! \contentsline {subsection}{\numberline {A.2.7}The Interface Message Reference Component}{143}{subsection.A.2.7} ! \contentsline {subsection}{\numberline {A.2.8}The Interface Fault Reference Component}{144}{subsection.A.2.8} ! \contentsline {subsection}{\numberline {A.2.9}The Binding Component}{146}{subsection.A.2.9} ! \contentsline {subsection}{\numberline {A.2.10}The Binding Fault Component}{147}{subsection.A.2.10} ! \contentsline {subsection}{\numberline {A.2.11}The Binding Operation Component}{148}{subsection.A.2.11} ! \contentsline {subsection}{\numberline {A.2.12}The Binding Message Reference Component}{149}{subsection.A.2.12} ! \contentsline {subsection}{\numberline {A.2.13}The Binding Fault Reference Component}{150}{subsection.A.2.13} ! \contentsline {subsection}{\numberline {A.2.14}The Service Component}{152}{subsection.A.2.14} ! \contentsline {subsection}{\numberline {A.2.15}The Endpoint Component}{153}{subsection.A.2.15} ! \contentsline {subsection}{\numberline {A.2.16}Extension Components}{153}{subsection.A.2.16} ! \contentsline {section}{\numberline {A.3}Security considerations}{154}{section.A.3} ! \contentsline {chapter}{\numberline {B}Acknowledgements (Non-Normative)}{155}{appendix.B} ! \contentsline {chapter}{\numberline {C}IRI-References for WSDL 2.0 Components (Non-Normative)}{157}{appendix.C} ! \contentsline {section}{\numberline {C.1}WSDL 2.0 IRIs}{157}{section.C.1} ! \contentsline {section}{\numberline {C.2}Canonical Form for WSDL 2.0 Component Designators}{158}{section.C.2} ! \contentsline {section}{\numberline {C.3}Example}{158}{section.C.3} ! \contentsline {chapter}{\numberline {D}Component Summary (Non-Normative)}{161}{appendix.D} ! \contentsline {chapter}{\numberline {E}Assertion Summary (Non-Normative)}{165}{appendix.E} ! \contentsline {chapter}{\numberline {F}Part 1 Change Log (Non-Normative)}{174}{appendix.F} ! \contentsline {section}{\numberline {F.1}WSDL 2.0 Specification Changes}{174}{section.F.1} --- 1,171 ---- ! \contentsline {chapter}{\numberline {1}Introduction}{6}{chapter.1} ! \contentsline {section}{\numberline {1.1}Web Service}{6}{section.1.1} ! \contentsline {section}{\numberline {1.2}Document Conformance}{7}{section.1.2} ! \contentsline {section}{\numberline {1.3}The Meaning of a Service Description}{7}{section.1.3} ! \contentsline {section}{\numberline {1.4}Notational Conventions}{7}{section.1.4} ! \contentsline {subsection}{\numberline {1.4.1}RFC 2119 Keywords}{8}{subsection.1.4.1} ! \contentsline {subsection}{\numberline {1.4.2}RFC 3986 Namespaces}{8}{subsection.1.4.2} ! \contentsline {subsection}{\numberline {1.4.3}XML Schema anyURI}{8}{subsection.1.4.3} ! \contentsline {subsection}{\numberline {1.4.4}Prefixes and Namespaces Used in This Specification}{8}{subsection.1.4.4} ! \contentsline {subsection}{\numberline {1.4.5}Terms Used in This Specification}{9}{subsection.1.4.5} ! \contentsline {subsection}{\numberline {1.4.6}XML Information Set Properties}{9}{subsection.1.4.6} ! \contentsline {subsection}{\numberline {1.4.7}WSDL 2.0 Component Model Properties}{9}{subsection.1.4.7} ! \contentsline {subsection}{\numberline {1.4.8}Z Notation}{10}{subsection.1.4.8} ! \contentsline {subsection}{\numberline {1.4.9}BNF Pseudo-Schemas}{10}{subsection.1.4.9} ! \contentsline {subsection}{\numberline {1.4.10}Assertions}{11}{subsection.1.4.10} ! \contentsline {chapter}{\numberline {2}Component Model}{12}{chapter.2} ! \contentsline {section}{\numberline {2.1}Description}{23}{section.2.1} ! \contentsline {subsection}{\numberline {2.1.1}The Description Component}{23}{subsection.2.1.1} ! \contentsline {subsection}{\numberline {2.1.2}XML Representation of Description Component}{31}{subsection.2.1.2} ! \contentsline {subsubsection}{\texttt {targetNamespace} \textit {attribute information item}}{33}{section*.3} ! \contentsline {subsection}{\numberline {2.1.3}Mapping Description's XML Representation to Component Properties}{33}{subsection.2.1.3} ! \contentsline {section}{\numberline {2.2}Interface}{35}{section.2.2} ! \contentsline {subsection}{\numberline {2.2.1}The Interface Component}{35}{subsection.2.2.1} ! \contentsline {subsection}{\numberline {2.2.2}XML Representation of Interface Component}{40}{subsection.2.2.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {interface} [owner element]}{41}{section*.4} ! \contentsline {subsubsection}{\texttt {extends} \textit {attribute information item}}{41}{section*.5} ! \contentsline {subsubsection}{\texttt {styleDefault} \textit {attribute information item}}{42}{section*.6} ! \contentsline {subsection}{\numberline {2.2.3}Mapping Interface's XML Representation to Component Properties}{42}{subsection.2.2.3} ! \contentsline {section}{\numberline {2.3}Interface Fault}{43}{section.2.3} ! \contentsline {subsection}{\numberline {2.3.1}The Interface Fault Component}{43}{subsection.2.3.1} ! \contentsline {subsection}{\numberline {2.3.2}XML Representation of Interface Fault Component}{46}{subsection.2.3.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {fault} [owner element]}{47}{section*.7} ! \contentsline {subsubsection}{\texttt {element} \textit {attribute information item} with \texttt {fault} [owner element]}{47}{section*.8} ! \contentsline {subsection}{\numberline {2.3.3}Mapping Interface Fault's XML Representation to Component Properties}{47}{subsection.2.3.3} ! \contentsline {section}{\numberline {2.4}Interface Operation}{48}{section.2.4} ! \contentsline {subsection}{\numberline {2.4.1}The Interface Operation Component}{48}{subsection.2.4.1} ! \contentsline {subsubsection}{Message Exchange Pattern}{52}{section*.9} ! \contentsline {subsubsection}{Operation Style}{53}{section*.10} ! \contentsline {subsection}{\numberline {2.4.2}XML Representation of Interface Operation Component}{54}{subsection.2.4.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {operation} [owner element]}{55}{section*.11} ! \contentsline {subsubsection}{\texttt {pattern} \textit {attribute information item} with \texttt {operation} [owner element]}{56}{section*.12} ! \contentsline {subsubsection}{\texttt {style} \textit {attribute information item} with \texttt {operation} [owner element]}{56}{section*.13} ! \contentsline {subsection}{\numberline {2.4.3}Mapping Interface Operation's XML Representation to Component Properties}{56}{subsection.2.4.3} ! \contentsline {section}{\numberline {2.5}Interface Message Reference}{57}{section.2.5} ! \contentsline {subsection}{\numberline {2.5.1}The Interface Message Reference Component}{57}{subsection.2.5.1} ! \contentsline {subsection}{\numberline {2.5.2}XML Representation of Interface Message Reference Component}{60}{subsection.2.5.2} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{61}{section*.14} ! \contentsline {subsubsection}{\texttt {element} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{61}{section*.15} ! \contentsline {subsection}{\numberline {2.5.3}Mapping Interface Message Reference's XML Representation to Component Properties}{61}{subsection.2.5.3} ! \contentsline {section}{\numberline {2.6}Interface Fault Reference}{62}{section.2.6} ! \contentsline {subsection}{\numberline {2.6.1}The Interface Fault Reference Component}{62}{subsection.2.6.1} ! \contentsline {subsection}{\numberline {2.6.2}XML Representation of Interface Fault Reference}{65}{subsection.2.6.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {infault}, or \texttt {outfault} [owner element]}{66}{section*.16} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {infault}, or \texttt {outfault} [owner element]}{67}{section*.17} ! \contentsline {subsection}{\numberline {2.6.3}Mapping Interface Fault Reference's XML Representation to Component Properties}{67}{subsection.2.6.3} ! \contentsline {section}{\numberline {2.7}Binding}{68}{section.2.7} ! \contentsline {subsection}{\numberline {2.7.1}The Binding Component}{68}{subsection.2.7.1} ! \contentsline {subsection}{\numberline {2.7.2}XML Representation of Binding Component}{72}{subsection.2.7.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {binding} [owner element]}{73}{section*.18} ! \contentsline {subsubsection}{\texttt {interface} \textit {attribute information item} with \texttt {binding} [owner element]}{73}{section*.19} ! \contentsline {subsubsection}{\texttt {type} \textit {attribute information item} with \texttt {binding} [owner element]}{73}{section*.20} ! \contentsline {subsubsection}{Binding extension elements}{73}{section*.21} ! \contentsline {subsection}{\numberline {2.7.3}Mapping Binding's XML Representation to Component Properties}{74}{subsection.2.7.3} ! \contentsline {section}{\numberline {2.8}Binding Fault}{75}{section.2.8} ! \contentsline {subsection}{\numberline {2.8.1}The Binding Fault Component}{75}{subsection.2.8.1} ! \contentsline {subsection}{\numberline {2.8.2}XML Representation of Binding Fault Component}{77}{subsection.2.8.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {fault} [owner element]}{78}{section*.22} ! \contentsline {subsubsection}{Binding Fault extension elements}{78}{section*.23} ! \contentsline {subsection}{\numberline {2.8.3}Mapping Binding Fault's XML Representation to Component Properties}{78}{subsection.2.8.3} ! \contentsline {section}{\numberline {2.9}Binding Operation}{79}{section.2.9} ! \contentsline {subsection}{\numberline {2.9.1}The Binding Operation Component}{79}{subsection.2.9.1} ! \contentsline {subsection}{\numberline {2.9.2}XML Representation of Binding Operation Component}{82}{subsection.2.9.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {operation} [owner element]}{83}{section*.24} ! \contentsline {subsubsection}{Binding Operation extension elements}{83}{section*.25} ! \contentsline {subsection}{\numberline {2.9.3}Mapping Binding Operation's XML Representation to Component Properties}{83}{subsection.2.9.3} ! \contentsline {section}{\numberline {2.10}Binding Message Reference}{84}{section.2.10} ! \contentsline {subsection}{\numberline {2.10.1}The Binding Message Reference Component}{84}{subsection.2.10.1} ! \contentsline {subsection}{\numberline {2.10.2}XML Representation of Binding Message Reference Component}{86}{subsection.2.10.2} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {input} or \texttt {output} [owner element]}{87}{section*.26} ! \contentsline {subsubsection}{Binding Message Reference extension elements}{87}{section*.27} ! \contentsline {subsection}{\numberline {2.10.3}Mapping Binding Message Reference's XML Representation to Component Properties}{88}{subsection.2.10.3} ! \contentsline {section}{\numberline {2.11}Binding Fault Reference}{89}{section.2.11} ! \contentsline {subsection}{\numberline {2.11.1}The Binding Fault Reference Component}{89}{subsection.2.11.1} ! \contentsline {subsection}{\numberline {2.11.2}XML Representation of Binding Fault Reference Component}{91}{subsection.2.11.2} ! \contentsline {subsubsection}{\texttt {ref} \textit {attribute information item} with \texttt {infault} or \texttt {outfault} [owner element]}{92}{section*.28} ! \contentsline {subsubsection}{\texttt {messageLabel} \textit {attribute information item} with \texttt {infault} or \texttt {outfault} [owner element]}{92}{section*.29} ! \contentsline {subsubsection}{Binding Fault Reference extension elements}{92}{section*.30} ! \contentsline {subsection}{\numberline {2.11.3}Mapping Binding Fault Reference's XML Representation to Component Properties}{92}{subsection.2.11.3} ! \contentsline {section}{\numberline {2.12}Service}{94}{section.2.12} ! \contentsline {subsection}{\numberline {2.12.1}The Service Component}{94}{subsection.2.12.1} ! \contentsline {subsection}{\numberline {2.12.2}XML Representation of Service Component}{95}{subsection.2.12.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {service} [owner element]}{96}{section*.31} ! \contentsline {subsubsection}{\texttt {interface} \textit {attribute information item} with \texttt {service} [owner element]}{97}{section*.32} ! \contentsline {subsection}{\numberline {2.12.3}Mapping Service's XML Representation to Component Properties}{97}{subsection.2.12.3} ! \contentsline {section}{\numberline {2.13}Endpoint}{97}{section.2.13} ! \contentsline {subsection}{\numberline {2.13.1}The Endpoint Component}{97}{subsection.2.13.1} ! \contentsline {subsection}{\numberline {2.13.2}XML Representation of Endpoint Component}{99}{subsection.2.13.2} ! \contentsline {subsubsection}{\texttt {name} \textit {attribute information item} with \texttt {endpoint} [owner element]}{100}{section*.33} ! \contentsline {subsubsection}{\texttt {binding} \textit {attribute information item} with \texttt {endpoint} [owner element]}{101}{section*.34} ! \contentsline {subsubsection}{\texttt {address} \textit {attribute information item} with \texttt {endpoint} [owner element]}{101}{section*.35} ! \contentsline {subsubsection}{Endpoint extension elements}{101}{section*.36} ! \contentsline {subsection}{\numberline {2.13.3}Mapping Endpoint's XML Representation to Component Properties}{101}{subsection.2.13.3} ! \contentsline {section}{\numberline {2.14}XML Schema 1.0 Simple Types Used in the Component Model}{102}{section.2.14} ! \contentsline {section}{\numberline {2.15}Equivalence of Components}{103}{section.2.15} ! \contentsline {section}{\numberline {2.16}Symbol Spaces}{103}{section.2.16} ! \contentsline {section}{\numberline {2.17}QName resolution}{104}{section.2.17} ! \contentsline {section}{\numberline {2.18}Comparing URIs and IRIs}{104}{section.2.18} ! \contentsline {chapter}{\numberline {3}Types}{105}{chapter.3} ! \contentsline {section}{\numberline {3.1}Using W3C XML Schema Description Language}{106}{section.3.1} ! \contentsline {subsection}{\numberline {3.1.1}Importing XML Schema}{107}{subsection.3.1.1} ! \contentsline {subsubsection}{\texttt {namespace} \textit {attribute information item}}{108}{section*.37} ! \contentsline {subsubsection}{ \texttt {schemaLocation} \textit {attribute information item} }{108}{section*.38} ! \contentsline {subsection}{\numberline {3.1.2}Inlining XML Schema}{109}{subsection.3.1.2} ! \contentsline {subsection}{\numberline {3.1.3}References to Element Declarations and Type Definitions}{110}{subsection.3.1.3} ! \contentsline {section}{\numberline {3.2}Using Other Schema Languages}{110}{section.3.2} ! \contentsline {section}{\numberline {3.3}Describing Messages that Refer to Services and Endpoints}{111}{section.3.3} ! \contentsline {subsection}{\numberline {3.3.1} \texttt {wsdlx:interface} \textit {attribute information item} }{111}{subsection.3.3.1} ! \contentsline {subsection}{\numberline {3.3.2} \texttt {wsdlx:binding} \textit {attribute information item} }{111}{subsection.3.3.2} ! \contentsline {subsection}{\numberline {3.3.3}\texttt {wsdlx:interface} and \texttt {wsdlx:binding} Consistency}{112}{subsection.3.3.3} ! \contentsline {subsection}{\numberline {3.3.4}Use of \texttt {wsdlx:interface} and \texttt {wsdlx:binding} with \texttt {xs:anyURI}}{112}{subsection.3.3.4} ! \contentsline {chapter}{\numberline {4}Modularizing WSDL 2.0 descriptions}{113}{chapter.4} ! \contentsline {section}{\numberline {4.1}Including Descriptions}{113}{section.4.1} ! \contentsline {subsection}{\numberline {4.1.1}\texttt {location} \textit {attribute information item} with \texttt {include} [owner element]}{114}{subsection.4.1.1} ! \contentsline {section}{\numberline {4.2}Importing Descriptions}{115}{section.4.2} ! \contentsline {subsection}{\numberline {4.2.1}\texttt {namespace} \textit {attribute information item}}{116}{subsection.4.2.1} ! \contentsline {subsection}{\numberline {4.2.2}\texttt {location} \textit {attribute information item} with \texttt {import} [owner element]}{117}{subsection.4.2.2} ! \contentsline {section}{\numberline {4.3}Extensions}{117}{section.4.3} ! \contentsline {chapter}{\numberline {5}Documentation}{119}{chapter.5} ! \contentsline {chapter}{\numberline {6}Language Extensibility}{120}{chapter.6} ! \contentsline {section}{\numberline {6.1}Element based Extensibility}{120}{section.6.1} ! \contentsline {subsection}{\numberline {6.1.1}Mandatory extensions}{121}{subsection.6.1.1} ! \contentsline {subsection}{\numberline {6.1.2}\texttt {required} \textit {attribute information item}}{122}{subsection.6.1.2} ! \contentsline {section}{\numberline {6.2}Attribute-based Extensibility}{122}{section.6.2} ! \contentsline {section}{\numberline {6.3}Extensibility Semantics}{122}{section.6.3} ! \contentsline {chapter}{\numberline {7}Locating WSDL 2.0 Documents}{124}{chapter.7} ! \contentsline {section}{\numberline {7.1}\texttt {wsdli:wsdlLocation} \textit {attribute information item}}{124}{section.7.1} ! \contentsline {chapter}{\numberline {8}Conformance}{126}{chapter.8} ! \contentsline {section}{\numberline {8.1}XML Information Set Conformance}{126}{section.8.1} ! \contentsline {chapter}{\numberline {9}XML Syntax Summary (Non-Normative)}{127}{chapter.9} ! \contentsline {chapter}{\numberline {10}References}{131}{chapter.10} ! \contentsline {section}{\numberline {10.1}Normative References}{131}{section.10.1} ! \contentsline {section}{\numberline {10.2}Informative References}{132}{section.10.2} ! \contentsline {chapter}{\numberline {A}The application/wsdl+xml Media Type}{135}{appendix.A} ! \contentsline {section}{\numberline {A.1}Registration}{135}{section.A.1} ! \contentsline {section}{\numberline {A.2}Fragment Identifiers}{136}{section.A.2} ! \contentsline {subsection}{\numberline {A.2.1}The Description Component}{141}{subsection.A.2.1} ! \contentsline {subsection}{\numberline {A.2.2}The Element Declaration Component}{141}{subsection.A.2.2} ! \contentsline {subsection}{\numberline {A.2.3}The Type Definition Component}{142}{subsection.A.2.3} ! \contentsline {subsection}{\numberline {A.2.4}The Interface Component}{143}{subsection.A.2.4} ! \contentsline {subsection}{\numberline {A.2.5}The Interface Fault Component}{144}{subsection.A.2.5} ! \contentsline {subsection}{\numberline {A.2.6}The Interface Operation Component}{145}{subsection.A.2.6} ! \contentsline {subsection}{\numberline {A.2.7}The Interface Message Reference Component}{146}{subsection.A.2.7} ! \contentsline {subsection}{\numberline {A.2.8}The Interface Fault Reference Component}{147}{subsection.A.2.8} ! \contentsline {subsection}{\numberline {A.2.9}The Binding Component}{149}{subsection.A.2.9} ! \contentsline {subsection}{\numberline {A.2.10}The Binding Fault Component}{150}{subsection.A.2.10} ! \contentsline {subsection}{\numberline {A.2.11}The Binding Operation Component}{151}{subsection.A.2.11} ! \contentsline {subsection}{\numberline {A.2.12}The Binding Message Reference Component}{152}{subsection.A.2.12} ! \contentsline {subsection}{\numberline {A.2.13}The Binding Fault Reference Component}{153}{subsection.A.2.13} ! \contentsline {subsection}{\numberline {A.2.14}The Service Component}{155}{subsection.A.2.14} ! \contentsline {subsection}{\numberline {A.2.15}The Endpoint Component}{156}{subsection.A.2.15} ! \contentsline {subsection}{\numberline {A.2.16}Extension Components}{156}{subsection.A.2.16} ! \contentsline {section}{\numberline {A.3}Security considerations}{157}{section.A.3} ! \contentsline {chapter}{\numberline {B}Acknowledgements (Non-Normative)}{158}{appendix.B} ! \contentsline {chapter}{\numberline {C}IRI-References for WSDL 2.0 Components (Non-Normative)}{160}{appendix.C} ! \contentsline {section}{\numberline {C.1}WSDL 2.0 IRIs}{160}{section.C.1} ! \contentsline {section}{\numberline {C.2}Canonical Form for WSDL 2.0 Component Designators}{161}{section.C.2} ! \contentsline {section}{\numberline {C.3}Example}{161}{section.C.3} ! \contentsline {chapter}{\numberline {D}Component Summary (Non-Normative)}{164}{appendix.D} ! \contentsline {chapter}{\numberline {E}Assertion Summary (Non-Normative)}{168}{appendix.E} ! \contentsline {chapter}{\numberline {F}Part 1 Change Log (Non-Normative)}{177}{appendix.F} ! \contentsline {section}{\numberline {F.1}WSDL 2.0 Specification Changes}{177}{section.F.1} --- NEW FILE: adjuncts-message-assertion-table.xml --- <?xml version="1.0" encoding="UTF-8"?> <tbody> <tr> <th>Id</th> <th>Assertion</th> </tr> <tr> <td> <assert-summary ref="HTTPSerialization-2607010"/> </td> <td>This element MUST NOT carry an <att>xs:nil</att> attribute whose value is <attval>true</attval> </td> </tr> <tr> <td> <assert-summary ref="SOAPBinding-2503001"/> </td> <td>If the value is <attval>#element</attval> then the payload MUST be the <emph>element information item</emph> identified by the <prop comp="Interface Message Reference">element declaration</prop> property of the <comp>Interface Message Reference</comp> component.</td> </tr> <tr> <td> <assert-summary ref="SOAPBinding-5041"/> </td> <td>If the value is <attval>#none</attval> then the payload MUST be empty.</td> </tr> </tbody> Index: wsdl20-adjuncts.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.xml,v retrieving revision 1.198 retrieving revision 1.199 diff -C 2 -d -r1.198 -r1.199 *** wsdl20-adjuncts.xml 29 Nov 2006 08:46:03 -0000 1.198 --- wsdl20-adjuncts.xml 7 Dec 2006 16:30:06 -0000 1.199 *************** *** 8,11 **** --- 8,12 ---- <!ENTITY component-assertion-table SYSTEM "adjuncts-component-assertion-table.xml"> <!ENTITY document-assertion-table SYSTEM "adjuncts-document-assertion-table.xml"> + <!ENTITY message-assertion-table SYSTEM "adjuncts-message-assertion-table.xml"> <!ENTITY exchange-assertion-table SYSTEM "adjuncts-exchange-assertion-table.xml"> <!ENTITY assertion-summary SYSTEM "adjuncts-assertion-summary.xml"> *************** *** 5378,5381 **** --- 5379,5390 ---- <tr> + <td>20061206</td> + <td>AGR</td> + <td><loc + href="http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR094">CR094</loc>: + Added message assertion table.</td> + </tr> + + <tr> <td>20061128</td> <td>JJM</td> Index: wsdl20.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.html,v retrieving revision 1.295 retrieving revision 1.296 diff -C 2 -d -r1.295 -r1.296 *** wsdl20.html 22 Nov 2006 15:59:42 -0000 1.295 --- wsdl20.html 7 Dec 2006 16:30:04 -0000 1.296 *************** *** 1,13 **** ! <!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 http-equiv="Content-Type" content= ! "text/html; charset=utf-8" /> ! <title>Web Services Description Language (WSDL) Version 2.0 Part 1: ! Core Language</title> ! ! <style type="text/css" xml:space="preserve"> [...24116 lines suppressed...] ! <tr> ! <td rowspan="1" colspan="1">20020620</td> ! <td rowspan="1" colspan="1">SW</td> ! <td rowspan="1" colspan="1">Started adding abstract model</td> ! </tr> ! <tr> ! <td rowspan="1" colspan="1">20020406</td> ! <td rowspan="1" colspan="1">SW</td> ! <td rowspan="1" colspan="1">Created document from WSDL 1.1</td> ! </tr> ! </tbody> ! </table><br> ! ! </div> ! </div> ! ! </div> ! ! </body></html> \ No newline at end of file Index: wsdl20-primer.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-primer.html,v retrieving revision 1.165 retrieving revision 1.166 diff -C 2 -d -r1.165 -r1.166 *** wsdl20-primer.html 11 Nov 2006 19:43:51 -0000 1.165 --- wsdl20-primer.html 7 Dec 2006 16:30:07 -0000 1.166 *************** *** 93,97 **** <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br> 1.1 <a href="#Prerequisites">Prerequisites</a><br> 1.2 <a href="#PrimerStructure">Structure of this Primer</a><br> 1.3 <a href="#UseIRI">Use of URIs and IRIs</a><br> 1.4 <a href="#notation">Notational Conventions</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br> 2.1 <a href="#basic-example">Getting Started: The GreatH Hotel Example</a><br> 2.1.1 <a href="#basics-greath-scenario">Example Scenario: The GreatH Hotel Reservation Service</a><br> 2.1.2 <a href="#basics-getting-started">Defining a WSDL 2.0 Target Namespace</a><br> 2.1.2.1 <a href="#example-empty-shell-explanation">Explanation of Example</a><br> &nbp; 2.1.3 <a href="#basics-types">Defining Message Types</a><br> 2.1.3.1 <a href="#example-initial-types-explanation">Explanation of Example</a><br> 2.1.4 <a href="#basics-interface">Defining an Interface</a><br> 2.1.4.1 <a href="#example-initial-interface-explanation">Explanation of Example</a><br> 2.1.5 <a href="#basics-binding">Defining a Binding</a><br> 2.1.5.1 <a href="#example-initial-binding-explanation">Explanation of Example</a><br> 2.1.6 <a href="#basics-service">Defining a Service</a><br> 2.1.6.1 <a href="#example-initial-service-explanation">Explanatin of Example</a><br> 2.1.7 <a href="#basics-documentation">Documenting the Service</a><br> 2.1.7.1 <a href="#example-initial-documentation-explanation">Explanation of Example</a><br> 2.2 <a href="#wsdl-xml-representation">WSDL 2.0 Infoset, Schema and Component Model</a><br> 2.2.1 <a href="#wsdl-infoset-diagram">WSDL 2.0 Infoset</a><br> 2.2.2 <a href="#wsdl-schema">WSDL 2.0 Schema</a><br> 2.2.2.1 <a href="#element-order">WSDL 2.0 Element Ordering</a><br> 2.2.3 <a href="#component-model">WSDL 2.0 Component Model</a><br> 2.2.3.1 <a href="#import-component">WSDL 2.0 Import and Include</a><br>&nbp; 2.3 <a href="#more-types">More on Message Types</a><br> 2.3.1 <a href="#more-types-schema-inline">Inlining XML Schema</a><br> 2.3.2 <a href="#more-types-schema-import">Importing XML Schema</a><br> 2.3.3 <a href="#more-types-import-include-summary">Summary of Import and Include Mechanisms</a><br> 2.4 <a href="#more-interfaces">More on Interfaces</a><br> 2.4.1 <a href="#more-interfaces-interfaces">Interface Syntax </a><br> 2.4.2 <a href="#more-interfaces-inheritance">Interface Inheritance</a><br> 2.4.3 <a href="#more-interfaces-faults">Interface Faults</a><br> 2.4.4 <a href="#more-interfaces-operations">Interface Operations</a><br> &bsp; 2.4.4.1 <a href="#more-interfaces-op-attr">Operation Attributes</a><br> 2.4.4.2 <a href="#N109C9">Operation Message References</a><br> 2.4.4.2.1 <a href="#N109E6">The messageLabel Attribute</a><br> 2.4.4.2.2 <a href="#N109FE">The element Attribute</a><br> 2.4.4.2.3 <a href="#N10A4F">Multiple infault or outfault Elements</a><br> 2.4.4.3 <a href="#more-interfaces-meps">Understanding Message Exchange Patterns (MEPs)</a><br> 2.5 <a href="#more-bindings">More on Bindings</a><br> nbsp; 2.5.1 <a href="#more-bindings-wsdl">Syntax Summary for Bindings</a><br> 2.5.2 <a href="#more-bindings-reusable">Reusable Bindings</a><br> 2.5.3 <a href="#more-bindings-faults">Binding Faults</a><br> 2.5.4 <a href="#bindingOperations">Binding Operations</a><br> 2.5.5 <a href="#more-bindings-soap">The SOAP Binding Extension</a><br> 2.5.5.1 <a href="#more-bindings-soap-example-explanation">Explanation of Example</a><br> 2.5.6 <a href="#more-bindings-http">The HTTP Binding Extension</a><br> 2.5.6.1 <a href="#N10C17">Explanation of Example</a><br> 2.5.7 <a href="#adv-get-vs-post">HTTP GET Versus POST: Which to Use?</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br> 3.1 <a href="#adv-import-and-authoring">Importing WSDL</a><br> 3.2 <a href="#adv-multiple-inline-schemas">Importing Schemas</a><br> 3.2.1 <a href="#N10D67">Schemas in Imported Documents</a><br> 3.2.2 <a href="#N10DF2">Multiple Inline Schemas in One Document</a><br> 3.2.3 <a href="#adv-schema-location">The schemaLocation Attribute</a><br> 3.2.3.1 <a href="#N10E52">Using the id Attribute to Identify Inline ! Schemas</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br> 4.1 <a href="#adv-extensibility">Extensibility</a><br> 4.1.1 <a href="#adv-optional-versus-required">Optional Versus Required Extensions</a><br> 4.2 <a href="#adv-MEP">Defining New MEPs</a><br> 4.2.1 <a href="#challenge-confirm">Confirmed Challenge</a><br> 4.3 <a href="#adv-RPCstyle">RPC Style</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br> 5.1 <a href="#adv-message-dispatch">Enabling Easy Message Dispatch</a><br> 5.2 <a href="#adv-versioning">Web Service Versioning</a><br> 5.2.1 <a href="#adv-versioning-compatible-evolution">Compatible Evolution</a><br> .2.2 <a href="#adv-versioning-big-bang">Big Bang</a><br> 5.2.3 <a href="#ad-versioing-migration">Evolving a Service</a><br> 5.2.4 <a href="#adv-versioning-combined">Combined Approaches</a><br> 5.2.5 <a href="#adv-versioning-examples">Examples of Versioning and Extending a Service</a><br> 5.2.5.1 <a href="#N110EA">Additional Optional Elements Added in Content</a><br> 5.2.5.2 <a href="#N11101">Additional Optional Elements Added to a Header</a><br> 5.2.5.3 <a href="#N11118">Additional Mandatory Elements in Content</a><br> 5.2.5.4 <a href="#N1112F">Additional Optional Operation Added to Interfae</a><br> 5.2.5.5 <a href="#N1113B">Additional Mandatory Operation Added to Interface</a><br> 5.2.5.6 <a href="#N11155">Indicating Incompatibility by Changing the Endpoint URI</a><br> 5.2.5.7 <a href="#N1115E">Indicating Incompatibility by Changing the SOAP Action</a><br> 5.2.5.8 <a href="#N11175">Indicating Incompatibility by Changing the Element Content</a><br> 5.3 <a href="#adv-service-references"> Describing Web Service Messages That Refer to Other Web Services --- 93,97 ---- <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br> 1.1 <a href="#Prerequisites">Prerequisites</a><br> 1.2 <a href="#PrimerStructure">Structure of this Primer</a><br> 1.3 <a href="#UseIRI">Use of URIs and IRIs</a><br> 1.4 <a href="#notation">Notational Conventions</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br> 2.1 <a href="#basic-example">Getting Started: The GreatH Hotel Example</a><br> 2.1.1 <a href="#basics-greath-scenario">Example Scenario: The GreatH Hotel Reservation Service</a><br> 2.1.2 <a href="#basics-getting-started">Defining a WSDL 2.0 Target Namespace</a><br> 2.1.2.1 <a href="#example-empty-shell-explanation">Explanation of Example</a><br> &nbp; 2.1.3 <a href="#basics-types">Defining Message Types</a><br> 2.1.3.1 <a href="#example-initial-types-explanation">Explanation of Example</a><br> 2.1.4 <a href="#basics-interface">Defining an Interface</a><br> 2.1.4.1 <a href="#example-initial-interface-explanation">Explanation of Example</a><br> 2.1.5 <a href="#basics-binding">Defining a Binding</a><br> 2.1.5.1 <a href="#example-initial-binding-explanation">Explanation of Example</a><br> 2.1.6 <a href="#basics-service">Defining a Service</a><br> 2.1.6.1 <a href="#example-initial-service-explanation">Explanatin of Example</a><br> 2.1.7 <a href="#basics-documentation">Documenting the Service</a><br> 2.1.7.1 <a href="#example-initial-documentation-explanation">Explanation of Example</a><br> 2.2 <a href="#wsdl-xml-representation">WSDL 2.0 Infoset, Schema and Component Model</a><br> 2.2.1 <a href="#wsdl-infoset-diagram">WSDL 2.0 Infoset</a><br> 2.2.2 <a href="#wsdl-schema">WSDL 2.0 Schema</a><br> 2.2.2.1 <a href="#element-order">WSDL 2.0 Element Ordering</a><br> 2.2.3 <a href="#component-model">WSDL 2.0 Component Model</a><br> 2.2.3.1 <a href="#import-component">WSDL 2.0 Import and Include</a><br>&nbp; 2.3 <a href="#more-types">More on Message Types</a><br> 2.3.1 <a href="#more-types-schema-inline">Inlining XML Schema</a><br> 2.3.2 <a href="#more-types-schema-import">Importing XML Schema</a><br> 2.3.3 <a href="#more-types-import-include-summary">Summary of Import and Include Mechanisms</a><br> 2.4 <a href="#more-interfaces">More on Interfaces</a><br> 2.4.1 <a href="#more-interfaces-interfaces">Interface Syntax </a><br> 2.4.2 <a href="#more-interfaces-inheritance">Interface Inheritance</a><br> 2.4.3 <a href="#more-interfaces-faults">Interface Faults</a><br> 2.4.4 <a href="#more-interfaces-operations">Interface Operations</a><br> &bsp; 2.4.4.1 <a href="#more-interfaces-op-attr">Operation Attributes</a><br> 2.4.4.2 <a href="#N109C9">Operation Message References</a><br> 2.4.4.2.1 <a href="#N109E6">The messageLabel Attribute</a><br> 2.4.4.2.2 <a href="#N109FE">The element Attribute</a><br> 2.4.4.2.3 <a href="#N10A4F">Multiple infault or outfault Elements</a><br> 2.4.4.3 <a href="#more-interfaces-meps">Understanding Message Exchange Patterns (MEPs)</a><br> 2.5 <a href="#more-bindings">More on Bindings</a><br> nbsp; 2.5.1 <a href="#more-bindings-wsdl">Syntax Summary for Bindings</a><br> 2.5.2 <a href="#more-bindings-reusable">Reusable Bindings</a><br> 2.5.3 <a href="#more-bindings-faults">Binding Faults</a><br> 2.5.4 <a href="#bindingOperations">Binding Operations</a><br> 2.5.5 <a href="#more-bindings-soap">The SOAP Binding Extension</a><br> 2.5.5.1 <a href="#more-bindings-soap-example-explanation">Explanation of Example</a><br> 2.5.6 <a href="#more-bindings-http">The HTTP Binding Extension</a><br> 2.5.6.1 <a href="#N10C17">Explanation of Example</a><br> 2.5.7 <a href="#adv-get-vs-post">HTTP GET Versus POST: Which to Use?</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br> 3.1 <a href="#adv-import-and-authoring">Importing WSDL</a><br> 3.2 <a href="#adv-multiple-inline-schemas">Importing Schemas</a><br> 3.2.1 <a href="#N10D67">Schemas in Imported Documents</a><br> 3.2.2 <a href="#N10DF2">Multiple Inline Schemas in One Document</a><br> 3.2.3 <a href="#adv-schema-location">The schemaLocation Attribute</a><br> 3.2.3.1 <a href="#N10E52">Using the id Attribute to Identify Inline ! Schemas</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br> 4.1 <a href="#adv-extensibility">Extensibility</a><br> 4.1.1 <a href="#adv-optional-versus-required">Optional Versus Required Extensions</a><br> 4.2 <a href="#adv-MEP">Defining New MEPs</a><br> 4.2.1 <a href="#challenge-confirm">Confirmed Challenge</a><br> 4.3 <a href="#adv-RPCstyle">RPC Style</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br> 5.1 <a href="#adv-message-dispatch">Enabling Easy Message Dispatch</a><br> 5.2 <a href="#adv-versioning">Web Service Versioning</a><br> 5.2.1 <a href="#adv-versioning-compatible-evolution">Compatible Evolution</a><br> .2.2 <a href="#adv-versioning-big-bang">Big Bang</a><br> 5.2.3 <a href="#ad-versioing-migration">Evolving a Service</a><br> 5.2.4 <a href="#adv-versioning-combined">Combined Approaches</a><br> 5.2.5 <a href="#adv-versioning-examples">Examples of Versioning and Extending a Service</a><br> 5.2.5.1 <a href="#N110DF">Additional Optional Elements Added in Content</a><br> 5.2.5.2 <a href="#N110F6">Additional Optional Elements Added to a Header</a><br> 5.2.5.3 <a href="#N1110D">Additional Mandatory Elements in Content</a><br> 5.2.5.4 <a href="#N11124">Additional Optional Operation Added to Interfae</a><br> 5.2.5.5 <a href="#N11130">Additional Mandatory Operation Added to Interface</a><br> 5.2.5.6 <a href="#N1114A">Indicating Incompatibility by Changing the Endpoint URI</a><br> 5.2.5.7 <a href="#N11153">Indicating Incompatibility by Changing the SOAP Action</a><br> 5.2.5.8 <a href="#N1116A">Indicating Incompatibility by Changing the Element Content</a><br> 5.3 <a href="#adv-service-references"> Describing Web Service Messages That Refer to Other Web Services *************** *** 2548,2552 **** for schema versioning as a part of the Schema 1.1 activity. See XML Schema Versioning Use Cases [<cite><a href="#xsd-versioning">XML Schema: Versioning Use-Cases</a></cite>].</p></li><li><p>The <a href="http://www.w3.org/2001/sw/BestPractices/">Semantic Web Best Practices and Deployments Working Group</a> is examining how vocabularies may evolve. See [<cite><a href="#sw-vocabulary">SW VocabManagementNote</a></cite>]</p></li></ul> - <table border="1" summary="Editorial note: PaulD"><tr><td width="50%" valign="top" align="left"><b>Editorial note: PaulD</b></td><td width="50%" valign="top" align="right">20050706</td></tr><tr><td valign="top" align="left" colspan="2">This section may be subject to change dependent upon the outcome of the WSDL Last Call Issue LC124, which discusses support compatible evolution of messages described using XML Schema 1.0.</td></tr></table> <p>While incomplete, these activities all agree in one important --- 2548,2551 ---- *************** *** 2644,2648 **** <div class="div4"> ! <h5><a name="N110EA"></a>5.2.5.1 Additional Optional Elements Added in Content</h5> <p> The following example demonstrates how content may be extended with additional content. The reservation service is changed to a newer version that can accept an optional --- 2643,2647 ---- <div class="div4"> ! <h5><a name="N110DF"></a>5.2.5.1 Additional Optional Elements Added in Content</h5> <p> The following example demonstrates how content may be extended with additional content. The reservation service is changed to a newer version that can accept an optional *************** *** 2673,2677 **** <div class="div4"> ! <h5><a name="N11101"></a>5.2.5.2 Additional Optional Elements Added to a Header</h5> <p> Another option is to add the extension as a header block. This is accomplished by defining an element for the extension and adding a --- 2672,2676 ---- <div class="div4"> ! <h5><a name="N110F6"></a>5.2.5.2 Additional Optional Elements Added to a Header</h5> <p> Another option is to add the extension as a header block. This is accomplished by defining an element for the extension and adding a *************** *** 2708,2712 **** <div class="div4"> ! <h5><a name="N11118"></a>5.2.5.3 Additional Mandatory Elements in Content</h5> <p> This following example demonstrates an extension with additional content. The reservation service requires a number of guests parameter. --- 2707,2711 ---- <div class="div4"> ! <h5><a name="N1110D"></a>5.2.5.3 Additional Mandatory Elements in Content</h5> <p> This following example demonstrates an extension with additional content. The reservation service requires a number of guests parameter. *************** *** 2736,2740 **** <div class="div4"> ! <h5><a name="N1112F"></a>5.2.5.4 Additional Optional Operation Added to Interface</h5> <p> Section <a href="#more-interfaces-inheritance"><b>2.4.2 Interface Inheritance</b></a> shows another type of versioning or extension, where the reservationInterface extends the --- 2735,2739 ---- <div class="div4"> ! <h5><a name="N11124"></a>5.2.5.4 Additional Optional Operation Added to Interface</h5> <p> Section <a href="#more-interfaces-inheritance"><b>2.4.2 Interface Inheritance</b></a> shows another type of versioning or extension, where the reservationInterface extends the *************** *** 2745,2749 **** <div class="div4"> ! <h5><a name="N1113B"></a>5.2.5.5 Additional Mandatory Operation Added to Interface</h5> <p> Often mandatory operations are added to an interface. The Hotel service decides to add an operation to the reservation service which is a --- 2744,2748 ---- <div class="div4"> ! <h5><a name="N11130"></a>5.2.5.5 Additional Mandatory Operation Added to Interface</h5> <p> Often mandatory operations are added to an interface. The Hotel service decides to add an operation to the reservation service which is a *************** *** 2788,2792 **** <div class="div4"> ! <h5><a name="N11155"></a>5.2.5.6 Indicating Incompatibility by Changing the Endpoint URI</h5> <p> To indicate incompatibility, the URI of the Hotel Endpoint can be changed and messages send to the old Endpoint return a Fault.</p> --- 2787,2791 ---- <div class="div4"> ! <h5><a name="N1114A"></a>5.2.5.6 Indicating Incompatibility by Changing the Endpoint URI</h5> <p> To indicate incompatibility, the URI of the Hotel Endpoint can be changed and messages send to the old Endpoint return a Fault.</p> *************** *** 2794,2798 **** <div class="div4"> ! <h5><a name="N1115E"></a>5.2.5.7 Indicating Incompatibility by Changing the SOAP Action</h5> <p> The SOAP Action can be set for the makeReservation request, and making it different than the earlier version should indicate incompatibility.</p> --- 2793,2797 ---- <div class="div4"> ! <h5><a name="N11153"></a>5.2.5.7 Indicating Incompatibility by Changing the SOAP Action</h5> <p> The SOAP Action can be set for the makeReservation request, and making it different than the earlier version should indicate incompatibility.</p> *************** *** 2815,2819 **** <div class="div4"> ! <h5><a name="N11175"></a>5.2.5.8 Indicating Incompatibility by Changing the Element Content</h5> <p> The namespace or name of the makeReservation element can be changed, and then the interface and bindings changed. To indicate incompatibility, --- 2814,2818 ---- <div class="div4"> ! <h5><a name="N1116A"></a>5.2.5.8 Indicating Incompatibility by Changing the Element Content</h5> <p> The namespace or name of the makeReservation element can be changed, and then the interface and bindings changed. To indicate incompatibility, *************** *** 3588,3595 **** <h3><a name="adv-rdf-mapping"></a>5.5 Mapping to RDF and Semantic Web</h3> - <table border="1" summary="Editorial note: KevinL"><tr><td width="50%" valign="top" align="left"><b>Editorial note: KevinL</b></td><td width="50%" valign="top" align="right">20050429</td></tr><tr><td valign="top" align="left" colspan="2"> - This section might be removed - pending on the availability of the RDF mapping note. </td></tr></table> - - <p>WSDL 2.0 is a language designed primarily with XML syntax. While XML is almost universally understood, it has several issues: </p> --- 3587,3590 ----
Received on Thursday, 7 December 2006 16:30:49 UTC