You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by ij...@apache.org on 2012/01/11 18:02:23 UTC
svn commit: r802389 - in /websites/production/jena: ./
content/jena/documentation/serving_data/index.html
Author: ijd
Date: Wed Jan 11 17:02:23 2012
New Revision: 802389
Log:
Push user-contributed tweaks to documentation
Modified:
websites/production/jena/ (props changed)
websites/production/jena/content/jena/documentation/serving_data/index.html
Propchange: websites/production/jena/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Wed Jan 11 17:02:23 2012
@@ -1 +1 @@
-/websites/staging/jena/trunk:782833-801713
+/websites/staging/jena/trunk:782833-802388
Modified: websites/production/jena/content/jena/documentation/serving_data/index.html
==============================================================================
--- websites/production/jena/content/jena/documentation/serving_data/index.html (original)
+++ websites/production/jena/content/jena/documentation/serving_data/index.html Wed Jan 11 17:02:23 2012
@@ -155,9 +155,8 @@
<div id="content">
<h1 class="title">Fuseki: serving RDF data over HTTP</h1>
- <p>Fuseki is a SPARQL server. It provides the REST-style SPARQL HTTP
-Update, and SPARQL Query and SPARQL Update using the SPARQL
-protocol over HTTP.</p>
+ <p>Fuseki is a SPARQL server. It provides REST-style SPARQL HTTP Update, SPARQL Query,
+and SPARQL Update using the SPARQL protocol over HTTP.</p>
<p>The relevant SPARQL standards are:</p>
<ul>
<li><a href="http://www.w3.org/TR/sparql11-query/" title="http://www.w3.org/TR/sparql11-query/">SPARQL 1.1 Query</a></li>
@@ -165,8 +164,8 @@ protocol over HTTP.</p>
<li><a href="http://www.w3.org/TR/sparql11-protocol/" title="http://www.w3.org/TR/sparql11-protocol/">SPARQL 1.1 Protocol</a></li>
<li><a href="http://www.w3.org/TR/sparql11-http-rdf-update/" title="http://www.w3.org/TR/sparql11-http-rdf-update/">SPARQL 1.1 Graph Store HTTP Protocol</a></li>
</ul>
-<p>These are work-in-progress by the SPARQL working group and while
-the general designs are stable, details may change. Fuseki will
+<p>These are work-in-progress by the SPARQL working group;
+although the general designs are stable, details may change. Fuseki will
track the draft standards.</p>
<p>See also:</p>
<ul>
@@ -186,20 +185,38 @@ track the draft standards.</p>
<li><a href="#development_system">Development System</a></li>
</ul>
<h2 id="download">Download</h2>
-<p><strong>Note</strong> builds will be migrating to the Apache infrastructure very soon. See the
-<a href="/jena/downloads">downloads page</a> for details.</p>
-<p>Builds are available from the
-<a href="http://openjena.org/repo/org/openjena/fuseki/">Jena Maven repository</a>
-and also the
-<a href="http://openjena.org/repo-dev/org/openjena/fuseki/">development repository</a>.</p>
+<p>Jena builds are in the process of migrating to Apache.
+See the <a href="/jena/downloads">downloads page</a> for details.
+Fuseki builds will be migrating to the Apache infrastructure very soon.
+Snapshot builds are
+available via Apache Maven or can be <a href="https://repository.apache.org/content/repositories/snapshots/org/apache/jena/jena-fuseki/">downloaded from here</a>.</p>
<p>Choose the version directory then look for the file
-fuseki-<em>VER</em>.zip. <em>VER</em> for a snapshot includes the timestamp and
-increment number as generated by maven.</p>
-<p>Fuseki download files</p>
-<p>Filename | Description
-fuseki-<em>VER</em>.zip | Fuseki download, includes everything.
-fuseki-<em>VER</em>-server.jar |Fuseki server, as an executable jar.
-fuseki-<em>VER</em>-SOH.zip | <a href="soh.html" title="SOH">SOH (SPARQL Over HTTP)</a> scripts</p>
+fuseki-<em>VER</em>.zip. For snapshots, <code>VER</code> includes the timestamp and increment
+number as generated by Maven. The most recent build at the time of writing
+(January 2012) is Fuseki 0.21-SNAPSHOT.</p>
+<p><strong>Fuseki download files</strong></p>
+<table>
+<thead>
+<tr>
+<th>Filename</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>fuseki-*VER*.distribution.zip</code></td>
+<td>Fuseki download, includes everything.</td>
+</tr>
+<tr>
+<td><code>fuseki-*VER*-server.jar</code></td>
+<td>Fuseki server, as an executable jar.</td>
+</tr>
+<tr>
+<td><code>fuseki-*VER*-SOH.zip</code></td>
+<td><a href="soh.html" title="SOH">SOH (SPARQL Over HTTP)</a> scripts</td>
+</tr>
+</tbody>
+</table>
<p>Fuseki requires Java6.</p>
<h2 id="getting_started">Getting Started</h2>
<p>This section provides a brief guide to getting up and running with
@@ -228,7 +245,7 @@ download.</p>
<h2 id="user_interface">User Interface</h2>
<p>The Fuseki download includes a number of services:</p>
<ul>
-<li>SPARQL Query, SPARQL Update and file upload to a selected
+<li>SPARQL Query, SPARQL Update, and file upload to a selected
dataset.</li>
<li>Link to the documentation (here).</li>
<li>Validators for SPARQL query and update and for non-RDF/XML
@@ -239,7 +256,7 @@ download.</p>
<li>In a browser, go to
<a href="http://localhost:3030/" title="http://localhost:3030/">http://localhost:3030/</a></li>
<li>Click on "Control Panel</li>
-<li>Select the dataset (if set up above there is only one choice).</li>
+<li>Select the dataset (if set up above, there is only one choice).</li>
</ol>
<p>The page offers SPARQL operations and file upload acting on the
selected dataset.</p>
@@ -336,32 +353,27 @@ accessible over HTTP.</p>
<p>The server will service read requests only unless the --update
argument is used.</p>
<p>The full choice of dataset forms is:</p>
-<p>Fuseki Dataset Descriptions
---mem
-Create an empty, in-memory (non-persistent) dataset.
---file=FILE
-Create an empty, in-memory (non-persistent) dataset, then load FILE
-into it.
---loc=DIR
-Use an existing TDB database. Create an empty one if it does not
-exist.
---desc=assemblerFile
-Construct a dataset based on the general assembler description.
---config=ConfigFile
-Construct one or more service endpoints based on the
-<a href="#Fuseki_Configuration_File">configuration description</a>.
-A copy of TDB is included in the standalone server. An example
+<p><strong>Fuseki Dataset Descriptions</strong></p>
+<ul>
+<li><code>--mem</code> <br /> Create an empty, in-memory (non-persistent) dataset.</li>
+<li><code>--file=FILE</code> <br />
+ Create an empty, in-memory (non-persistent) dataset, then load FILE
+ into it.</li>
+<li><code>--loc=DIR</code> <br />Use an existing TDB database. Create an empty one if it does not
+ exist.</li>
+<li><code>--desc=assemblerFile</code> <br /> Construct a dataset based on the general assembler description.</li>
+<li><code>--config=ConfigFile</code> <br /> Construct one or more service endpoints based on the
+ <a href="#Fuseki_Configuration_File">configuration description</a>.</li>
+</ul>
+<p>A copy of TDB is included in the standalone server. An example
assembler file for TDB is in tdb.ttl.</p>
-<p>Fuseki Server Arguments
---help
-Print help message.
---port=<em>number</em>
-Run on port <em>number</em> - default is 3030.
---host=<em>name</em>
-Listen only to a specific network interface.
---update
-Allow update. Otherwise only read requests are served (ignored if a
-configuration file is given).</p>
+<p><strong>Fuseki Server Arguments</strong></p>
+<ul>
+<li><code>--help</code> <br /> Print help message.</li>
+<li><code>--port=*number*</code> <br /> Run on port <em>number</em> - default is 3030.</li>
+<li><code>--host=*name*</code> <br /> Listen only to a specific network interface.</li>
+<li><code>--update</code> <br /> Allow update. Otherwise only read requests are served (ignored if a configuration file is given).</li>
+</ul>
<h2 id="security_and_access_control">Security and Access Control</h2>
<p>Fuseki does not offer any security and access control itself.
Authentication and control of the number of concurrent request can
@@ -376,21 +388,21 @@ PUR/POST/DELETE enabled).</p>
<p>runs the server on port 3030 with an in-memory dataset. It can be
-accessed via the appropriate protocol at URLs:</p>
+accessed via the appropriate protocol at the following URLs:</p>
<ul>
-<li>SPARQL query: http://localhost:3030/dataset/query</li>
-<li>SPARQL update: http://localhost:3030/dataset/update</li>
-<li>SPARQL HTTP update: http://localhost:3030/dataset/data</li>
+<li>SPARQL query: <code>http://localhost:3030/dataset/query</code></li>
+<li>SPARQL update: <code>http://localhost:3030/dataset/update</code></li>
+<li>SPARQL HTTP update: <code>http://localhost:3030/dataset/data</code></li>
</ul>
<p>The <a href="soh.html" title="SOH">SPARQL Over HTTP</a> scripts take care of naming
-and protocol details. For example, to load in a file data.rdf:</p>
+and protocol details. For example, to load in a file <code>data.rdf</code>:</p>
<div class="codehilite"><pre> <span class="n">s</span><span class="o">-</span><span class="n">put</span> <span class="n">http:</span><span class="sr">//</span><span class="n">localhost:3030</span><span class="sr">/dataset/</span><span class="n">data</span> <span class="n">default</span> <span class="n">data</span><span class="o">.</span><span class="n">rdf</span>
</pre></div>
<h2 id="fuseki_server_and_tdb">Fuseki Server and TDB</h2>
<p>Fuseki include a built-in version of TDB. Run the server with the
---desc argument</p>
+<code>--desc</code> argument</p>
<div class="codehilite"><pre><span class="n">fuseki</span><span class="o">-</span><span class="n">server</span> <span class="o">--</span><span class="n">desc</span> <span class="n">tdb</span><span class="o">.</span><span class="n">ttl</span> <span class="o">/</span><span class="n">dataset</span>
</pre></div>
@@ -481,7 +493,7 @@ split to allow for commentary.</p>
<h3 id="server_section">Server Section</h3>
<p>Order of the file does not matter to the machine, but it's useful
to start with the server description, then each of the services
-with it's datasets.</p>
+with its datasets.</p>
<div class="codehilite"><pre><span class="o">[]</span> <span class="n">rdf:type</span> <span class="n">fuseki:Server</span><span class="err">Â </span><span class="p">;</span>
<span class="c1"># Server-wide context parameters can be given here.</span>
<span class="c1"># For example, to set query timeouts: on a server-wide basis:</span>