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 2012/05/30 16:24:10 UTC
svn commit: r819626 - in /websites/staging/jena/trunk/content: ./
documentation/query/index.html documentation/query/service.html
Author: buildbot
Date: Wed May 30 14:24:09 2012
New Revision: 819626
Log:
Staging update by buildbot for jena
Modified:
websites/staging/jena/trunk/content/ (props changed)
websites/staging/jena/trunk/content/documentation/query/index.html
websites/staging/jena/trunk/content/documentation/query/service.html
Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed May 30 14:24:09 2012
@@ -1 +1 @@
-1343162
+1344273
Modified: websites/staging/jena/trunk/content/documentation/query/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/query/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/query/index.html Wed May 30 14:24:09 2012
@@ -188,6 +188,7 @@ SPARQL is the query language developed b
<li><a href="logging.html">Logging</a></li>
<li><a href="explain.html">Explaining queries</a></li>
<li><a href="manipulating_sparql_using_arq.html">Tutorial: manipulating SPARQL using ARQ</a></li>
+<li><a href="service.html">Basic federated query (<code>SERVICE</code>)</a></li>
</ul>
<h2 id="advanced-sparql-use">Advanced SPARQL use</h2>
<p>Features of ARQ that are legal SPARQL syntax.</p>
@@ -227,7 +228,6 @@ parsed with an explicit declaration of <
<li><a href="sub-select.html">Sub-SELECT</a></li>
<li><a href="negation.html">Negation</a></li>
<li><a href="assignment.html">LET variable assignment</a></li>
-<li><a href="service.html">Basic federated query</a></li>
<li><a href="function_forms.html">Conditions in FILTERs</a></li>
</ul>
<h2 id="update">Update</h2>
Modified: websites/staging/jena/trunk/content/documentation/query/service.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/query/service.html (original)
+++ websites/staging/jena/trunk/content/documentation/query/service.html Wed May 30 14:24:09 2012
@@ -213,6 +213,74 @@ operations, asking the query in the righ
Don't ask for the whole of a bookstore just to find book whose
title comes from a local RDF file - ask the bookshop a query with
the title already bound from earlier in the query.</p>
+<h2 id="controlling-service-requests">Controlling <code>SERVICE</code> requests.</h2>
+<p>The <code>SERVICE</code> operation in a SPARQL query may be configured via the Context.
+The values for configuration can be set in the global context (accessed via
+<code>ARQ.getCOntext()</code>) or in the per-query execution context.</p>
+<p>The prefix <code>srv:</code> is the IRI <code><http://jena.hpl.hp.com/Service#></code>.</p>
+<h3 id="summary">Summary</h3>
+<table>
+<thead>
+<tr>
+<th>Symbol</th>
+<th>Usage</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>srv:queryTimeout</code></td>
+<td>Set timeouts</td>
+</tr>
+<tr>
+<td><code>srv:queryGzip</code></td>
+<td>Enable use of GZip</td>
+</tr>
+<tr>
+<td><code>srv:queryDeflate</code></td>
+<td>Enable use of deflate</td>
+</tr>
+<tr>
+<td><code>srv:queryAuthUser</code></td>
+<td>Basic authentication</td>
+</tr>
+<tr>
+<td><code>srv:queryAuthPwd</code></td>
+<td>Basic authentication</td>
+</tr>
+<tr>
+<td><code>srv:queryContext</code></td>
+<td>Per-endpoint configuration</td>
+</tr>
+</tbody>
+</table>
+<h3 id="srvquerytimeout"><code>srv:queryTimeout</code></h3>
+<p>Set the connect and read timeouts for the query.</p>
+<p>If a timeout occurs a QueryExceptionHTTP is thrown. The cause of that execption will be a java.net.SocketTimeoutException.</p>
+<p>Number: number of milliseconds for connect timeout.</p>
+<p>String: number of milliseconds for connect timeout. If string is of the form âX,Yâ the first number is the numbr of milliseconds for the connect timeout and the seconds is the number of milliseconds for the read timeout.</p>
+<p>Connect timeout =0
+read timout = 0</p>
+<p>Values of 0 indicate no timeout and service operation will wait until the remote server responds.</p>
+<h3 id="srvquerygzip"><code>srv:queryGzip</code></h3>
+<p>Sets the allow Gzip flag.</p>
+<p>Boolean: True indicates that gzip compressed data is acceptable.
+false</p>
+<h3 id="srvquerydeflate"><code>srv:queryDeflate</code></h3>
+<p>Sets the allow Deflate flag.</p>
+<p>Boolean: True indicates that deflate compression is acceptable
+False</p>
+<h3 id="srvqueryauthuser"><code>srv:queryAuthUser</code></h3>
+<p>Sets the user id for basic auth.</p>
+<p>String: The user id to log in with</p>
+<p>If null or null length no user id is sent.</p>
+<h3 id="srvqueryauthpwd"><code>srv:queryAuthPwd</code></h3>
+<p>Sets the password for basic auth.</p>
+<p>String: The password to log in with.</p>
+<p>If null or null length no password is sent.</p>
+<h3 id="srvservicecontext">srv:serviceContext</h3>
+<p>Provides a mechanism to override system context settings on a per URI basis.</p>
+<p>The value is a <code>Map<String,Context></code> where the map key is the URI of the service endpoint, and the <code>Context</code> is a set of values to override the default values.</p>
+<p>If a context is provided for the URI the system context is copied and the URI specific values are then copied in. This ensures that any URI specific settings will be used.</p>
<p><a href="index.html">ARQ documentation index</a></p>
</div>