- From: Hugo Haas via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 16 Mar 2005 17:42:48 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory homer:/tmp/cvs-serv29809
Modified Files:
altschemalangs.xml
Added Files:
Makefile.altschemas altschemalangs.html
Log Message:
First version
Index: altschemalangs.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/altschemalangs.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** altschemalangs.xml 16 Mar 2005 16:45:00 -0000 1.1
--- altschemalangs.xml 16 Mar 2005 17:42:46 -0000 1.2
***************
*** 1,20 ****
<?xml version="1.0" encoding="UTF-8"?>
! <!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.2//EN" "http://www.w3.org/2002/xmlspec/dtd/2.2/xmlspec.dtd">
! <!--
! /*
! * Copyright (c) 2003 World Wide Web Consortium,
! *
! * (Massachusetts Institute of Technology, European Research Consortium for
! * Informatics and Mathematics, Keio University). All Rights Reserved. This
! * work is distributed under the W3C(r) Document License [1] in the hope that
! * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
! * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
! *
! * [1] http://www.w3.org/Consortium/Legal/2002/copyright-documents-20021231
! */
! -->
! <!-- $Id$ -->
<?xml-stylesheet type='text/xsl' href='xmlspec-wsdl.xsl' ?>
! <spec xmlns:xlink="http://www.w3.org/1999/xlink" w3c-doctype="wgnote" role="public">
<header>
<title>Web Services Description Language (WSDL): Alternative Schema Languages Support</title>
--- 1,13 ----
<?xml version="1.0" encoding="UTF-8"?>
! <!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.1//EN" "xmlspec.dtd"[
! <!ENTITY % entities SYSTEM "entities.dtd" >
! <!ENTITY prefix "altschemalangs">
! %entities;
! <!ENTITY document.status "Editors' copy $Date$">
! <!ENTITY status SYSTEM "status.xml">
! <!--<!ENTITY prevloc "http://www.w3.org/TR/2003/WD-wsdl12-bindings-20030611">-->
! ]>
<?xml-stylesheet type='text/xsl' href='xmlspec-wsdl.xsl' ?>
! <spec w3c-doctype="note" role="edcopy">
<header>
<title>Web Services Description Language (WSDL): Alternative Schema Languages Support</title>
***************
*** 31,44 ****
>http://www.w3.org/TR/2005/@@</loc>
</publoc>
- <altlocs>
- <!--<loc role="postscript" href="wsdl20.ps" xlink:type="simple" xlink:show="replace"
- xlink:actuate="onRequest">postscript</loc>
- <loc role="pdf" href="wsdl20.pdf" xlink:type="simple" xlink:show="replace"
- xlink:actuate="onRequest">PDF</loc>
- <loc role="xml" href="wsdl20.xml" xlink:type="simple" xlink:show="replace"
- xlink:actuate="onRequest">XML</loc>
- <loc role="plain" href="wsdl20.txt" xlink:type="simple" xlink:show="replace"
- xlink:actuate="onRequest">plain text</loc>-->
- </altlocs>
<prevlocs>
<!--<loc href="http://www.w3.org/TR/2004/WD-wsdl20-20040326" xlink:type="simple"
--- 24,27 ----
***************
*** 73,81 ****
publication. Other documents may supersede this document. A list of current W3C
publications and the latest revision of this technical report can be found in
! the <loc href="http://www.w3.org/TR/" xlink:type="simple" xlink:show="replace"
! xlink:actuate="onRequest">W3C technical reports index</loc> at
http://www.w3.org/TR/.</emph>
</p>
</status>
</header>
<body>
--- 56,69 ----
publication. Other documents may supersede this document. A list of current W3C
publications and the latest revision of this technical report can be found in
! the <loc href="http://www.w3.org/TR/">W3C technical reports index</loc> at
http://www.w3.org/TR/.</emph>
</p>
</status>
+ <langusage>
+ <language id="en">English</language>
+ </langusage>
+ <revisiondesc>
+ <p>Last Modified: $Date$</p>
+ </revisiondesc>
</header>
<body>
***************
*** 91,95 ****
<p>A DTD may be used as the schema language for WSDL. It may not be embedded; it
must be imported. A namespace must be assigned. DTD types appear in the {element
! declarations} property of <specref ref="Definitions_details"/> and may be
referenced from the <el>wsdl:input</el>, <el>wsdl:output</el> and
<el>wsdl:fault</el> elements using the <att>element</att>
--- 79,83 ----
<p>A DTD may be used as the schema language for WSDL. It may not be embedded; it
must be imported. A namespace must be assigned. DTD types appear in the {element
! declarations} property of <xspecref href="&w3c-designation-part1;#Definitions_details">@@@</xspecref> and may be
referenced from the <el>wsdl:input</el>, <el>wsdl:output</el> and
<el>wsdl:fault</el> elements using the <att>element</att>
***************
*** 189,193 ****
<emph>element information item</emph> must match the specified namespace. RELAX
NG provides both type definitions and element declarations, the latter appears
! in the {element declarations} property of <specref ref="Definitions_details"/>
respectively. The following discussion supplies the prefix rng which is mapped
to the URI "http://www.relaxng.org/ns/structure/1.0".</p>
--- 177,181 ----
<emph>element information item</emph> must match the specified namespace. RELAX
NG provides both type definitions and element declarations, the latter appears
! in the {element declarations} property of <xspecref href="&w3c-designation-part1;#Definitions_details">@@@</xspecref>
respectively. The following discussion supplies the prefix rng which is mapped
to the URI "http://www.relaxng.org/ns/structure/1.0".</p>
--- NEW FILE: altschemalangs.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1st August 2004), see www.w3.org" />
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8" />
<title>Web Services Description Language (WSDL): Alternative Schema
Languages Support</title>
<style type="text/css">
/*<![CDATA[*/
code { font-family: monospace; }
div.constraint,
div.issue,
div.note,
div.notice { margin-left: 2em; }
dt.label { display: run-in; }
li, p { margin-top: 0.3em;
margin-bottom: 0.3em; }
.diff-chg { background-color: yellow; }
.diff-del { background-color: red; text-decoration: line-through;}
.diff-add { background-color: lime; }
table { empty-cells: show; }
table caption {
font-weight: normal;
font-style: italic;
text-align: left;
margin-bottom: .5em;
}
div.issue {
color: red;
}
div.exampleInner pre { margin-left: 1em;
margin-top: 0em; margin-bottom: 0em}
div.exampleOuter {border: 4px double gray;
margin: 0em; padding: 0em}
div.exampleInner { background-color: #d5dee3;
border-top-width: 4px;
border-top-style: double;
border-top-color: #d3d3d3;
border-bottom-width: 4px;
border-bottom-style: double;
border-bottom-color: #d3d3d3;
padding: 4px; margin: 0em }
div.exampleWrapper { margin: 4px }
div.exampleHeader { font-weight: bold;
margin: 4px}
/*]]>*/
</style>
<link type="text/css" rel="stylesheet" href="zml.css" />
<link rel="stylesheet" type="text/css" href=
"http://www.w3.org/StyleSheets/TR/W3C-NOTE.css" />
<script language="JavaScript" src="twisty.js" type=
"text/javascript">
</script>
<link rel="contents" href="#contents" />
</head>
<body>
<div class="head">
<p><a href="http://www.w3.org/"><img src=
"http://www.w3.org/Icons/w3c_home" alt="W3C" height="48" width=
"72" /></a></p>
<h1>Web Services Description Language (WSDL): Alternative Schema
Languages Support</h1>
<dl>
<dt>This version:</dt>
<dd><a href=
"http://www.w3.org/TR/2004/WD-wsdl20-20040803">http://www.w3.org/TR/2005/@@</a></dd>
<dt>Latest version:</dt>
<dt>Previous versions:</dt>
<dt>Editors:</dt>
<dd>..., ...</dd>
<dd>Bijan Parsia, Maryland Information and Network Dynamics
Laboratory at the University of Maryland at College Park</dd>
<dd>..., ...</dd>
</dl>
<p class="copyright"><a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © <a href="http://www.w3.org/">
<acronym title=
"World Wide Web Consortium">W3C</acronym></a><sup>®</sup> (<a href=
"http://www.csail.mit.edu/"><acronym title=
"Massachusetts Institute of Technology">MIT</acronym></a>, <a href=
"http://www.ercim.org/"><acronym title=
"European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved.
W3C <a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href=
"http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
and <a href=
"http://www.w3.org/Consortium/Legal/copyright-documents">document
use</a> rules apply.</p>
</div>
<hr />
<div>
<h2><a name="abstract" id="abstract">Abstract</a></h2>
</div>
<div>
<h2><a name="status" id="status">Status of this Document</a></h2>
<p><em>This section describes the status of this document at the
time of its publication. Other documents may supersede this
document. A list of current W3C publications and the latest
revision of this technical report can be found in the <a href=
"http://www.w3.org/TR/">W3C technical reports index</a> at
http://www.w3.org/TR/.</em></p>
</div>
<hr />
<div class="toc">
<h2><a name="shortcontents" id="shortcontents">Short Table of
Contents</a></h2>
<p class="toc">1. <a href="#intro">Introduction</a><br />
2. <a href="#examples">Examples of Specifications of Extension
Elements for Alternative Schema Language Support.</a><br /></p>
</div>
<hr />
<div class="toc">
<h2><a name="contents" id="contents">Table of Contents</a></h2>
<p class="toc">1. <a href="#intro">Introduction</a><br />
2. <a href="#examples">Examples of Specifications of Extension
Elements for Alternative Schema Language Support.</a><br />
2.1 <a href="#dtd">DTD</a><br />
2.1.1 <a href=
"#dtd-namespaceaii">namespace attribute information item</a><br />
2.1.2 <a href=
"#dtd-locationaii">location attribute information item</a><br />
2.1.3 <a href=
"#dtd-ref">References to Element Definitions</a><br />
2.2 <a href="#relax">RELAX NG</a><br />
2.2.1 <a href=
"#import-relax">Importing RELAX NG</a><br />
2.2.1.1
<a href="#relax-import-nsaii">ns attribute information
item</a><br />
2.2.1.2
<a href="#relax-import-hrefaii">href attribute information
item</a><br />
2.2.2 <a href=
"#relax-embed">Embedding RELAX NG</a><br />
2.2.2.1
<a href="#relax-embed-nsaii">ns attribute information
item</a><br />
2.2.3 <a href=
"#relax-ref">References to Element Declarations</a><br /></p>
</div>
<hr />
<div class="body">
<div class="div1">
<h2><a name="intro" id="intro"></a>1. Introduction</h2>
</div>
<div class="div1">
<h2><a name="examples" id="examples"></a>2. Examples of
Specifications of Extension Elements for Alternative Schema
Language Support.</h2>
<div class="div2">
<h3><a name="dtd" id="dtd"></a>2.1 DTD</h3>
<p>A DTD may be used as the schema language for WSDL. It may not be
embedded; it must be imported. A namespace must be assigned. DTD
types appear in the {element declarations} property of <a href=
"wsdl20.html#Definitions_details">@@@</a> and may be referenced
from the <code>wsdl:input</code> , <code>wsdl:output</code> and
<code>wsdl:fault</code> elements using the <code>element</code>
<em>attribute information item</em>.</p>
<p>The prefix, dtd, used throughout the following is mapped to the
namespace URI "http://www.example.org/dtd/".</p>
<p>The <code>dtd:import</code> <em>element information item</em>
references an external Document Type Definition, and has the
following infoset properties:</p>
<ul>
<li>
<p>A [local name] of import.</p>
</li>
<li>
<p>A [namespace name] of "http://www.example.org/dtd".</p>
</li>
<li>
<p>One or two <em>attribute information item</em>s, as follows:</p>
<ul>
<li>
<p>A REQUIRED <code>namespace</code> <em>attribute information
item</em> as described below.</p>
</li>
<li>
<p>An OPTIONAL <code>location</code> <em>attribute information
item</em> as described below.</p>
</li>
</ul>
</li>
</ul>
<div class="div3">
<h4><a name="dtd-namespaceaii" id="dtd-namespaceaii"></a>2.1.1
<code>namespace</code> <em>attribute information item</em></h4>
<p>The <code>namespace</code> <em>attribute information item</em>
sets the namespace to be used with all imported element definitions
described in the DTD. It has the following infoset properties:</p>
<ul>
<li>
<p>A [local name] of namespace.</p>
</li>
<li>
<p>A [namespace name] which has no value.</p>
</li>
</ul>
<p>The type of the <code>namespace</code> <em>attribute information
item</em> is <em>xs:anyURI</em>.</p>
<p>The WSDL author should ensure that a prefix is associated with
the namespace at the proper scope (probably document scope).</p>
</div>
<div class="div3">
<h4><a name="dtd-locationaii" id="dtd-locationaii"></a>2.1.2
<code>location</code> <em>attribute information item</em></h4>
<p>The <code>location</code> <em>attribute information item</em>,
if present, provides a hint to the processor as to where the DTD
may be located. Caching and cataloging technologies may provide
better information than this hint. The <code>location</code>
<em>attribute information item</em> has the following infoset
properties:</p>
<ul>
<li>
<p>A [local name] of location.</p>
</li>
<li>
<p>A [namespace name] which has no value.</p>
</li>
</ul>
<p>The type of the <code>location</code> <em>attribute information
item</em> is <em>xs:anyURI</em>.</p>
</div>
<div class="div3">
<h4><a name="dtd-ref" id="dtd-ref"></a>2.1.3 References to Element
Definitions</h4>
<p>The <code>element</code> <em>attribute information item</em>
MUST be used when referring to an element definition
(<!ELEMENT>) from a Message Reference component; referring to
an element definition from a Interface Fault component is similar.
The value of the element definition MUST correspond to the content
of the <code>namespace</code> <em>attribute information item</em>
of the <code>dtd:import</code> <em>element information item</em>.
The local name part must correspond to an element defined in the
DTD.</p>
<p>Note that this pattern does not attempt to make DTDs
namespace-aware. It applies namespaces externally, in the import
phase.</p>
</div>
</div>
<div class="div2">
<h3><a name="relax" id="relax"></a>2.2 RELAX NG</h3>
<p>A RELAX NG schema may be used as the schema language for WSDL.
It may be embedded or imported; import is preferred. A namespace
must be specified; if an imported schema specifies one, then the
[actual value] of the <code>namespace</code> <em>attribute
information item</em> in the <code>import</code> <em>element
information item</em> must match the specified namespace. RELAX NG
provides both type definitions and element declarations, the latter
appears in the {element declarations} property of <a href=
"wsdl20.html#Definitions_details">@@@</a> respectively. The
following discussion supplies the prefix rng which is mapped to the
URI "http://www.relaxng.org/ns/structure/1.0".</p>
<div class="div3">
<h4><a name="import-relax" id="import-relax"></a>2.2.1 Importing
RELAX NG</h4>
<p>Importing a RELAX NG schema uses the rng:include mechanism
defined by RNG, with restrictions on its syntax and semantics. A
child <em>element information item</em> of the <code>types</code>
<em>element information item</em> is defined with the Infoset
properties as follows:</p>
<ul>
<li>
<p>A [local name] of include.</p>
</li>
<li>
<p>A [namespace name] of
"http://www.relaxng.org/ns/structure/1.0".</p>
</li>
<li>
<p>Two <em>attribute information item</em>s as follows:</p>
<ul>
<li>
<p>A REQUIRED <code>ns</code> <em>attribute information item</em>
as described below.</p>
</li>
<li>
<p>An OPTIONAL <code>href</code> <em>attribute information
item</em> as described below.</p>
</li>
<li>
<p>Additional <em>attribute information item</em>s as defined by
the RNG specification.</p>
</li>
</ul>
</li>
</ul>
<p>Note that WSDL restricts the <code>rng:include</code>
<em>element information item</em> to be empty. That is, it cannot
redefine <code>rng:start</code> and <code>rng:define</code>
<em>element information item</em>s; it may be used solely to import
a schema.</p>
<div class="div4">
<h5><a name="relax-import-nsaii" id=
"relax-import-nsaii"></a>2.2.1.1 <code>ns</code> <em>attribute
information item</em></h5>
<p>The <code>ns</code> <em>attribute information item</em> defines
the namespace of the type and element definitions imported from the
referenced schema. If the referenced schema contains an
<code>ns</code> <em>attribute information item</em> on its
<code>grammar</code> <em>element information item</em>, then the
values of these two <em>attribute information item</em>s must be
identical. If the imported grammar does not have an <code>ns</code>
<em>attribute information item</em> then the namespace specified
here is applied to all components of the schema as if it did
contain such an <em>attribute information item</em>. The
<code>ns</code> <em>attribute information item</em> contains the
following Infoset properties:</p>
<ul>
<li>
<p>A [local name] of ns.</p>
</li>
<li>
<p>A [namespace name] which has no value.</p>
</li>
</ul>
<p>The type of the <code>ns</code> <em>attribute information
item</em> is <em>xs:anyURI</em>.</p>
</div>
<div class="div4">
<h5><a name="relax-import-hrefaii" id=
"relax-import-hrefaii"></a>2.2.1.2 <code>href</code> <em>attribute
information item</em></h5>
<p>The <code>href</code> <em>attribute information item</em> must
be present, according to the rules of the RNG specification.
However, WSDL allows it to be empty, and considers it only a hint.
Caching and cataloging technologies may provide better information
that this hint. The <code>href</code> <em>attribute information
item</em> has the following Infoset properties:</p>
<ul>
<li>
<p>A [local name] of href.</p>
</li>
<li>
<p>A [namespace name] which has no value.</p>
</li>
</ul>
<p>The type of the <code>href</code> <em>attribute information
item</em> is <em>xs:anyURI</em>.</p>
</div>
</div>
<div class="div3">
<h4><a name="relax-embed" id="relax-embed"></a>2.2.2 Embedding
RELAX NG</h4>
<p>Embedding an RNG schema uses the existing top-level
<code>rng:grammar</code> <em>element information item</em>. It may
be viewed as simply cutting and pasting an existing, stand-alone
schema to a location inside the <code>wsdl:types</code> <em>element
information item</em>. The <code>rng:grammar</code> <em>element
information item</em> has the following Infoset properties:</p>
<ul>
<li>
<p>A [local name] of grammar.</p>
</li>
<li>
<p>A [namespace name] of
"http://www.relaxng.org/ns/structure/1.0".</p>
</li>
<li>
<p>A REQUIRED <code>ns</code> <em>attribute information item</em>s
as described below.</p>
</li>
<li>
<p>Additional <em>attribute information item</em>s as specified for
the <code>rng:grammar</code> <em>element information item</em> in
the RNG specification.</p>
</li>
<li>
<p>Child <em>element information item</em>s as specified for the
<code>rng:grammar</code> <em>element information item</em> in the
RNG specification.</p>
</li>
</ul>
<div class="div4">
<h5><a name="relax-embed-nsaii" id="relax-embed-nsaii"></a>2.2.2.1
<code>ns</code> <em>attribute information item</em></h5>
<p>The <code>ns</code> <em>attribute information item</em> defines
the namespace of the type and element definitions embedded in this
schema. WSDL modifies the RNG definition of the
<code>rng:grammar</code> <em>element information item</em> to make
this <em>attribute information item</em> required. The
<code>ns</code> <em>attribute information item</em> has the
following infoset properties:</p>
<ul>
<li>
<p>A [local name] of ns.</p>
</li>
<li>
<p>A [namespace name] which has no value.</p>
</li>
</ul>
<p>The type of the <code>ns</code> <em>attribute information
item</em> is <em>xs:anyURI</em>.</p>
</div>
</div>
<div class="div3">
<h4><a name="relax-ref" id="relax-ref"></a>2.2.3 References to
Element Declarations</h4>
<p>Whether embedded or imported, the element definitions present in
a schema may be referenced from a Message Reference or Interface
Fault component.</p>
<p>A named rng:define definition MUST NOT be referenced from the
Message Reference or Interface Fault components.</p>
<p>A named Relax NG element declaration MAY be referenced from a
Message Reference or Interface Fault component. The QName is
constructed from the namespace (<code>ns</code> <em>attribute
information item</em>) of the schema and the content of the
<code>name</code> <em>attribute information item</em> of the
<code>element</code> <em>element information item</em> An
<code>element</code> <em>attribute information item</em> MUST NOT
be used to refer to an <code>rng:define</code> <em>element
information item</em>.</p>
</div>
</div>
</div>
</div>
</body>
</html>
--- NEW FILE: Makefile.altschemas ---
# -*-makefile-*-
PREFIX=altschemalangs
SCHEMAS=
FILES=\
status.xml \
prevwgmb.txt \
wgmb.txt \
xmlspec.dtd \
entitiesedcopy.dtd \
entitieswd.dtd \
entities.dtd \
xmlspec.xsl \
xmlspec-wsdl.xsl
include Makefile.base
Received on Wednesday, 16 March 2005 17:42:48 UTC