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/06/20 12:18:36 UTC
svn commit: r866584 [2/21] - in /websites/staging/jena/trunk/content: ./
documentation/assembler/ documentation/inference/ documentation/io/
documentation/javadoc/arq/ documentation/javadoc/fuseki/
documentation/javadoc/jena/ documentation/javadoc/larq...
Modified: websites/staging/jena/trunk/content/documentation/assembler/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/assembler/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/assembler/index.html Thu Jun 20 10:18:34 2013
@@ -177,7 +177,7 @@ of model specification.</p>
<p>Suppose the Model <code>M</code> contains an Assembler specification whose
<em>root</em> - the Resource describing the whole Model to construct is
<code>R</code> (so <code>R.getModel() == M)</code>. Invoke:</p>
-<div class="codehilite"><pre><span class="n">Assembler</span><span class="o">.</span><span class="n">general</span><span class="o">.</span><span class="n">openModel</span><span class="p">(</span><span class="n">R</span><span class="p">)</span>
+<div class="codehilite"><pre><span class="n">Assembler</span><span class="p">.</span><span class="n">general</span><span class="p">.</span><span class="n">openModel</span><span class="p">(</span><span class="n">R</span><span class="p">)</span>
</pre></div>
@@ -189,15 +189,15 @@ details of specific Assemblers, are defe
<p>In the remaining sections, the object we want to describe is given
the root resource <code>my:root</code>.</p>
<h3 id="a-memory-model">... a memory model?</h3>
-<div class="codehilite"><pre><span class="err">my:root</span> <span class="err">a</span> <span class="err">ja:MemoryModel.</span>
+<div class="codehilite"><pre><span class="n">my</span><span class="o">:</span><span class="n">root</span> <span class="n">a</span> <span class="n">ja</span><span class="o">:</span><span class="n">MemoryModel</span><span class="o">.</span>
</pre></div>
<h3 id="an-inference-model">... an inference model?</h3>
-<div class="codehilite"><pre><span class="err">my:root</span>
- <span class="err">ja:reasoner</span> <span class="err">[ja:reasonerURL</span> <span class="err">theReasonerURL]</span> <span class="err">;</span>
- <span class="err">ja:baseModel</span> <span class="err">theBaseModelResource</span>
- <span class="err">.</span>
+<div class="codehilite"><pre><span class="n">my</span><span class="o">:</span><span class="n">root</span>
+ <span class="n">ja</span><span class="o">:</span><span class="n">reasoner</span> <span class="o">[</span><span class="n">ja</span><span class="o">:</span><span class="n">reasonerURL</span> <span class="n">theReasonerURL</span><span class="o">]</span> <span class="o">;</span>
+ <span class="n">ja</span><span class="o">:</span><span class="n">baseModel</span> <span class="n">theBaseModelResource</span>
+ <span class="o">.</span>
</pre></div>
@@ -205,19 +205,19 @@ the root resource <code>my:root</code>.<
inference documentation and code; <em>theBaseModelResource</em> is another
resource in the same document describing the base model.</p>
<h3 id="some-initialising-content">... some initialising content?</h3>
-<div class="codehilite"><pre><span class="err">my:root</span>
- <span class="err">ja:content</span> <span class="err">[ja:</span><span class="kd">extern</span><span class="err">alContent</span> <span class="err"><someContentURL>]</span>
- <span class="err">...</span> <span class="err">rest</span> <span class="err">of</span> <span class="err">model</span> <span class="err">specification</span> <span class="err">...</span>
- <span class="err">.</span>
+<div class="codehilite"><pre><span class="n">my</span><span class="o">:</span><span class="n">root</span>
+ <span class="n">ja</span><span class="o">:</span><span class="n">content</span> <span class="o">[</span><span class="n">ja</span><span class="o">:</span><span class="n">externalContent</span> <span class="o"><</span><span class="n">someContentURL</span><span class="o">>]</span>
+ <span class="o">...</span> <span class="n">rest</span> <span class="n">of</span> <span class="n">model</span> <span class="n">specification</span> <span class="o">...</span>
+ <span class="o">.</span>
</pre></div>
<p>The model will be pre-loaded with the contents of <em>someContentURL</em>.</p>
<h3 id="an-ontology-model">... an ontology model?</h3>
-<div class="codehilite"><pre><span class="err">my:root</span>
- <span class="err">ja:ontModelSpec</span> <span class="err">ja:OntModelSpecName</span> <span class="err">;</span>
- <span class="err">ja:baseModel</span> <span class="err">somebaseModel</span>
- <span class="err">.</span>
+<div class="codehilite"><pre><span class="n">my</span><span class="o">:</span><span class="n">root</span>
+ <span class="n">ja</span><span class="o">:</span><span class="n">ontModelSpec</span> <span class="n">ja</span><span class="o">:</span><span class="n">OntModelSpecName</span> <span class="o">;</span>
+ <span class="n">ja</span><span class="o">:</span><span class="n">baseModel</span> <span class="n">somebaseModel</span>
+ <span class="o">.</span>
</pre></div>
Modified: websites/staging/jena/trunk/content/documentation/assembler/inside-assemblers.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/assembler/inside-assemblers.html (original)
+++ websites/staging/jena/trunk/content/documentation/assembler/inside-assemblers.html Thu Jun 20 10:18:34 2013
@@ -165,11 +165,11 @@ writing assembler descriptions, see the
<h2 id="the-assembler-interface">The Assembler interface</h2>
<p>An <code>Assembler</code> is an object that builds objects (most importantly,
<code>Model</code>s) from RDF descriptions.</p>
-<div class="codehilite"><pre><span class="n">public</span> <span class="n">Object</span> <span class="nb">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span><span class="p">,</span> <span class="n">Mode</span> <span class="n">mode</span> <span class="p">);</span>
+<div class="codehilite"><pre><span class="n">public</span> <span class="n">Object</span> <span class="n">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span><span class="p">,</span> <span class="n">Mode</span> <span class="n">mode</span> <span class="p">);</span>
-<span class="n">public</span> <span class="n">Object</span> <span class="nb">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span> <span class="p">);</span>
+<span class="n">public</span> <span class="n">Object</span> <span class="n">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span> <span class="p">);</span>
-<span class="n">public</span> <span class="n">Object</span> <span class="nb">open</span><span class="p">(</span> <span class="n">Resource</span> <span class="n">root</span> <span class="p">);</span>
+<span class="n">public</span> <span class="n">Object</span> <span class="n">open</span><span class="p">(</span> <span class="n">Resource</span> <span class="n">root</span> <span class="p">);</span>
<span class="n">public</span> <span class="n">Model</span> <span class="n">openModel</span><span class="p">(</span> <span class="n">Resource</span> <span class="n">root</span> <span class="p">);</span>
@@ -275,33 +275,33 @@ MemoryModels or PrefixMappings ignore th
<p>(Temporary documentation pasted in from email; will be integrated
and made nice RSN.)</p>
<div class="codehilite"><pre><span class="n">You</span> <span class="n">have</span> <span class="n">to</span> <span class="n">implement</span> <span class="n">the</span> <span class="n">Assembler</span> <span class="n">interface</span><span class="p">,</span> <span class="n">most</span> <span class="n">straightforwardly</span>
-<span class="n">done</span> <span class="n">by</span> <span class="n">subclassing</span> <span class="n">AssemblerBase</span> <span class="ow">and</span> <span class="n">overriding</span>
+<span class="n">done</span> <span class="n">by</span> <span class="n">subclassing</span> <span class="n">AssemblerBase</span> <span class="n">and</span> <span class="n">overriding</span>
- <span class="n">public</span> <span class="n">Object</span> <span class="nb">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span><span class="p">,</span> <span class="n">Mode</span> <span class="n">mode</span> <span class="p">);</span>
+ <span class="n">public</span> <span class="n">Object</span> <span class="n">open</span><span class="p">(</span> <span class="n">Assembler</span> <span class="n">a</span><span class="p">,</span> <span class="n">Resource</span> <span class="n">root</span><span class="p">,</span> <span class="n">Mode</span> <span class="n">mode</span> <span class="p">);</span>
- <span class="n">because</span> <span class="n">AssemblerBase</span> <span class="n">both</span> <span class="n">implements</span> <span class="n">the</span> <span class="n">boring</span> <span class="n">methods</span> <span class="n">that</span> <span class="n">are</span>
- <span class="n">just</span> <span class="n">specialisations</span> <span class="n">of</span> <span class="sb">`open`</span> <span class="ow">and</span> <span class="n">provides</span> <span class="n">some</span> <span class="n">utility</span> <span class="n">methods</span>
- <span class="n">such</span> <span class="n">as</span> <span class="n">getting</span> <span class="n">the</span> <span class="nb">values</span> <span class="n">of</span> <span class="n">unique</span> <span class="n">properties</span><span class="o">.</span> <span class="n">The</span> <span class="n">arguments</span> <span class="n">are</span>
+ <span class="n">because</span> <span class="n">AssemblerBase</span> <span class="n">both</span> <span class="n">implements</span> <span class="n">the</span> <span class="n">boring</span> <span class="k">methods</span> <span class="n">that</span> <span class="n">are</span>
+ <span class="n">just</span> <span class="n">specialisations</span> <span class="n">of</span> `<span class="n">open</span>` <span class="n">and</span> <span class="n">provides</span> <span class="n">some</span> <span class="n">utility</span> <span class="k">methods</span>
+ <span class="n">such</span> <span class="n">as</span> <span class="n">getting</span> <span class="n">the</span> <span class="n">values</span> <span class="n">of</span> <span class="n">unique</span> <span class="k">properties</span><span class="p">.</span> <span class="n">The</span> <span class="n">arguments</span> <span class="n">are</span>
- <span class="o">*</span> <span class="n">a</span> <span class="o">--</span> <span class="n">the</span> <span class="n">assembler</span> <span class="n">to</span> <span class="k">use</span> <span class="k">for</span> <span class="n">any</span> <span class="n">sub</span><span class="o">-</span><span class="n">assemblies</span>
+ <span class="o">*</span> <span class="n">a</span> <span class="o">--</span> <span class="n">the</span> <span class="n">assembler</span> <span class="n">to</span> <span class="n">use</span> <span class="k">for</span> <span class="n">any</span> <span class="n">sub</span><span class="o">-</span><span class="n">assemblies</span>
<span class="o">*</span> <span class="n">root</span> <span class="o">--</span> <span class="n">the</span> <span class="n">resource</span> <span class="n">in</span> <span class="n">the</span> <span class="n">assembler</span> <span class="n">description</span> <span class="k">for</span> <span class="n">this</span> <span class="n">object</span>
- <span class="o">*</span> <span class="n">mode</span> <span class="o">--</span> <span class="n">the</span> <span class="n">persistent</span> <span class="nb">open</span> <span class="n">vs</span> <span class="n">create</span> <span class="n">mode</span>
+ <span class="o">*</span> <span class="n">mode</span> <span class="o">--</span> <span class="n">the</span> <span class="k">persistent</span> <span class="n">open</span> <span class="n">vs</span> <span class="n">create</span> <span class="n">mode</span>
- <span class="n">The</span> <span class="n">pattern</span> <span class="n">is</span> <span class="n">to</span> <span class="n">look</span> <span class="k">for</span> <span class="n">the</span> <span class="n">known</span> <span class="n">properties</span> <span class="n">of</span> <span class="n">the</span> <span class="n">root</span><span class="p">,</span> <span class="k">use</span>
- <span class="n">those</span> <span class="n">to</span> <span class="n">define</span> <span class="n">any</span> <span class="n">sub</span><span class="o">-</span><span class="n">objects</span> <span class="n">of</span> <span class="n">the</span> <span class="n">object</span> <span class="n">you</span><span class="s">'re assembling</span>
-<span class="s"> (including using `a` for anything that'</span><span class="n">s</span> <span class="n">itself</span> <span class="n">a</span> <span class="n">structured</span>
- <span class="n">object</span><span class="p">)</span> <span class="ow">and</span> <span class="k">then</span> <span class="n">constructing</span> <span class="n">a</span> <span class="k">new</span> <span class="n">result</span> <span class="n">object</span> <span class="n">from</span> <span class="n">those</span>
- <span class="n">components</span><span class="o">.</span>
-
- <span class="n">Then</span> <span class="n">you</span> <span class="n">attach</span> <span class="n">this</span> <span class="k">new</span> <span class="n">assembler</span> <span class="n">object</span> <span class="n">to</span> <span class="n">its</span> <span class="n">type</span> <span class="n">in</span> <span class="n">some</span>
- <span class="n">AssemblerGroup</span> <span class="n">using</span> <span class="n">that</span> <span class="n">group</span><span class="s">'s `implementWith` method. You</span>
-<span class="s"> can attach it to the handy-but-public-and-shared group</span>
-<span class="s"> `Assembler.general` or you can construct your own group. The</span>
-<span class="s"> point about an AssemblerGroup is that it does the type-to-assembler</span>
-<span class="s"> mapping for you -- and when an AssemblerGroup calls a component</span>
-<span class="s"> assembler'</span><span class="n">s</span> <span class="sb">`open`</span> <span class="n">method</span><span class="p">,</span> <span class="n">it</span> <span class="n">passes</span> <span class="sr">/itself/</span> <span class="n">in</span> <span class="n">as</span> <span class="n">the</span> <span class="sb">`a`</span> <span class="n">argument</span><span class="p">,</span>
+ <span class="n">The</span> <span class="n">pattern</span> <span class="n">is</span> <span class="n">to</span> <span class="n">look</span> <span class="k">for</span> <span class="n">the</span> <span class="n">known</span> <span class="k">properties</span> <span class="n">of</span> <span class="n">the</span> <span class="n">root</span><span class="p">,</span> <span class="n">use</span>
+ <span class="n">those</span> <span class="n">to</span> <span class="n">define</span> <span class="n">any</span> <span class="n">sub</span><span class="o">-</span><span class="n">objects</span> <span class="n">of</span> <span class="n">the</span> <span class="n">object</span> <span class="n">you</span><span class="o">'</span><span class="n">re</span> <span class="n">assembling</span>
+ <span class="p">(</span><span class="n">including</span> <span class="n">using</span> `<span class="n">a</span>` <span class="k">for</span> <span class="n">anything</span> <span class="n">that</span><span class="o">'</span><span class="n">s</span> <span class="n">itself</span> <span class="n">a</span> <span class="n">structured</span>
+ <span class="n">object</span><span class="p">)</span> <span class="n">and</span> <span class="n">then</span> <span class="n">constructing</span> <span class="n">a</span> <span class="n">new</span> <span class="n">result</span> <span class="n">object</span> <span class="n">from</span> <span class="n">those</span>
+ <span class="n">components</span><span class="p">.</span>
+
+ <span class="n">Then</span> <span class="n">you</span> <span class="n">attach</span> <span class="n">this</span> <span class="n">new</span> <span class="n">assembler</span> <span class="n">object</span> <span class="n">to</span> <span class="n">its</span> <span class="n">type</span> <span class="n">in</span> <span class="n">some</span>
+ <span class="n">AssemblerGroup</span> <span class="n">using</span> <span class="n">that</span> <span class="n">group</span><span class="o">'</span><span class="n">s</span> `<span class="n">implementWith</span>` <span class="n">method</span><span class="p">.</span> <span class="n">You</span>
+ <span class="n">can</span> <span class="n">attach</span> <span class="n">it</span> <span class="n">to</span> <span class="n">the</span> <span class="n">handy</span><span class="o">-</span><span class="n">but</span><span class="o">-</span><span class="n">public</span><span class="o">-</span><span class="n">and</span><span class="o">-</span><span class="n">shared</span> <span class="n">group</span>
+ `<span class="n">Assembler</span><span class="p">.</span><span class="n">general</span>` <span class="n">or</span> <span class="n">you</span> <span class="n">can</span> <span class="n">construct</span> <span class="n">your</span> <span class="n">own</span> <span class="n">group</span><span class="p">.</span> <span class="n">The</span>
+ <span class="n">point</span> <span class="n">about</span> <span class="n">an</span> <span class="n">AssemblerGroup</span> <span class="n">is</span> <span class="n">that</span> <span class="n">it</span> <span class="n">does</span> <span class="n">the</span> <span class="n">type</span><span class="o">-</span><span class="n">to</span><span class="o">-</span><span class="n">assembler</span>
+ <span class="n">mapping</span> <span class="k">for</span> <span class="n">you</span> <span class="o">--</span> <span class="n">and</span> <span class="n">when</span> <span class="n">an</span> <span class="n">AssemblerGroup</span> <span class="n">calls</span> <span class="n">a</span> <span class="n">component</span>
+ <span class="n">assembler</span><span class="o">'</span><span class="n">s</span> `<span class="n">open</span>` <span class="n">method</span><span class="p">,</span> <span class="n">it</span> <span class="n">passes</span> <span class="o">/</span><span class="n">itself</span><span class="o">/</span> <span class="n">in</span> <span class="n">as</span> <span class="n">the</span> `<span class="n">a</span>` <span class="n">argument</span><span class="p">,</span>
<span class="n">so</span> <span class="n">that</span> <span class="n">the</span> <span class="n">invoked</span> <span class="n">assembler</span> <span class="n">has</span> <span class="n">access</span> <span class="n">to</span> <span class="n">all</span> <span class="n">of</span> <span class="n">the</span> <span class="n">component</span>
- <span class="n">assemblers</span> <span class="n">of</span> <span class="n">the</span> <span class="n">Group</span><span class="o">.</span>
+ <span class="n">assemblers</span> <span class="n">of</span> <span class="n">the</span> <span class="n">Group</span><span class="p">.</span>
</pre></div>
Modified: websites/staging/jena/trunk/content/documentation/inference/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/inference/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/inference/index.html Thu Jun 20 10:18:34 2013
@@ -330,12 +330,12 @@
This could be done by writing an RDF/XML or N3 file and reading that in but
we have chosen to use the RDF API:</p>
<pre> String NS = "urn:x-hp-jena:eg/";</p>
-<div class="codehilite"><pre><span class="sr">//</span> <span class="n">Build</span> <span class="n">a</span> <span class="n">trivial</span> <span class="n">example</span> <span class="n">data</span> <span class="n">set</span>
-<span class="n">Model</span> <span class="n">rdfsExample</span> <span class="o">=</span> <span class="n">ModelFactory</span><span class="o">.</span><span class="n">createDefaultModel</span><span class="p">();</span>
-<span class="n">Property</span> <span class="n">p</span> <span class="o">=</span> <span class="n">rdfsExample</span><span class="o">.</span><span class="n">createProperty</span><span class="p">(</span><span class="n">NS</span><span class="p">,</span> <span class="s">"p"</span><span class="p">);</span>
-<span class="n">Property</span> <span class="sx">q = </span><span class="n">rdfsExample</span><span class="o">.</span><span class="n">createProperty</span><span class="p">(</span><span class="n">NS</span><span class="p">,</span> <span class="s">"q"</span><span class="p">);</span>
-<span class="n">rdfsExample</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">RDFS</span><span class="o">.</span><span class="n">subPropertyOf</span><span class="p">,</span> <span class="sx">q);</span>
-<span class="sx">rdfsExample.createResource(NS+"a")</span><span class="o">.</span><span class="n">addProperty</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">);</span>
+<div class="codehilite"><pre><span class="c1">// Build a trivial example data set</span>
+<span class="n">Model</span> <span class="n">rdfsExample</span> <span class="o">=</span> <span class="n">ModelFactory</span><span class="p">.</span><span class="n">createDefaultModel</span><span class="p">();</span>
+<span class="n">Property</span> <span class="n">p</span> <span class="o">=</span> <span class="n">rdfsExample</span><span class="p">.</span><span class="n">createProperty</span><span class="p">(</span><span class="no">NS</span><span class="p">,</span> <span class="s">"p"</span><span class="p">);</span>
+<span class="n">Property</span> <span class="n">q</span> <span class="o">=</span> <span class="n">rdfsExample</span><span class="p">.</span><span class="n">createProperty</span><span class="p">(</span><span class="no">NS</span><span class="p">,</span> <span class="s">"q"</span><span class="p">);</span>
+<span class="n">rdfsExample</span><span class="p">.</span><span class="n">add</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="no">RDFS</span><span class="p">.</span><span class="n">subPropertyOf</span><span class="p">,</span> <span class="n">q</span><span class="p">);</span>
+<span class="n">rdfsExample</span><span class="p">.</span><span class="n">createResource</span><span class="p">(</span><span class="no">NS</span><span class="o">+</span><span class="s">"a"</span><span class="p">).</span><span class="n">addProperty</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">);</span>
</pre></div>
Modified: websites/staging/jena/trunk/content/documentation/io/arp_sax.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/arp_sax.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/arp_sax.html Thu Jun 20 10:18:34 2013
@@ -192,33 +192,33 @@ handler.</p>
the triple to a
<a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/model/Model.html"><code>Model</code></a> using
default options.</p>
-<div class="codehilite"><pre><span class="sr">//</span> <span class="n">Use</span> <span class="n">your</span> <span class="n">own</span> <span class="n">SAX</span> <span class="n">source</span><span class="o">.</span>
+<div class="codehilite"><pre><span class="c1">// Use your own SAX source.</span>
<span class="n">XMLReader</span> <span class="n">saxParser</span> <span class="o">=</span> <span class="k">new</span> <span class="n">SAXParser</span><span class="p">();</span>
-<span class="sr">//</span> <span class="n">set</span> <span class="n">up</span> <span class="n">SAX</span> <span class="n">input</span>
+<span class="c1">// set up SAX input</span>
<span class="n">InputStream</span> <span class="n">in</span> <span class="o">=</span> <span class="k">new</span> <span class="n">FileInputStream</span><span class="p">(</span><span class="s">"kb.rdf"</span><span class="p">);</span>
<span class="n">InputSource</span> <span class="n">ins</span> <span class="o">=</span> <span class="k">new</span> <span class="n">InputSource</span><span class="p">(</span><span class="n">in</span><span class="p">);</span>
-<span class="n">ins</span><span class="o">.</span><span class="n">setSystemId</span><span class="p">(</span><span class="n">base</span><span class="p">);</span>
+<span class="n">ins</span><span class="p">.</span><span class="n">setSystemId</span><span class="p">(</span><span class="n">base</span><span class="p">);</span>
-<span class="n">Model</span> <span class="n">m</span> <span class="o">=</span> <span class="n">ModelFactory</span><span class="o">.</span><span class="n">createDefaultModel</span><span class="p">();</span>
+<span class="n">Model</span> <span class="n">m</span> <span class="o">=</span> <span class="n">ModelFactory</span><span class="p">.</span><span class="n">createDefaultModel</span><span class="p">();</span>
<span class="n">String</span> <span class="n">base</span> <span class="o">=</span> <span class="s">"http://example.org/"</span><span class="p">;</span>
-<span class="sr">//</span> <span class="n">create</span> <span class="n">handler</span><span class="p">,</span> <span class="n">linked</span> <span class="n">to</span> <span class="n">Model</span>
-<span class="n">SAX2Model</span> <span class="n">handler</span> <span class="o">=</span> <span class="n">SAX2Model</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">base</span><span class="p">,</span> <span class="n">m</span><span class="p">);</span>
+<span class="c1">// create handler, linked to Model</span>
+<span class="n">SAX2Model</span> <span class="n">handler</span> <span class="o">=</span> <span class="n">SAX2Model</span><span class="p">.</span><span class="n">create</span><span class="p">(</span><span class="n">base</span><span class="p">,</span> <span class="n">m</span><span class="p">);</span>
-<span class="sr">//</span> <span class="n">install</span> <span class="n">handler</span> <span class="n">on</span> <span class="n">SAX</span> <span class="n">event</span> <span class="n">stream</span>
-<span class="n">SAX2RDF</span><span class="o">.</span><span class="n">installHandlers</span><span class="p">(</span><span class="n">saxParser</span><span class="p">,</span> <span class="n">handler</span><span class="p">);</span>
+<span class="c1">// install handler on SAX event stream</span>
+<span class="no">SAX2RDF</span><span class="p">.</span><span class="n">installHandlers</span><span class="p">(</span><span class="n">saxParser</span><span class="p">,</span> <span class="n">handler</span><span class="p">);</span>
<span class="n">try</span> <span class="p">{</span>
<span class="n">try</span> <span class="p">{</span>
- <span class="n">saxParser</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">ins</span><span class="p">);</span>
+ <span class="n">saxParser</span><span class="p">.</span><span class="n">parse</span><span class="p">(</span><span class="n">ins</span><span class="p">);</span>
<span class="p">}</span> <span class="n">finally</span> <span class="p">{</span>
- <span class="sr">//</span> <span class="n">MUST</span> <span class="n">ensure</span> <span class="n">handler</span> <span class="n">is</span> <span class="n">closed</span><span class="o">.</span>
- <span class="n">handler</span><span class="o">.</span><span class="nb">close</span><span class="p">();</span>
+ <span class="c1">// MUST ensure handler is closed.</span>
+ <span class="n">handler</span><span class="p">.</span><span class="n">close</span><span class="p">();</span>
<span class="p">}</span>
<span class="p">}</span> <span class="n">catch</span> <span class="p">(</span><span class="n">SAXParseException</span> <span class="n">e</span><span class="p">)</span> <span class="p">{</span>
- <span class="sr">//</span> <span class="n">Fatal</span> <span class="n">parsing</span> <span class="n">errors</span> <span class="n">end</span> <span class="n">here</span><span class="p">,</span>
- <span class="sr">//</span> <span class="n">but</span> <span class="n">they</span> <span class="n">will</span> <span class="n">already</span> <span class="n">have</span> <span class="n">been</span> <span class="n">reported</span><span class="o">.</span>
+ <span class="c1">// Fatal parsing errors end here,</span>
+ <span class="c1">// but they will already have been reported.</span>
<span class="p">}</span>
</pre></div>
@@ -233,16 +233,16 @@ code is like this:</p>
<div class="codehilite"><pre><span class="n">static</span> <span class="n">public</span> <span class="n">void</span> <span class="n">installHandlers</span><span class="p">(</span><span class="n">XMLReader</span> <span class="n">rdr</span><span class="p">,</span> <span class="n">XMLHandler</span> <span class="n">sax2rdf</span><span class="p">)</span>
<span class="n">throws</span> <span class="n">SAXException</span>
<span class="p">{</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setEntityResolver</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setDTDHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setContentHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setErrorHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setFeature</span><span class="p">(</span><span class="s">"http://xml.org/sax/features/namespaces"</span><span class="p">,</span> <span class="n">true</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setFeature</span><span class="p">(</span>
- <span class="s">"http://xml.org/sax/features/namespace-prefixes"</span><span class="p">,</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setEntityResolver</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setDTDHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setContentHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setErrorHandler</span><span class="p">(</span><span class="n">sax2rdf</span><span class="p">);</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setFeature</span><span class="p">(</span>"<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">xml</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">sax</span><span class="o">/</span><span class="n">features</span><span class="o">/</span><span class="n">namespaces</span>"<span class="p">,</span> <span class="n">true</span><span class="p">);</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setFeature</span><span class="p">(</span>
+ "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">xml</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">sax</span><span class="o">/</span><span class="n">features</span><span class="o">/</span><span class="n">namespace</span><span class="o">-</span><span class="n">prefixes</span>"<span class="p">,</span>
<span class="n">true</span><span class="p">);</span>
- <span class="n">rdr</span><span class="o">.</span><span class="n">setProperty</span><span class="p">(</span>
- <span class="s">"http://xml.org/sax/properties/lexical-handler"</span><span class="p">,</span>
+ <span class="n">rdr</span><span class="p">.</span><span class="n">setProperty</span><span class="p">(</span>
+ "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">xml</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">sax</span><span class="o">/</span><span class="k">properties</span><span class="o">/</span><span class="n">lexical</span><span class="o">-</span><span class="n">handler</span>"<span class="p">,</span>
<span class="n">sax2rdf</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
Modified: websites/staging/jena/trunk/content/documentation/io/arp_standalone.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/arp_standalone.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/arp_standalone.html Thu Jun 20 10:18:34 2013
@@ -181,8 +181,7 @@ standalone.</p>
<li>Set its handlers, by calling the
<a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/arp/ARPConfig.html#getHandlers()">getHandlers</a>
or
- <br />
-<a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/arp/ARPConfig.html#setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)">setHandlersWith</a>
+ <a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/arp/ARPConfig.html#setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)">setHandlersWith</a>
methods, and then.<ul>
<li>Setting the
<a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/arp/ARPHandlers.html#setStatementHandler(com.hp.hpl.jena.rdf.arp.StatementHandler)">statement handler</a>.</li>
@@ -273,10 +272,10 @@ using the
<a href="/documentation/javadoc/jena/com/hp/hpl/jena/rdf/arp/ARPConfig.html#setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)">setHandlersWith</a>
method:</p>
<div class="codehilite"><pre> <span class="n">ARP</span> <span class="n">from</span><span class="p">,</span> <span class="n">to</span><span class="p">;</span>
- <span class="sr">//</span> <span class="n">initialize</span> <span class="n">from</span> <span class="ow">and</span> <span class="n">to</span>
- <span class="sr">//</span> <span class="o">...</span>
+ <span class="o">//</span> <span class="n">initialize</span> <span class="n">from</span> <span class="n">and</span> <span class="n">to</span>
+ <span class="o">//</span> <span class="p">...</span>
- <span class="n">to</span><span class="o">.</span><span class="n">setHandlersWith</span><span class="p">(</span><span class="n">from</span><span class="o">.</span><span class="n">getHandlers</span><span class="p">());</span>
+ <span class="n">to</span><span class="p">.</span><span class="n">setHandlersWith</span><span class="p">(</span><span class="n">from</span><span class="p">.</span><span class="n">getHandlers</span><span class="p">());</span>
</pre></div>
@@ -300,9 +299,9 @@ and then individual settings can be made
<p>It is also possible to copy all the option settings from one ARP
instance to another:</p>
<div class="codehilite"><pre> <span class="n">ARP</span> <span class="n">from</span><span class="p">,</span> <span class="n">to</span><span class="p">;</span>
- <span class="sr">//</span> <span class="n">initialize</span> <span class="n">from</span> <span class="ow">and</span> <span class="n">to</span> <span class="o">...</span>
+ <span class="o">//</span> <span class="n">initialize</span> <span class="n">from</span> <span class="n">and</span> <span class="n">to</span> <span class="p">...</span>
- <span class="n">to</span><span class="o">.</span><span class="n">setOptionsWith</span><span class="p">(</span><span class="n">from</span><span class="o">.</span><span class="n">getOptions</span><span class="p">());</span>
+ <span class="n">to</span><span class="p">.</span><span class="n">setOptionsWith</span><span class="p">(</span><span class="n">from</span><span class="p">.</span><span class="n">getOptions</span><span class="p">());</span>
</pre></div>
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 Jun 20 10:18:34 2013
@@ -225,7 +225,7 @@ See the <a href="rdf-json.html">descript
compressed. The file name is examined for an inner extension. For
example, <code>.nt.gz</code> is gzip compressed N-Triples.</p>
<p>These scripts call java programs in the <code>riotcmd</code> package. For example:</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">cp</span> <span class="o">...</span> <span class="n">riotcmd</span><span class="o">.</span><span class="n">riot</span> <span class="n">file</span><span class="o">.</span><span class="n">ttl</span>
+<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">cp</span> <span class="p">...</span> <span class="n">riotcmd</span><span class="p">.</span><span class="n">riot</span> <span class="n">file</span><span class="p">.</span><span class="n">ttl</span>
</pre></div>
@@ -245,7 +245,7 @@ utility which reads a file of bytes as U
<h2 id="inference">Inference</h2>
<p>RIOT support creation of inferred triples during the parsing
process:</p>
-<div class="codehilite"><pre><span class="n">riotcmd</span><span class="o">.</span><span class="n">infer</span> <span class="o">--</span><span class="n">rdfs</span> <span class="n">VOCAB</span> <span class="n">FILE</span> <span class="n">FILE</span> <span class="o">...</span>
+<div class="codehilite"><pre><span class="n">riotcmd</span><span class="p">.</span><span class="n">infer</span> <span class="o">--</span><span class="n">rdfs</span> <span class="n">VOCAB</span> <span class="n">FILE</span> <span class="n">FILE</span> <span class="p">...</span>
</pre></div>
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 Jun 20 10:18:34 2013
@@ -222,15 +222,15 @@ request), then the file extension if the
<code>text/plain</code>), which is assumed to be type returned for an unconfigured
http server. The application can also pass in a declared language hint.</p>
<p>The following is a suggested Apache httpd .htaccess file:</p>
-<div class="codehilite"><pre><span class="n">AddType</span> <span class="n">text</span><span class="o">/</span><span class="n">turtle</span> <span class="o">.</span><span class="n">ttl</span>
-<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">rdf</span><span class="o">+</span><span class="n">xml</span> <span class="o">.</span><span class="n">rdf</span>
-<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">n</span><span class="o">-</span><span class="n">triples</span> <span class="o">.</span><span class="n">nt</span>
+<div class="codehilite"><pre><span class="n">AddType</span> <span class="n">text</span><span class="o">/</span><span class="n">turtle</span> <span class="p">.</span><span class="n">ttl</span>
+<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">rdf</span><span class="o">+</span><span class="n">xml</span> <span class="p">.</span><span class="n">rdf</span>
+<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">n</span><span class="o">-</span><span class="n">triples</span> <span class="p">.</span><span class="n">nt</span>
-<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">ld</span><span class="o">+</span><span class="n">json</span> <span class="o">.</span><span class="n">jsonld</span>
-<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">owl</span><span class="o">+</span><span class="n">xml</span> <span class="o">.</span><span class="n">owl</span>
+<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">ld</span><span class="o">+</span><span class="n">json</span> <span class="p">.</span><span class="n">jsonld</span>
+<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">owl</span><span class="o">+</span><span class="n">xml</span> <span class="p">.</span><span class="n">owl</span>
-<span class="n">AddType</span> <span class="n">text</span><span class="o">/</span><span class="n">trig</span> <span class="o">.</span><span class="n">trig</span>
-<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">n</span><span class="o">-</span><span class="n">quads</span> <span class="o">.</span><span class="n">nq</span>
+<span class="n">AddType</span> <span class="n">text</span><span class="o">/</span><span class="n">trig</span> <span class="p">.</span><span class="n">trig</span>
+<span class="n">AddType</span> <span class="n">application</span><span class="o">/</span><span class="n">n</span><span class="o">-</span><span class="n">quads</span> <span class="p">.</span><span class="n">nq</span>
</pre></div>
@@ -239,7 +239,7 @@ http server. The application can also pa
<p>Model model = ModelFactory.createDefaultModel() ;
model.read("data.ttl") ;</p>
<p>If the syntax is not as the file extension, a language can be declared:</p>
-<div class="codehilite"><pre><span class="n">model</span><span class="o">.</span><span class="nb">read</span><span class="p">(</span><span class="s">"data.foo"</span><span class="p">,</span> <span class="s">"TURTLE"</span><span class="p">)</span> <span class="p">;</span>
+<div class="codehilite"><pre><span class="n">model</span><span class="p">.</span><span class="n">read</span><span class="p">(</span>"<span class="n">data</span><span class="p">.</span><span class="n">foo</span>"<span class="p">,</span> "<span class="n">TURTLE</span>"<span class="p">)</span> <span class="p">;</span>
</pre></div>
@@ -249,16 +249,16 @@ this functionality. It was more basic, a
<code>RDFDataMgr</code> superceeds the <code>FileManager</code>. "load*" operations create an
in-memory container (model, or dataset as appropriate); "read" operations
add data into an existing model or dataset.</p>
-<div class="codehilite"><pre><span class="sr">//</span> <span class="n">Create</span> <span class="n">a</span> <span class="n">model</span> <span class="ow">and</span> <span class="nb">read</span> <span class="n">into</span> <span class="n">it</span> <span class="n">from</span> <span class="n">file</span>
-<span class="sr">//</span> <span class="s">"data.ttl"</span> <span class="n">assumed</span> <span class="n">to</span> <span class="n">be</span> <span class="n">Turtle</span><span class="o">.</span>
-<span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="n">RDFDataMgr</span><span class="o">.</span><span class="n">loadModel</span><span class="p">(</span><span class="s">"data.ttl"</span><span class="p">)</span> <span class="p">;</span>
-
-<span class="sr">//</span> <span class="n">Create</span> <span class="n">a</span> <span class="n">dataset</span> <span class="ow">and</span> <span class="nb">read</span> <span class="n">into</span> <span class="n">it</span> <span class="n">from</span> <span class="n">file</span>
-<span class="sr">//</span> <span class="s">"data.trig"</span> <span class="n">assumed</span> <span class="n">to</span> <span class="n">be</span> <span class="n">TriG</span><span class="o">.</span>
-<span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="n">RDFDataMgr</span><span class="o">.</span><span class="n">loadDataset</span><span class="p">(</span><span class="s">"data.trig"</span><span class="p">)</span> <span class="p">;</span>
+<div class="codehilite"><pre><span class="c1">// Create a model and read into it from file </span>
+<span class="c1">// "data.ttl" assumed to be Turtle.</span>
+<span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="n">RDFDataMgr</span><span class="p">.</span><span class="n">loadModel</span><span class="p">(</span><span class="s">"data.ttl"</span><span class="p">)</span> <span class="p">;</span>
+
+<span class="c1">// Create a dataset and read into it from file </span>
+<span class="c1">// "data.trig" assumed to be TriG.</span>
+<span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="n">RDFDataMgr</span><span class="p">.</span><span class="n">loadDataset</span><span class="p">(</span><span class="s">"data.trig"</span><span class="p">)</span> <span class="p">;</span>
-<span class="sr">//</span> <span class="n">Read</span> <span class="n">into</span> <span class="n">an</span> <span class="n">existing</span> <span class="n">Model</span>
-<span class="n">RDFDataMgr</span><span class="o">.</span><span class="nb">read</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="s">"data2.ttl"</span><span class="p">)</span> <span class="p">;</span>
+<span class="c1">// Read into an existing Model</span>
+<span class="n">RDFDataMgr</span><span class="p">.</span><span class="n">read</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="s">"data2.ttl"</span><span class="p">)</span> <span class="p">;</span>
</pre></div>
@@ -294,13 +294,13 @@ copies of import http resources).</p>
<h3 id="configuring-a-locationmapper">Configuring a <code>LocationMapper</code></h3>
<p>Location mapping files are RDF, usually written in Turtle although
an RDF syntax can be used.</p>
-<div class="codehilite"><pre><span class="nv">@prefix</span> <span class="n">lm:</span> <span class="sr"><http://jena.hpl.hp.com/2004/08/location-mapping#></span>
+<div class="codehilite"><pre><span class="p">@</span><span class="n">prefix</span> <span class="n">lm</span><span class="p">:</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">jena</span><span class="p">.</span><span class="n">hpl</span><span class="p">.</span><span class="n">hp</span><span class="p">.</span><span class="n">com</span><span class="o">/</span>2004<span class="o">/</span>08<span class="o">/</span><span class="n">location</span><span class="o">-</span><span class="n">mapping</span>#<span class="o">></span>
-<span class="o">[]</span> <span class="n">lm:mapping</span>
- <span class="p">[</span> <span class="n">lm:name</span> <span class="s">"file:foo.n3"</span> <span class="p">;</span> <span class="n">lm:altName</span> <span class="s">"file:etc/foo.n3"</span> <span class="p">]</span> <span class="p">,</span>
- <span class="p">[</span> <span class="n">lm:prefix</span> <span class="s">"file:etc/"</span> <span class="p">;</span> <span class="n">lm:altPrefix</span> <span class="s">"file:ETC/"</span> <span class="p">]</span> <span class="p">,</span>
- <span class="p">[</span> <span class="n">lm:name</span> <span class="s">"file:etc/foo.n3"</span> <span class="p">;</span> <span class="n">lm:altName</span> <span class="s">"file:DIR/foo.n3"</span> <span class="p">]</span>
- <span class="o">.</span>
+<span class="p">[]</span> <span class="n">lm</span><span class="p">:</span><span class="n">mapping</span>
+ <span class="p">[</span> <span class="n">lm</span><span class="p">:</span><span class="n">name</span> "<span class="n">file</span><span class="p">:</span><span class="n">foo</span><span class="p">.</span><span class="n">n3</span>" <span class="p">;</span> <span class="n">lm</span><span class="p">:</span><span class="n">altName</span> "<span class="n">file</span><span class="p">:</span><span class="n">etc</span><span class="o">/</span><span class="n">foo</span><span class="p">.</span><span class="n">n3</span>" <span class="p">]</span> <span class="p">,</span>
+ <span class="p">[</span> <span class="n">lm</span><span class="p">:</span><span class="n">prefix</span> "<span class="n">file</span><span class="p">:</span><span class="n">etc</span><span class="o">/</span>" <span class="p">;</span> <span class="n">lm</span><span class="p">:</span><span class="n">altPrefix</span> "<span class="n">file</span><span class="p">:</span><span class="n">ETC</span><span class="o">/</span>" <span class="p">]</span> <span class="p">,</span>
+ <span class="p">[</span> <span class="n">lm</span><span class="p">:</span><span class="n">name</span> "<span class="n">file</span><span class="p">:</span><span class="n">etc</span><span class="o">/</span><span class="n">foo</span><span class="p">.</span><span class="n">n3</span>" <span class="p">;</span> <span class="n">lm</span><span class="p">:</span><span class="n">altName</span> "<span class="n">file</span><span class="p">:</span><span class="n">DIR</span><span class="o">/</span><span class="n">foo</span><span class="p">.</span><span class="n">n3</span>" <span class="p">]</span>
+ <span class="p">.</span>
</pre></div>