You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by bu...@apache.org on 2013/03/28 19:11:36 UTC
svn commit: r856352 - in /websites/staging/jena/trunk/content: ./
documentation/io/index.html documentation/io/rdf-input.html
documentation/io/rdf-output.html
Author: buildbot
Date: Thu Mar 28 18:11:36 2013
New Revision: 856352
Log:
Staging update by buildbot for jena
Modified:
websites/staging/jena/trunk/content/ (props changed)
websites/staging/jena/trunk/content/documentation/io/index.html
websites/staging/jena/trunk/content/documentation/io/rdf-input.html
websites/staging/jena/trunk/content/documentation/io/rdf-output.html
Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Mar 28 18:11:36 2013
@@ -1 +1 @@
-1462217
+1462241
Modified: websites/staging/jena/trunk/content/documentation/io/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/index.html Thu Mar 28 18:11:36 2013
@@ -21,7 +21,7 @@
<link href="/css/jena.css" rel="stylesheet" type="text/css">
- <title>Apache Jena - Reading and Writing RDF in Jena</title>
+ <title>Apache Jena - Reading and Writing RDF in Apache Jena</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js" type="text/javascript"></script>
<script src="/js/jena-navigation.js" type="text/javascript"></script>
@@ -155,14 +155,14 @@
</div>
<div id="content">
- <h1 class="title">Reading and Writing RDF in Jena</h1>
+ <h1 class="title">Reading and Writing RDF in Apache Jena</h1>
<p>This page details the setup of RDF I/O technology (RIOT).</p>
<ul>
<li><a href="#formats">Formats</a></li>
<li><a href="#command-line-tools">Commands</a></li>
<li><a href="rdf-input.html">Reading RDF in Jena</a></li>
-<li><a href="rdf-output.html">Writing RDf in Jena</a></li>
-<li><a href="rdfxml_howto.html">Working with RDF/XML parser</a></li>
+<li><a href="rdf-output.html">Writing RDF in Jena</a></li>
+<li><a href="rdfxml_howto.html">Additional details on working with RDF/XML</a></li>
</ul>
<h2 id="formats">Formats</h2>
<p>The following RDF formats are supported by Jena. In addition, other syntaxes
Modified: websites/staging/jena/trunk/content/documentation/io/rdf-input.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/rdf-input.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/rdf-input.html Thu Mar 28 18:11:36 2013
@@ -21,7 +21,7 @@
<link href="/css/jena.css" rel="stylesheet" type="text/css">
- <title>Apache Jena - Reading RDF in Jena</title>
+ <title>Apache Jena - Reading RDF in Apache Jena</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js" type="text/javascript"></script>
<script src="/js/jena-navigation.js" type="text/javascript"></script>
@@ -155,10 +155,10 @@
</div>
<div id="content">
- <h1 class="title">Reading RDF in Jena</h1>
+ <h1 class="title">Reading RDF in Apache Jena</h1>
<p>This page details the setup of RDF I/O technology (RIOT) for input
introduced in Jena 2.10.</p>
-<p>The output capabilities are described <a href="rdf-output.html">elsewhere</a>.</p>
+<p>See <a href="rdf-output.html">Writing RDF</a> for details of the RIOT Writer system.</p>
<ul>
<li><a href="#api">API</a><ul>
<li><a href="#determining-the-rdf-syntax">Determining the RDF syntax</a></li>
@@ -347,6 +347,7 @@ configuration file is necessary.</p>
<li>org.apache.jena.riot.stream.LocationMapper</li>
</ul>
<h2 id="advanced-examples">Advanced examples</h2>
+<p>Example code may be found in <a href="https://svn.apache.org/repos/asf/jena/trunk/jena-arq/src-examples/arq/examples/riot/">jena-arq/src-examples</a>.</p>
<h3 id="iterating-over-parser-output">Iterating over parser output</h3>
<p>One of the capabilities of the RIOT API is the ability to treat parser output as an iterator,
this is useful when you don't want to go to the trouble of writing a full sink implementation and can easily express your
Modified: websites/staging/jena/trunk/content/documentation/io/rdf-output.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/rdf-output.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/rdf-output.html Thu Mar 28 18:11:36 2013
@@ -156,13 +156,12 @@
<div id="content">
<h1 class="title">Writing RDF in Apache Jena</h1>
- <p>This page describes the RIOT (RDF I/O technology) output capabilities.</p>
-<p>See <a href="index.html">Reading RDF</a> for details of the RIOT Reader system.</p>
-<p>See <a href="rdfxml_howto.html#advanced-rdfxml-output">Advanced RDF/XML Output</a>
-for details of the Jena RDF/XML writer.</p>
+ <p>This page describes the RIOT (RDF I/O technology) output capabilities
+introduced in Jena 2.10.1.</p>
+<p>See <a href="rdf-input.html">Reading RDF</a> for details of the RIOT Reader system.</p>
<ul>
<li><a href="#API">API</a></li>
-<li><a href="#rdfformat">RDFFormat</a></li>
+<li><a href="#rdfformat"><code>RDFFormat</code></a></li>
<li><a href="#rdfformats-and-jena-syntax-names"><code>RDFFormat</code>s and Jena syntax names</a></li>
<li><a href="#formats">Formats</a></li>
<li><a href="#normal-printing">Normal Printing</a></li>
@@ -174,6 +173,8 @@ for details of the Jena RDF/XML writer.<
<li><a href="#examples">Examples</a></li>
<li><a href="#Notes">Notes</a></li>
</ul>
+<p>See <a href="rdfxml_howto.html#advanced-rdfxml-output">Advanced RDF/XML Output</a>
+for details of the Jena RDF/XML writer.</p>
<h2 id="api">API</h2>
<p>There are two ways to write RDF data using Apache Jena RIOT,
either via the <code>RDFDataMgr</code> </p>
@@ -524,7 +525,61 @@ while the jena writer writer name defaul
</tbody>
</table>
<h2 id="examples">Examples</h2>
-<p>@@TODO</p>
+<p>Example code may be found in <a href="https://svn.apache.org/repos/asf/jena/trunk/jena-arq/src-examples/arq/examples/riot/">jena-arq/src-examples</a>.</p>
+<h3 id="ways-to-write-a-model">Ways to write a model</h3>
+<p>The follow ways are different ways to write a model in Turtle:</p>
+<div class="codehilite"><pre> <span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="o">...</span> <span class="p">;</span>
+
+ <span class="sr">//</span> <span class="n">Write</span> <span class="n">a</span> <span class="n">model</span> <span class="n">in</span> <span class="n">Turtle</span> <span class="n">syntax</span><span class="p">,</span> <span class="n">default</span> <span class="n">style</span> <span class="p">(</span><span class="n">pretty</span> <span class="n">printed</span><span class="p">)</span>
+ <span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="n">model</span><span class="p">,</span> <span class="n">Lang</span><span class="o">.</span><span class="n">TURTLE</span><span class="p">)</span> <span class="p">;</span>
+
+ <span class="sr">//</span> <span class="n">Wriet</span> <span class="n">Turtle</span> <span class="n">to</span> <span class="n">the</span> <span class="n">blocks</span> <span class="n">variant</span>
+ <span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="n">model</span><span class="p">,</span> <span class="n">RDFFormat</span><span class="o">.</span><span class="n">TURTLE_BLOCKS</span><span class="p">)</span> <span class="p">;</span>
+
+ <span class="sr">//</span> <span class="n">Write</span> <span class="n">as</span> <span class="n">Turtle</span> <span class="n">via</span> <span class="n">model</span><span class="o">.</span><span class="nb">write</span>
+ <span class="n">model</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="s">"TTL"</span><span class="p">)</span> <span class="p">;</span>
+</pre></div>
+
+
+<h3 id="ways-to-write-a-dataset">Ways to write a dataset</h3>
+<p>The prefered style is to use <code>RDFDataMgr</code>:</p>
+<div class="codehilite"><pre><span class="n">Dataset</span> <span class="n">ds</span> <span class="o">=</span> <span class="o">....</span> <span class="p">;</span>
+<span class="sr">//</span> <span class="n">Write</span> <span class="n">as</span> <span class="n">TriG</span>
+<span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="n">ds</span><span class="p">,</span> <span class="n">Lang</span><span class="o">.</span><span class="n">TRIG</span><span class="p">)</span> <span class="p">;</span>
+
+<span class="sr">//</span> <span class="n">Write</span> <span class="n">as</span> <span class="n">N</span><span class="o">-</span><span class="n">Quads</span>
+<span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="n">dataset</span><span class="p">,</span> <span class="n">Lang</span><span class="o">.</span><span class="n">NQUADS</span><span class="p">)</span> <span class="p">;</span>
+</pre></div>
+
+
+<p>Additionaly, a single model can be written in a dataset format - it becomes
+the default graph of the dataset.</p>
+<div class="codehilite"><pre><span class="n">Model</span> <span class="n">m</span> <span class="o">=</span>
+<span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">write</span><span class="p">(</span><span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="p">,</span> <span class="n">m</span><span class="p">,</span> <span class="n">Lang</span><span class="o">.</span><span class="n">TRIG</span><span class="p">)</span> <span class="p">;</span>
+</pre></div>
+
+
+<p>might give:</p>
+<div class="codehilite"><pre><span class="nv">@prefix</span> <span class="p">:</span> <span class="sr"><http://example/></span> <span class="o">.</span>
+<span class="nv">@prefix</span> <span class="n">dc:</span> <span class="sr"><http://purl.org/dc/elements/1.1/></span> <span class="o">.</span>
+<span class="nv">@prefix</span> <span class="n">foaf:</span> <span class="sr"><http://xmlns.com/foaf/0.1/></span> <span class="o">.</span>
+<span class="nv">@prefix</span> <span class="n">rdf:</span> <span class="sr"><http://www.w3.org/1999/02/22-rdf-syntax-ns#></span> <span class="o">.</span>
+
+<span class="p">{</span>
+ <span class="p">:</span><span class="n">book</span> <span class="n">dc:author</span> <span class="p">(</span> <span class="p">:</span><span class="n">a</span> <span class="p">:</span><span class="n">b</span> <span class="p">)</span> <span class="o">.</span>
+
+ <span class="p">:</span><span class="n">a</span> <span class="n">a</span> <span class="n">foaf:Person</span> <span class="p">;</span>
+ <span class="n">foaf:knows</span> <span class="p">[</span> <span class="n">foaf:name</span> <span class="s">"Bob"</span> <span class="p">]</span> <span class="p">;</span>
+ <span class="n">foaf:name</span> <span class="s">"Alice"</span> <span class="o">.</span>
+
+ <span class="p">:</span><span class="n">b</span> <span class="n">foaf:knows</span> <span class="p">:</span><span class="n">a</span> <span class="o">.</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<h3 id="adding-a-new-output-format">Adding a new output format</h3>
+<p>An complete example of adding a new output format is given in the example file:
+<a href="https://svn.apache.org/repos/asf/jena/trunk/jena-arq/src-examples/arq/examples/riot/ExRIOT_out3.java">RIOT Output example 3</a></p>
<h2 id="notes">Notes</h2>
<p>Using <code>OutputStream</code>s is strongly encouraged. This allows the writers
to manage the character encoding using UTF-8. Using <code>java.io.Writer</code>