You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
369 lines
16 KiB
369 lines
16 KiB
<?xml version="1.0" encoding="utf-8"?><!--*- nxml -*-->
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
|
<head>
|
|
<meta name="generator" content=
|
|
"HTML Tidy for Linux/x86 (vers 12 April 2005), see www.w3.org" />
|
|
<meta http-equiv="Content-Type" content=
|
|
"text/html; charset=utf-8" />
|
|
<title>SPARQL Protocol for RDF Using WSDL 1.1</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; }
|
|
|
|
.diff-chg { background-color: yellow; }
|
|
.diff-del { background-color: red; text-decoration: line-through;}
|
|
.diff-add { background-color: lime; }
|
|
|
|
table { empty-cells: show; }
|
|
|
|
table caption {
|
|
font-weight: normal;
|
|
font-style: italic;
|
|
text-align: left;
|
|
margin-bottom: .5em;
|
|
}
|
|
|
|
div.issue {
|
|
color: red;
|
|
}
|
|
|
|
div.exampleInner pre { margin-left: 1em;
|
|
margin-top: 0em; margin-bottom: 0em}
|
|
div.exampleOuter {border: 4px double gray;
|
|
margin: 0em; padding: 0em}
|
|
div.exampleInner { background-color: #d5dee3;
|
|
border-top-width: 4px;
|
|
border-top-style: double;
|
|
border-top-color: #d3d3d3;
|
|
border-bottom-width: 4px;
|
|
border-bottom-style: double;
|
|
border-bottom-color: #d3d3d3;
|
|
padding: 4px; margin: 0em }
|
|
div.exampleWrapper { margin: 4px }
|
|
div.exampleHeader { font-weight: bold;
|
|
margin: 4px}
|
|
/*]]>*/
|
|
</style>
|
|
<link rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-WD" />
|
|
<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>SPARQL Protocol for RDF Using WSDL 1.1</h1>
|
|
<h2 id="h2-title">W3C Working Draft 24 October 2005</h2>
|
|
<dl>
|
|
<dt id="dt-this-version">This version:</dt>
|
|
<dd><a
|
|
href="http://www.w3.org/TR/2005/WD-sprot11-20051024/">http://www.w3.org/TR/2005/WD-sprot11-20051024/</a></dd>
|
|
<dt>Latest version:</dt>
|
|
<dd><a
|
|
href="http://www.w3.org/TR/sprot11/">http://www.w3.org/TR/sprot11/</a></dd>
|
|
<dt>Editors:</dt>
|
|
<dd><a href="mailto:feigenbl@us.ibm.com">Lee Feigenbaum</a>, IBM</dd>
|
|
<dd><a href="mailto:andy.seaborne@hp.com">Andy Seaborne</a>, Hewlett-Packard Laboratories</dd>
|
|
<dd><a href="mailto:eliast@us.ibm.com">Elias Torres</a>, IBM</dd>
|
|
</dl>
|
|
<!--<p>This document is also available in these non-normative formats:
|
|
<a href="other-format.other">Other</a>.</p>-->
|
|
<p class="copyright"><a href=
|
|
"http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>© 2005 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup>
|
|
(<a href="http://www.csail.mit.edu/"><acronym title=
|
|
"Massachusetts Institute of Technology">MIT</acronym></a>, <a href=
|
|
"http://www.ercim.org/"><acronym title=
|
|
"European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
|
|
<a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved.
|
|
W3C <a href=
|
|
"http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
|
|
<a href=
|
|
"http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
|
|
and <a href=
|
|
"http://www.w3.org/Consortium/Legal/copyright-documents">document
|
|
use</a> rules apply.</p>
|
|
</div>
|
|
<hr />
|
|
<div>
|
|
<h2><a name="abstract" id="abstract">Abstract</a></h2>
|
|
<p>The RDF Data Access Working Group normatively defines
|
|
the SPARQL Protocol for RDF via a Web Services Description
|
|
Language version 2.0 (WSDL 2.0) definition. This
|
|
document presents a non-normative WSDL 1.1 document defining
|
|
the same protocol.</p>
|
|
</div>
|
|
<div>
|
|
<h2><a name="status" id="status">Status of this Document</a></h2>
|
|
<p><em>This section describes the status of this document at the
|
|
time of its publication. Other documents may supersede this
|
|
document. A list of current W3C publications and the latest
|
|
revision of this technical report can be found in the <a href=
|
|
"http://www.w3.org/TR/">W3C technical reports index</a> at
|
|
http://www.w3.org/TR/.</em></p>
|
|
|
|
<p>In order to gain implementation experience with the SOAP bindings
|
|
for the SPARQL protocol while WSDL 2.0 tools are not yet widely
|
|
available, members of the <a href=
|
|
"http://www.w3.org/2001/sw/DataAccess/">RDF Data Access Working
|
|
Group</a> have developed a non-normative WSDL 1.1 analog to the
|
|
normative WSDL 2.0 specification of the SPARQL protocol. We have also
|
|
seeded a community-writeable <a
|
|
href="http://esw.w3.org/topic/SparqlProtocolWsdl11Examples">wiki topic
|
|
on code examples and techniques and such</a>.</p>
|
|
|
|
<p>The target status for this document Working Group Note. Until this
|
|
document is updated to Working Group Note status, time, the RDF Data
|
|
Access Working Group invites comments to <a
|
|
href="mailto:public-rdf-dawg-comments@w3.org">public-rdf-dawg-comments@w3.org</a>
|
|
(a mailing list with <a href=
|
|
"http://lists.w3.org/Archives/Public/public-rdf-dawg-comments/">public
|
|
archive</a>) and intends to respond to them on a best-effort
|
|
basis.</p>
|
|
|
|
<p>This is a First Public Working Draft. The <a href=
|
|
"http://www.w3.org/2001/sw/DataAccess/">RDF Data Access
|
|
Working Group</a> is part of the <a href=
|
|
"http://www.w3.org/2001/sw/">W3C Semantic Web Activity</a>.</p>
|
|
<p>
|
|
<em>This document was produced under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
|
|
February 2004 W3C Patent Policy</a>. The Working Group
|
|
maintains a <a rel="disclosure" href="http://www.w3.org/2004/01/pp-impl/35463/status">public
|
|
list of patent disclosures</a> relevant to this document;
|
|
that page also includes instructions for disclosing [and
|
|
excluding] a patent. An individual who has actual
|
|
knowledge of a patent which the individual believes
|
|
contains Essential Claim(s) with respect to this
|
|
specification should disclose the information in
|
|
accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">
|
|
|
|
section 6 of the W3C Patent Policy</a>.</em>
|
|
</p>
|
|
|
|
<p><em>Per <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Exclusion">section
|
|
4 of the W3C Patent Policy</a>, Working Group participants have
|
|
150 days from the title page date of this document to exclude
|
|
essential claims from the W3C RF licensing requirements with
|
|
respect to this document series. Exclusions are with respect to
|
|
the exclusion reference document, defined by the W3C Patent Policy
|
|
to be the latest version of a document in this series that is
|
|
published no later than 90 days after the title page date of this
|
|
document.</em></p>
|
|
|
|
<p><em>Publication as a Working Draft does not imply endorsement by
|
|
the W3C Membership. This is a draft document and may be updated,
|
|
replaced or obsoleted by other documents at any time. It is
|
|
inappropriate to cite this document as other than work in
|
|
progress.</em></p>
|
|
|
|
</div>
|
|
<hr />
|
|
<div class="toc">
|
|
<h2><a name="contents" id="contents">Table of Contents</a></h2>
|
|
<ol>
|
|
<li><a href="#intro">Introduction</a></li>
|
|
<li><a href="#wsdl11">WSDL 1.1 for SPARQL Protocol for RDF</a></li>
|
|
<li><a href="#examples">Using the WSDL 1.1</a></li>
|
|
</ol>
|
|
<h3><a name="appendix" id="appendix">Appendices</a></h3>
|
|
<ol style="list-style-type: upper-alpha">
|
|
<li><a href="#References">References</a></li>
|
|
<li><a href="#acknowledgments">Acknowledgements</a></li>
|
|
</ol>
|
|
</div>
|
|
<hr />
|
|
<div class="body">
|
|
<div class="div1">
|
|
<h2><a name="intro" id="intro"></a>1. Introduction</h2>
|
|
<p>The <a href="http://www.w3.org/TR/rdf-sparql-protocol/">SPARQL
|
|
Protocol for RDF</a> [<a href="#ref-sparql-prot">SPARQL-PROT</a>] is described abstractly via a <a
|
|
href="http://www.w3.org/TR/wsdl20/">WSDL 2.0</a> [<a
|
|
href="#ref-wsdl20">WSDL20</a>] document that
|
|
defines the relevant interface, types, faults, and operations, along
|
|
with HTTP and SOAP bindings. However, as of the time of the
|
|
publication of this Note, most Web Services toolkits that are
|
|
WSDL-aware produce and/or consume only <a
|
|
href="http://www.w3.org/TR/wsdl">WSDL 1.1</a> [<a
|
|
href="#ref-wsdl11">WSDL11</a>]. The <a
|
|
href="http://www.w3.org/2001/sw/DataAccess/">RDF Data Access Working
|
|
Group</a> has decided therefore to publish this supplementary Note
|
|
presenting a WSDL 1.1 version of the SPARQL Protocol. It is the
|
|
intention of the Working Group that the interfaces, types, faults, and
|
|
operations defined non-normatively in this WSDL 1.1 document are equivalent to
|
|
those normatively defined in WSDL 2.0 by the SPARQL Protocol. In
|
|
particular, it is intended that clients and endpoints based either on
|
|
the WSDL 2.0 definition or the WSDL 1.1 definition contained herein
|
|
should interoperate.</p>
|
|
<p>While the WSDL 2.0 definition of the SPARQL Protocol includes bindings
|
|
for both SOAP-over-HTTP and also for HTTP GET and POST, this WSDL 1.1
|
|
document mirrors only the SOAP-over-HTTP bindings. It is the experience of
|
|
the authors of this Note that toolkits which consume WSDL 1.1 documents do
|
|
not make use of non-SOAP bindings.</p>
|
|
</div>
|
|
<div class="div1">
|
|
<h2><a name="wsdl11" id="wsdl11"></a>2. WSDL 1.1 for SPARQL Protocol
|
|
for RDF</h2>
|
|
<p>The WSDL 1.1 document is included here and can also be
|
|
<a href="sparql-protocol-query-11.wsdl">downloaded</a>.</p>
|
|
<div class="excerpt"><pre>
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<wsdl:definitions
|
|
targetNamespace="http://www.w3.org/2005/08/sparql-protocol-query/#"
|
|
xmlns:tns="http://www.w3.org/2005/08/sparql-protocol-query/#"
|
|
|
|
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
|
|
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
|
|
|
|
xmlns:st="http://www.w3.org/2005/09/sparql-protocol-types/#"
|
|
|
|
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
|
|
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
|
|
|
|
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
|
|
|
schemaLocation="http://www.w3.org/2004/08/wsdl"
|
|
>
|
|
|
|
<wsdl:types>
|
|
<xs:schema targetNamespace="http://www.w3.org/2005/08/sparql-protocol-query/#">
|
|
<xs:import namespace="http://www.w3.org/2005/09/sparql-protocol-types/#"
|
|
schemaLocation="http://www.w3.org/2001/sw/DataAccess/proto-wd/sparql-protocol-types.xsd" />
|
|
</xs:schema>
|
|
</wsdl:types>
|
|
|
|
<wsdl:message name="queryRequest">
|
|
<wsdl:part name="query" element="st:query-request"/>
|
|
</wsdl:message>
|
|
|
|
<wsdl:message name="queryResponse">
|
|
<wsdl:part name="response" element="st:query-result"/>
|
|
</wsdl:message>
|
|
|
|
<wsdl:message name="malformedQueryFault">
|
|
<wsdl:part name="malformedQueryFaultPart" element="st:malformed-query"/>
|
|
</wsdl:message>
|
|
|
|
<wsdl:message name="queryRequestRefusedFault">
|
|
<wsdl:part name="queryRequestRefusedFaultPart" element="st:query-request-refused"/>
|
|
</wsdl:message>
|
|
|
|
<wsdl:portType name="SparqlQueryInterface">
|
|
<wsdl:operation name="query">
|
|
<wsdl:input message="tns:queryRequest"/>
|
|
<wsdl:output message="tns:queryResponse"/>
|
|
<wsdl:fault message="tns:malformedQueryFault" name="malformedQueryFault" />
|
|
<wsdl:fault message="tns:queryRequestRefusedFault" name="queryRequestRefusedFault" />
|
|
</wsdl:operation>
|
|
</wsdl:portType>
|
|
|
|
<wsdl:binding name="QuerySoapBinding" type="tns:SparqlQueryInterface">
|
|
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
|
|
<wsdl:operation name="query">
|
|
<soap:operation style="document" />
|
|
<wsdl:input>
|
|
<soap:body use="literal"/>
|
|
</wsdl:input>
|
|
<wsdl:output>
|
|
<soap:body use="literal"/>
|
|
</wsdl:output>
|
|
<wsdl:fault name="malformedQueryFault">
|
|
<soap:fault use="literal"/>
|
|
</wsdl:fault>
|
|
<wsdl:fault name="queryRequestRefusedFault">
|
|
<soap:fault use="literal"/>
|
|
</wsdl:fault>
|
|
</wsdl:operation>
|
|
</wsdl:binding>
|
|
</wsdl:definitions>
|
|
</pre></div>
|
|
</div>
|
|
|
|
<div class="div1">
|
|
<h2><a name="examples" id="examples"></a>3. Using the WSDL 1.1</h2>
|
|
<p>The Working Group has chosen to use a Wiki page to share and
|
|
develop <a
|
|
href="http://esw.w3.org/topic/SparqlProtocolWsdl11Examples">code
|
|
examples</a> [<a href="#ref-wsdl11-wiki">WSDL11-WIKI</a>] of using the WSDL 1.1 to implement the SPARQL
|
|
Protocol for RDF, either as a service endpoint or as a client. </p>
|
|
</div>
|
|
</div>
|
|
<div class="back">
|
|
<div class="div1">
|
|
<h2><a name="References" id="References"></a>A. References</h2>
|
|
<dl>
|
|
<dt class="label"><a name="ref-sparql-prot"
|
|
id="ref-sparql-prot"></a>[SPARQL-PROT]</dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/rdf-sparql-protocol/">SPARQL
|
|
Protocol for RDF</a></cite>, K. Clark, Editor, W3C Working Draft (work in
|
|
progress), 27 May 2005. This document is
|
|
http://www.w3.org/TR/rdf-sparql-protocol/ . The latest version is
|
|
available at http://www.w3.org/TR/rdf-sparql-protocol/ .</dd>
|
|
|
|
<dt class="label"><a name="ref-wsdl20" id="ref-wsdl20">[WSDL20]</a></dt>
|
|
<dd><cite>
|
|
<a href="http://www.w3.org/TR/2005/WD-wsdl20-20050510">Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language</a></cite>, J. Moreau, A. Ryman, R. Chinnici, S. Weerawarana, Editors, W3C Working Draft (work in progress), 10 May 2005, http://www.w3.org/TR/2005/WD-wsdl20-20050510 . <a href="http://www.w3.org/TR/wsdl20" title="Latest version of Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language">Latest version</a> available at http://www.w3.org/TR/wsdl20 .</dd>
|
|
|
|
<dt class="label"><a name="ref-wsdl11" id="ref-wsdl11">[WSDL11]</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/wsdl">Web Services Description
|
|
Language (WSDL) 1.1</a></cite>, E. Christensen, F. Curbera, G.
|
|
Meredith, S. Weerawarana, Authors, W3C Note, 15 March 2001,
|
|
http://www.w3.org/TR/wsdl .</dd>
|
|
|
|
<dt class="label"><a name="ref-wsdl11-wiki"
|
|
id="ref-wsdl11-wiki"></a>[WSDL11-WIKI]</dt>
|
|
<dd><cite><a
|
|
href="http://esw.w3.org/topic/SparqlProtocolWsdl11Examples">SPARQL
|
|
Protocol WSDL 1.1 Examples</a></cite>,
|
|
L. Feigenbaum, A. Seaborne, E. Torres, Original Authors, W3C ESW Wiki
|
|
page (work in progress). The W3C ESW Wiki homepage can be found at
|
|
http://esw.w3.org/topic/FrontPage .</dd>
|
|
|
|
</dl>
|
|
</div>
|
|
<div class="div1">
|
|
<h2><a name="acknowledgments" id="acknowledgments"></a>B.
|
|
Acknowledgements</h2>
|
|
<p>This document is the work of the <a
|
|
href="http://www.w3.org/2001/sw/DataAccess/">RDF Data Access Working
|
|
Group</a>.</p>
|
|
<p>Members of the Working Group are (at the time of writing, and by
|
|
alphabetical order):
|
|
|
|
Dave Beckett (University of Bristol), Jeen Broekstra, Kendall Clark
|
|
(Maryland Information and Network Dynamics Lab at the University of
|
|
Maryland), Dirk Colaert (Agfa-Gevaert N. V.), Dan Connolly (W3C),
|
|
Souripriya Das (Oracle Corporation), Jos De Roo (Agfa-Gevaert N. V.),
|
|
Lee Feigenbaum (IBM Corporation), Enrico Franconi (Free University of
|
|
Bozen-Bolzano), Yoshio Fukushige (Matsushita Electric Industrial Co.,
|
|
Ltd. (MEI)), Stephen Harris (University of Southampton), Pat Hayes,
|
|
Howard Katz, Farrukh Najmi (Sun Microsystems, Inc.), Bijan Parsia
|
|
(Maryland Information and Network Dynamics Lab at the University of
|
|
Maryland), Eric Prud'hommeaux (W3C), Alberto Reggiori (Asemantics
|
|
S.R.L.), Janne Saarela (Profium Ltd.), Hiroyuki Sato (Nippon Telegraph
|
|
& Telephone Corp. (NTT)), Andy Seaborne (Hewlett Packard Company),
|
|
Bryan Thompson (Hicks & Associates, Inc.), Elias Torres (IBM
|
|
Corporation), Dirk-Willem van Gulik (Asemantics S.R.L.), Timo
|
|
Westkämper (Profium Ltd.), Kevin Wilkinson (Hewlett Packard Company),
|
|
Rachel Yager (FSTC (Financial Services Technology Consortium)).</p>
|
|
|
|
<p>Previous members were: Tom Adams (Tucana), Jeff Pollock (Network
|
|
Inference), Simon Raboczi (Tucana), Rob Shearer (Network
|
|
Inference).</p>
|
|
|
|
<p>The people who have contributed to <a href=
|
|
"http://lists.w3.org/Archives/Public/public-rdf-dawg-comments/">
|
|
public-rdf-dawg-comments@w3.org</a>
|
|
are also gratefully acknowledged.</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|