svn commit: r1027135 - in /websites/staging/jena/trunk/content: ./ documentation/rdfconnection/index.html

[bu...@apache.org]

Author: buildbot
Date: Thu Mar 22 13:40:37 2018
New Revision: 1027135

Log:
Staging update by buildbot for jena

Modified:
    websites/staging/jena/trunk/content/   (props changed)
    websites/staging/jena/trunk/content/documentation/rdfconnection/index.html

Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Mar 22 13:40:37 2018
@@ -1 +1 @@
-1823358
+1827490

Modified: websites/staging/jena/trunk/content/documentation/rdfconnection/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/rdfconnection/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/rdfconnection/index.html Thu Mar 22 13:40:37 2018
@@ -252,6 +252,38 @@ responsibility of the remote server.</p>
 <p>An <code>RDFConnection</code> will at least provide the client-side locking features.
 This means that overlapping operations that change data are naturally
 handled by the transaction pattern within a single JVM.</p>
+<h2 id="configuring-a-remote-rdfconnection">Configuring a remote <code>RDFConnection</code>.<a class="headerlink" href="#configuring-a-remote-rdfconnection" title="Permanent link">&para;</a></h2>
+<p>The default settings on a remote connection should work for any SPARQL
+triple store endpoint which supports HTTP content negotiation. Sometimes
+different settings are desirable or required and <code>RDFConnectionRemote</code> provides a
+builder to construct <code>RDFConnectionRemote</code>s.</p>
+<p>At its simplest, it is:</p>
+<div class="codehilite"><pre><span class="n">RDFConnectionRemoteBuilder</span> <span class="n">builder</span> <span class="p">=</span> <span class="n">RDFConnection</span><span class="p">.</span><span class="n">create</span><span class="p">()</span>
+            <span class="p">.</span><span class="n">destination</span><span class="p">(</span>&quot;<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">host</span><span class="o">/</span><span class="n">triplestore</span>&quot;<span class="p">);</span>
+</pre></div>
+
+
+<p>which uses default settings used by <code>RDFConenctionFactory.connect</code>.</p>
+<p>See <a href="https://github.com/apache/jena/blob/master/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample4.java">example
+4</a>
+and <a href="https://github.com/apache/jena/blob/master/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample5.java">example
+5</a>.</p>
+<p>There are many options, including setting HTTP headers for content types
+(<a href="http://jena.apache.org/documentation/javadoc/rdfconnection/index.html">javadoc</a>)
+and providing detailed configuration with 
+<a href="https://hc.apache.org/httpcomponents-client-ga/">Apache HttpComponents HttpClient</a>.</p>
+<h3 id="fuseki-specific-connection">Fuseki Specific Connection<a class="headerlink" href="#fuseki-specific-connection" title="Permanent link">&para;</a></h3>
+<p>If the remote destination is a Apache Jena Fuseki server, then teh
+default egneral settings work but it is possible to have a specialised connection </p>
+<div class="codehilite"><pre>    <span class="n">RDFConnectionRemoteBuilder</span> <span class="n">builder</span> <span class="p">=</span> <span class="n">RDFConnectionFuseki</span><span class="p">.</span><span class="n">create</span><span class="p">()</span>
+          <span class="p">.</span><span class="n">destination</span><span class="p">(</span>&quot;<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">host</span><span class="o">/</span><span class="n">fuseki</span>&quot;<span class="p">);</span>
+</pre></div>
+
+
+<p>which uses settings tuned to Fuseki, including round-trip handling of
+blank nodes.</p>
+<p>See <a href="https://github.com/apache/jena/blob/master/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample6.java">example 
+6</a>.</p>
 <h2 id="graph-store-protocol">Graph Store Protocol<a class="headerlink" href="#graph-store-protocol" title="Permanent link">&para;</a></h2>
 <p>The <a href="http://www.w3.org/TR/sparql11-http-rdf-update/">SPARQL Graph
 Store Protocol</a> (GSP) is a set of operations to work on whole graphs in a