This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/jena-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new d966680ee Updated site from main
(60670c721a65a3f10836637e45300293446867e6)
d966680ee is described below
commit d966680ee29fbede5d6ccd8286ef720aa26d26b9
Author: jenkins <[email protected]>
AuthorDate: Thu Aug 25 09:22:44 2022 +0000
Updated site from main (60670c721a65a3f10836637e45300293446867e6)
---
content/documentation/extras/index.html | 6 +-
content/documentation/index.xml | 2 +-
content/documentation/query/index.html | 5 +-
content/documentation/query/service.html | 78 +++++++++++++++++++++++-
content/documentation/sparql-apis/http-auth.html | 29 +++++++--
content/documentation/sparql-apis/index.html | 18 ++----
content/download/index.html | 36 +++++------
content/download/maven.html | 5 ++
content/index.xml | 2 +-
content/sitemap.xml | 16 ++---
10 files changed, 144 insertions(+), 53 deletions(-)
diff --git a/content/documentation/extras/index.html
b/content/documentation/extras/index.html
index bb765f5fd..a76129804 100644
--- a/content/documentation/extras/index.html
+++ b/content/documentation/extras/index.html
@@ -176,10 +176,12 @@
</div>
<h1 class="title">Jena Extras - Extra packages for Jena
development.</h1>
- <p>Jena Extra modules are modules that provide utilities and larger
packages that make Apache Jena
-development or usage easier but that do not fall within the standard Jena
framework.</p>
+ <p>Jena Extra modules are modules that provide utilities and larger
packages
+that make Apache Jena development or usage easier
+but that do not fall within the standard Jena framework.</p>
<h2 id="sub-packages">Sub Packages</h2>
<ul>
+<li><a href="../query/service_enhancer.html">Bulk retrieval and caching with
SERVICE clauses</a></li>
<li><a href="querybuilder/index.html">Query Builder</a></li>
</ul>
diff --git a/content/documentation/index.xml b/content/documentation/index.xml
index d63ad4c55..6352635f4 100644
--- a/content/documentation/index.xml
+++ b/content/documentation/index.xml
@@ -980,7 +980,7 @@ What is an Assembler specification? An Assembler
specification is an RDF descrip
<guid>https://jena.apache.org/documentation/extras/</guid>
<description>Jena Extra modules are modules that provide utilities and
larger packages that make Apache Jena development or usage easier but that do
not fall within the standard Jena framework.
-Sub Packages Query Builder </description>
+Sub Packages Bulk retrieval and caching with SERVICE clauses Query Builder
</description>
</item>
<item>
diff --git a/content/documentation/query/index.html
b/content/documentation/query/index.html
index 318d1f323..cb376da5e 100644
--- a/content/documentation/query/index.html
+++ b/content/documentation/query/index.html
@@ -244,11 +244,10 @@ application usages</li>
<li><a href="algebra.html">ARQ and the SPARQL algebra</a></li>
<li><a href="arq-query-eval.html">Extending ARQ query execution and accessing
different storage implementations</a></li>
<li><a href="custom_aggregates.html">Custom aggregates</a></li>
+<li><a href="service_enhancer.html">Caching and bulk-retrieval for
SERVICE</a></li>
</ul>
<h2 id="extensions">Extensions</h2>
-<p>Feature of ARQ that go beyond SPARQL syntax. The default query
-language is standard SPARQL. These features require the query to be
-parsed with an explicit declaration of <code>Syntax.syntaxARQ</code>.</p>
+<p>Feature of ARQ that go beyond SPARQL syntax.</p>
<ul>
<li><a href="https://w3c.github.io/rdf-star/";>RDF-star</a></li>
<li>Operators and functions
diff --git a/content/documentation/query/service.html
b/content/documentation/query/service.html
index b4c7daa9f..aeb8429c9 100644
--- a/content/documentation/query/service.html
+++ b/content/documentation/query/service.html
@@ -227,8 +227,84 @@ Don’t ask for the whole of a bookstore just to find
a 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
+<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>arq:</code> is
<code><http://jena.apache.org/ARQ#></code>.</p>
+<table>
+<thead>
+<tr>
+<th>Symbol</th>
+<th>Java Constant</th>
+<th>Default</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>arq:httpServiceAllowed</code></td>
+<td><code>ARQ.httpServiceAllowed</code></td>
+<td>true</td>
+</tr>
+<tr>
+<td><code>arq:httpQueryClient</code></td>
+<td><code>ARQ.httpQueryClient</code></td>
+<td>System default.</td>
+</tr>
+<tr>
+<td><code>arq:httpServiceSendMode</code></td>
+<td>`ARQ.httpServiceSendMode | unset</td>
+<td></td>
+</tr>
+</tbody>
+</table>
+<h4 id="arqhttpserviceallowed"><code>arq:httpServiceAllowed</code></h4>
+<p>This setting can be used to disable execution of any SERVICE request in
query.
+Set to “false” to prohibit SERVICE requests.</p>
+<h4 id="arqhttpqueryclient"><code>arq:httpQueryClient</code></h4>
+<p>The java.net.http HttpClient object to use for SERVICE execution.</p>
+<h4 id="arqhttpservicesendmode"><code>arq:httpServiceSendMode</code></h4>
+<p>The HTTP operation to use. The value is a string or a
<code>QuerySendMode</code> object.</p>
+<p>String settings are:</p>
+<table>
+<thead>
+<tr>
+<th>Setting</th>
+<th>Effect</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>“POST”</td>
+<td>Use HTTP POST. Same as “asPost”.</td>
+</tr>
+<tr>
+<td>“GET”</td>
+<td>Use HTTP GET unconditionally. Same as “asGetAlways”.</td>
+</tr>
+<tr>
+<td>“asGetAlways”</td>
+<td>Use HTTP GET.</td>
+</tr>
+<tr>
+<td>“asGetWithLimitBody”</td>
+<td>Use HTTP GET upto a size limit (usually 2kbytes).</td>
+</tr>
+<tr>
+<td>“asGetWithLimitForm”</td>
+<td>Use HTTP GET upto a size limit (usually 2kbytes), and use a HTML form for
the query.</td>
+</tr>
+<tr>
+<td>“asPostForm”</td>
+<td>Use HTTP POST and use an HTML form for the query.</td>
+</tr>
+<tr>
+<td>“asPost”</td>
+<td>Use HTTP POST.</td>
+</tr>
+</tbody>
+</table>
+<h2 id="old-context-setting">Old Context setting</h2>
+<p>Old settings are honored where possible but should not be used:</p>
<p>The prefix <code>srv:</code> is the IRI
<code><http://jena.hpl.hp.com/Service#></code>.</p>
<table>
<thead>
diff --git a/content/documentation/sparql-apis/http-auth.html
b/content/documentation/sparql-apis/http-auth.html
index 0bc35d65a..b02ee808b 100644
--- a/content/documentation/sparql-apis/http-auth.html
+++ b/content/documentation/sparql-apis/http-auth.html
@@ -211,9 +211,13 @@ first to trigger the challenge and then again with the
HTTP authentication
information. To make this automatic, the first request must not be a streaming
request (the stream is not repeatable). All HTTP request generated by Jena are
repeatable.</p>
-<p>The URL can contain a <code>userinfo</code> part, either the
<code>users@host</code> form, or the <code>user:password@host</code> form.
-If just the user is given, the authentication environment is consulted for
registered users-password information. If user and password is given, the
details as given are used. This latter form is not recommended and should only
be used if necessary because the password is in-clear in the SPARQL
-query.</p>
+<p>The URL can contain a <code>userinfo</code> part, either the
<code>users@host</code> form, or the
+<code>user:password@host</code> form. If just the user is given, the
authentication
+environment is consulted for registered users-password information. If user and
+password is given, the details as given are used. This latter form is not
+recommended and should only be used if necessary because the password is
+in-clear in the SPARQL query.</p>
+<p>Jena also has <a href="#bearer-authentication">support for bearer
authentication</a>.</p>
<h3 id="jdk-httpclientauthenticator">JDK HttpClient.authenticator</h3>
<div class="highlight"><pre
style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code
class="language-java" data-lang="java"> <span
style="color:#080;font-style:italic">// Basic or Digest - determined when the
challenge happens.
</span><span style="color:#080;font-style:italic"></span> AuthEnv<span
style="color:#666">.</span><span style="color:#b44">get</span><span
style="color:#666">().</span><span
style="color:#b44">registerUsernamePassword</span><span
style="color:#666">(</span>URI<span style="color:#666">.</span><span
style="color:#b44">create</span><span style="color:#666">(</span>dataURL<span
style="color:#666">),</span> <span
style="color:#b44">"user"</span><span style="color:#666">,</span> <sp
[...]
@@ -278,9 +282,24 @@ used.</p>
ResultSet rs <span style="color:#666">=</span> qExec<span
style="color:#666">.</span><span style="color:#b44">execSelect</span><span
style="color:#666">();</span>
ResultSetFormatter<span style="color:#666">.</span><span
style="color:#b44">out</span><span style="color:#666">(</span>rs<span
style="color:#666">);</span>
<span style="color:#666">}</span>
-</code></pre></div><h2 id="examples">Examples</h2>
+</code></pre></div><h2 id="authentication-examples">Authentication
Examples</h2>
<p><a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/auth";>jena-examples:arq/examples/auth/</a>.</p>
-
+<h2 id="bearer-authentication">Bearer Authentication</h2>
+<p>Bearer authentication requires that the application to obtain a token to
present
+to the server.</p>
+<ul>
+<li><a href="https://tools.ietf.org/html/rfc6750";>RFC 6750</a></li>
+<li><a href="https://tools.ietf.org/html/rfc6751";>RFC 6751</a></li>
+<li><a href="https://tools.ietf.org/html/rfc7519";>JSON Web Tokens
(JWT)</a></li>
+<li><a href="https://tools.ietf.org/html/rfc8725";>JSON Web Token Best Current
Practices</a></li>
+</ul>
+<p>How this token is obtained depends on the deployment environment.</p>
+<p>The application can either register the token to be used:</p>
+<pre><code> AuthEnv.get().addBearerToken(targetURL, jwtString);
+</code></pre><p>or can provide a token provider for 401 challeneges stating
bearer authentication.</p>
+<pre><code> AuthEnv.get().setBearerTokenProvider(
+ (uri, challenge)->{ ... ; return jwtString; });
+</code></pre>
</div>
</div>
diff --git a/content/documentation/sparql-apis/index.html
b/content/documentation/sparql-apis/index.html
index ecb613d5a..8ba196127 100644
--- a/content/documentation/sparql-apis/index.html
+++ b/content/documentation/sparql-apis/index.html
@@ -440,7 +440,7 @@ authentication, has changed.</p>
<h2 id="service-configuration">SERVICE configuration</h2>
<p>See below for more on HTTP authentication with <code>SERVICE</code>.</p>
<p>The configuration of <code>SERVICE</code> operations has changed in Jena
4.3.0 and the
-paramter names have changed.</p>
+parameter names have changed.</p>
<table>
<thead>
<tr>
@@ -456,24 +456,14 @@ paramter names have changed.</p>
<td>False to disable</td>
</tr>
<tr>
-<td><code>arq:serviceParams</code></td>
-<td><code>ARQ.serviceParams</code></td>
-<td>Map</td>
-</tr>
-<tr>
-<td><code>arq:httpQueryTimeout</code></td>
-<td><code>ARQ.httpQueryTimeout</code></td>
-<td>Request timeout (time to completion)</td>
-</tr>
-<tr>
<td><code>arq:httpQueryClient</code></td>
<td><code>ARQ.httpQueryCient</code></td>
<td>An <code>java.net.http.HttpClient</code> object</td>
</tr>
<tr>
-<td><code>arq:httpQueryCompression</code></td>
-<td></td>
-<td>no-op</td>
+<td><code>arq:httpServiceSendMode</code></td>
+<td><code>ARQ.httpServiceSendMode</code></td>
+<td>See <a href="../query/service.html">Service documentation</a></td>
</tr>
</tbody>
</table>
diff --git a/content/download/index.html b/content/download/index.html
index 62737c96b..74756035c 100644
--- a/content/download/index.html
+++ b/content/download/index.html
@@ -188,9 +188,9 @@
</thead>
<tbody>
<tr>
-<td><a
href="[preferred]jena/source/jena-4.5.0-source-release.zip">jena-4.5.0-source-release.zip</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/source/jena-4.5.0-source-release.zip.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/source/jena-4.5.0-source-release.zip.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/source/jena-4.6.0-source-release.zip">jena-4.6.0-source-release.zip</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/source/jena-4.6.0-source-release.zip.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/source/jena-4.6.0-source-release.zip.asc";>PGP</a></td>
</tr>
</tbody>
</table>
@@ -206,14 +206,14 @@
</thead>
<tbody>
<tr>
-<td><a
href="[preferred]jena/binaries/apache-jena-fuseki-4.5.0.tar.gz">apache-jena-fuseki-4.5.0.tar.gz</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.tar.gz.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.tar.gz.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/binaries/apache-jena-fuseki-4.6.0.tar.gz">apache-jena-fuseki-4.6.0.tar.gz</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.tar.gz.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.tar.gz.asc";>PGP</a></td>
</tr>
<tr>
-<td><a
href="[preferred]jena/binaries/apache-jena-fuseki-4.5.0.zip">apache-jena-fuseki-4.5.0.zip</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.zip.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.zip.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/binaries/apache-jena-fuseki-4.6.0.zip">apache-jena-fuseki-4.6.0.zip</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.zip.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.zip.asc";>PGP</a></td>
</tr>
</tbody>
</table>
@@ -229,14 +229,14 @@ The binary distribution of libraries contains the APIs,
SPARQL engine, the TDB n
</thead>
<tbody>
<tr>
-<td><a
href="[preferred]jena/binaries/apache-jena-4.5.0.tar.gz">apache-jena-4.5.0.tar.gz</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.tar.gz.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.tar.gz.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/binaries/apache-jena-4.6.0.tar.gz">apache-jena-4.6.0.tar.gz</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.tar.gz.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.tar.gz.asc";>PGP</a></td>
</tr>
<tr>
-<td><a
href="[preferred]jena/binaries/apache-jena-4.5.0.zip">apache-jena-4.5.0.zip</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.zip.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.zip.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/binaries/apache-jena-4.6.0.zip">apache-jena-4.6.0.zip</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.zip.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.zip.asc";>PGP</a></td>
</tr>
</tbody>
</table>
@@ -252,9 +252,9 @@ The binary distribution of Fuseki as a WAR file:
</thead>
<tbody>
<tr>
-<td><a
href="[preferred]jena/binaries/jena-fuseki-war-4.5.0.war">jena-fuseki-war-4.5.0.war</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.5.0.war.sha512";>SHA512</a></td>
-<td align="center"><a
href="https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.5.0.war.asc";>PGP</a></td>
+<td><a
href="[preferred]jena/binaries/jena-fuseki-war-4.6.0.war">jena-fuseki-war-4.6.0.war</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.6.0.war.sha512";>SHA512</a></td>
+<td align="center"><a
href="https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.6.0.war.asc";>PGP</a></td>
</tr>
</tbody>
</table>
diff --git a/content/download/maven.html b/content/download/maven.html
index 9c628def9..11be1e88e 100644
--- a/content/download/maven.html
+++ b/content/download/maven.html
@@ -257,6 +257,11 @@ structuring Jena development.</p>
<td><code>jar</code></td>
<td>ShEx engine for Jena.</td>
</tr>
+ <tr>
+ <td><code>jena-serviceenhancer</code></td>
+ <td><code>jar</code></td>
+ <td>Bulk retrieval and caching for SERVICE clauses</td>
+ </tr>
<tr>
<td><code>jena-querybuilder</code></td>
<td><code>jar</code></td>
diff --git a/content/index.xml b/content/index.xml
index 5355c1844..3aece85e8 100644
--- a/content/index.xml
+++ b/content/index.xml
@@ -1084,7 +1084,7 @@ What is an Assembler specification? An Assembler
specification is an RDF descrip
<guid>https://jena.apache.org/documentation/extras/</guid>
<description>Jena Extra modules are modules that provide utilities and
larger packages that make Apache Jena development or usage easier but that do
not fall within the standard Jena framework.
-Sub Packages Query Builder </description>
+Sub Packages Bulk retrieval and caching with SERVICE clauses Query Builder
</description>
</item>
<item>
diff --git a/content/sitemap.xml b/content/sitemap.xml
index 4183b751c..ae315cf39 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -84,7 +84,7 @@
<url>
<loc>https://jena.apache.org/download/</loc>
- <lastmod>2022-05-01T16:21:01+01:00</lastmod>
+ <lastmod>2022-08-20T12:07:07+01:00</lastmod>
</url>
<url>
@@ -104,12 +104,12 @@
<url>
<loc>https://jena.apache.org/documentation/sparql-apis/</loc>
- <lastmod>2022-02-06T18:02:48+00:00</lastmod>
+ <lastmod>2022-08-20T12:05:43+01:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/query/</loc>
- <lastmod>2022-05-31T09:58:44+01:00</lastmod>
+ <lastmod>2022-08-20T12:20:18+01:00</lastmod>
</url>
<url>
@@ -129,7 +129,7 @@
<url>
<loc>https://jena.apache.org/documentation/query/service.html</loc>
- <lastmod>2020-10-23T09:28:24+01:00</lastmod>
+ <lastmod>2022-08-20T12:05:43+01:00</lastmod>
</url>
<url>
@@ -334,7 +334,7 @@
<url>
<loc>https://jena.apache.org/download.html</loc>
- <lastmod>2022-05-01T16:21:01+01:00</lastmod>
+ <lastmod>2022-08-20T12:20:18+01:00</lastmod>
</url>
<url>
@@ -494,7 +494,7 @@
<url>
<loc>https://jena.apache.org/documentation/sparql-apis/http-auth.html</loc>
- <lastmod>2021-11-15T19:40:46+00:00</lastmod>
+ <lastmod>2022-08-20T12:04:21+01:00</lastmod>
</url>
<url>
@@ -529,7 +529,7 @@
<url>
<loc>https://jena.apache.org/documentation/extras/</loc>
- <lastmod>2020-02-28T13:09:12+01:00</lastmod>
+ <lastmod>2022-08-20T12:20:18+01:00</lastmod>
</url>
<url>
@@ -1139,7 +1139,7 @@
<url>
<loc>https://jena.apache.org/download/maven.html</loc>
- <lastmod>2021-09-17T20:43:29+01:00</lastmod>
+ <lastmod>2022-08-20T12:20:18+01:00</lastmod>
</url>
<url>
