index.html 15.8 KB

Raw Blame History Permalink

<?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>&#169; 2005 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>&#174;</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>
&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;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"
     >

  &lt;wsdl:types>
    &lt;xs:schema targetNamespace="http://www.w3.org/2005/08/sparql-protocol-query/#">
      &lt;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" />
    &lt;/xs:schema>
  &lt;/wsdl:types>

  &lt;wsdl:message name="queryRequest">
    &lt;wsdl:part name="query" element="st:query-request"/>
  &lt;/wsdl:message>

  &lt;wsdl:message name="queryResponse">
    &lt;wsdl:part name="response" element="st:query-result"/>
  &lt;/wsdl:message>

  &lt;wsdl:message name="malformedQueryFault">
      &lt;wsdl:part name="malformedQueryFaultPart" element="st:malformed-query"/>
  &lt;/wsdl:message>

  &lt;wsdl:message name="queryRequestRefusedFault">
      &lt;wsdl:part name="queryRequestRefusedFaultPart" element="st:query-request-refused"/>
  &lt;/wsdl:message>

  &lt;wsdl:portType name="SparqlQueryInterface">
    &lt;wsdl:operation name="query">
      &lt;wsdl:input  message="tns:queryRequest"/>
      &lt;wsdl:output message="tns:queryResponse"/>
      &lt;wsdl:fault  message="tns:malformedQueryFault"  name="malformedQueryFault" />
      &lt;wsdl:fault  message="tns:queryRequestRefusedFault" name="queryRequestRefusedFault" />
    &lt;/wsdl:operation>
  &lt;/wsdl:portType>

  &lt;wsdl:binding name="QuerySoapBinding" type="tns:SparqlQueryInterface">
    &lt;soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    &lt;wsdl:operation name="query">
      &lt;soap:operation style="document" />
      &lt;wsdl:input>
        &lt;soap:body use="literal"/>
      &lt;/wsdl:input>
      &lt;wsdl:output>
        &lt;soap:body use="literal"/>
      &lt;/wsdl:output>
      &lt;wsdl:fault name="malformedQueryFault">
        &lt;soap:fault use="literal"/>
      &lt;/wsdl:fault>
      &lt;wsdl:fault name="queryRequestRefusedFault">
        &lt;soap:fault use="literal"/>
      &lt;/wsdl:fault>
    &lt;/wsdl:operation>
  &lt;/wsdl:binding>
&lt;/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
&amp; Telephone Corp. (NTT)), Andy Seaborne (Hewlett Packard Company),
Bryan Thompson (Hicks &amp; Associates, Inc.), Elias Torres (IBM
Corporation), Dirk-Willem van Gulik (Asemantics S.R.L.), Timo
Westk&auml;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>