You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by an...@apache.org on 2022/08/25 09:20:39 UTC
[jena-site] branch main-next updated (c9a0846c8 -> 3c9589cfb)
This is an automated email from the ASF dual-hosted git repository.
andy pushed a change to branch main-next
in repository https://gitbox.apache.org/repos/asf/jena-site.git
discard c9a0846c8 Connect to service enhancer documentation
discard 69ec6a386 Download links for Jena 4.6.0
discard fac7eb792 Documentation for arq:httpServiceSendMode
discard ca6fc0d1e Documentation for bearer auth support
add 46db6ede1 add note about geof:asGeoJSON (#104)
add 74d2d8fbc Add ValidationListener documentation (#107)
add 70f71e83d add geo-literal note and example (#112)
add ba0014c3c Fix doc about querying remote service (#114)
new d9c9fa06f Documentation for bearer auth support
new ffd0f2064 Documentation for arq:httpServiceSendMode
new cb79efcac Download links for Jena 4.6.0
new 3c9589cfb Connect to service enhancer documentation
This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version. This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:
* -- * -- B -- O -- O -- O (c9a0846c8)
\
N -- N -- N refs/heads/main-next (3c9589cfb)
You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.
Any revisions marked "omit" are not gone; other references still
refer to them. Any revisions marked "discard" are gone forever.
The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
source/documentation/geosparql/__index.md | 7 ++++
source/documentation/query/sparql-remote.md | 7 +++-
source/documentation/shacl/__index.md | 65 +++++++++++++++++++++++++++++
3 files changed, 77 insertions(+), 2 deletions(-)
[jena-site] 01/04: Documentation for bearer auth support
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main-next
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit d9c9fa06f0dcd17acc4822d6c17c01842167902b
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sat Aug 20 12:04:21 2022 +0100
Documentation for bearer auth support
---
source/documentation/sparql-apis/http-auth.md | 38 ++++++++++++++++++++++++---
1 file changed, 34 insertions(+), 4 deletions(-)
diff --git a/source/documentation/sparql-apis/http-auth.md b/source/documentation/sparql-apis/http-auth.md
index a5742bc4f..f742cef98 100644
--- a/source/documentation/sparql-apis/http-auth.md
+++ b/source/documentation/sparql-apis/http-auth.md
@@ -38,9 +38,14 @@ 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.
-The URL can contain a `userinfo` part, either the `users@host` form, or the `user:password@host` 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.
+The URL can contain a `userinfo` part, either the `users@host` form, or the
+`user:password@host` 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.
+
+Jena also has [support for bearer authentication](#bearer-authentication).
### JDK HttpClient.authenticator
@@ -137,6 +142,31 @@ used.
}
```
-## Examples
+## Authentication Examples
[jena-examples:arq/examples/auth/](https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/auth).
+
+## Bearer Authentication
+
+Bearer authentication requires that the application to obtain a token to present
+to the server.
+
+* [RFC 6750](https://tools.ietf.org/html/rfc6750)
+* [RFC 6751](https://tools.ietf.org/html/rfc6751)
+* [JSON Web Tokens (JWT)](https://tools.ietf.org/html/rfc7519)
+* [JSON Web Token Best Current Practices](https://tools.ietf.org/html/rfc8725)
+
+How this token is obtained depends on the deployment environment.
+
+The application can either register the token to be used:
+
+```
+ AuthEnv.get().addBearerToken(targetURL, jwtString);
+```
+
+or can provide a token provider for 401 challeneges stating bearer authentication.
+
+```
+ AuthEnv.get().setBearerTokenProvider(
+ (uri, challenge)->{ ... ; return jwtString; });
+```
[jena-site] 03/04: Download links for Jena 4.6.0
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main-next
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit cb79efcacdeea69738eecfebde861688c68e7a5f
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sat Aug 20 12:07:07 2022 +0100
Download links for Jena 4.6.0
---
source/download/__index.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/source/download/__index.md b/source/download/__index.md
index ce9116618..de9449668 100644
--- a/source/download/__index.md
+++ b/source/download/__index.md
@@ -19,7 +19,7 @@ Source release: this forms the official release of Apache Jena. All binaries art
| Apache Jena Release | SHA512 | Signature |
| ------------ | :----: | :-------: |
-|<a href="[preferred]jena/source/jena-4.5.0-source-release.zip">jena-4.5.0-source-release.zip</a> | [SHA512](https://downloads.apache.org/jena/source/jena-4.5.0-source-release.zip.sha512) | [PGP](https://downloads.apache.org/jena/source/jena-4.5.0-source-release.zip.asc) |
+|<a href="[preferred]jena/source/jena-4.6.0-source-release.zip">jena-4.6.0-source-release.zip</a> | [SHA512](https://downloads.apache.org/jena/source/jena-4.6.0-source-release.zip.sha512) | [PGP](https://downloads.apache.org/jena/source/jena-4.6.0-source-release.zip.asc) |
### Apache Jena Binary Distributions
@@ -27,23 +27,23 @@ The binary distribution of the Fuseki server:
| Apache Jena Fuseki | SHA512 | Signature |
| ------------ | :----: | :-------: |
-| <a href="[preferred]jena/binaries/apache-jena-fuseki-4.5.0.tar.gz">apache-jena-fuseki-4.5.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.tar.gz.asc) |
-| <a href="[preferred]jena/binaries/apache-jena-fuseki-4.5.0.zip">apache-jena-fuseki-4.5.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.zip.asc) |
+| <a href="[preferred]jena/binaries/apache-jena-fuseki-4.6.0.tar.gz">apache-jena-fuseki-4.6.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.tar.gz.asc) |
+| <a href="[preferred]jena/binaries/apache-jena-fuseki-4.6.0.zip">apache-jena-fuseki-4.6.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.6.0.zip.asc) |
<p> </p>
The binary distribution of libraries contains the APIs, SPARQL engine, the TDB native RDF database and a variety of command line scripts and tools for working with these systems.
| Apache Jena libraries | SHA512 | Signature |
| ------------ | :----: | :-------: |
-|<a href="[preferred]jena/binaries/apache-jena-4.5.0.tar.gz">apache-jena-4.5.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.tar.gz.asc) |
-| <a href="[preferred]jena/binaries/apache-jena-4.5.0.zip">apache-jena-4.5.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.5.0.zip.asc)
+|<a href="[preferred]jena/binaries/apache-jena-4.6.0.tar.gz">apache-jena-4.6.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.tar.gz.asc) |
+| <a href="[preferred]jena/binaries/apache-jena-4.6.0.zip">apache-jena-4.6.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.6.0.zip.asc)
<p> </p>
The binary distribution of Fuseki as a WAR file:
| Apache Jena Fuseki | SHA512 | Signature |
| ------------ | :----: | :-------: |
-| <a href="[preferred]jena/binaries/jena-fuseki-war-4.5.0.war">jena-fuseki-war-4.5.0.war</a> | [SHA512](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.5.0.war.sha512) | [PGP](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.5.0.war.asc) |
+| <a href="[preferred]jena/binaries/jena-fuseki-war-4.6.0.war">jena-fuseki-war-4.6.0.war</a> | [SHA512](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.6.0.war.sha512) | [PGP](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.6.0.war.asc) |
### Individual Modules
[jena-site] 04/04: Connect to service enhancer documentation
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main-next
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit 3c9589cfb09c1c61d724869f813191a8d70feb63
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sat Aug 20 12:20:18 2022 +0100
Connect to service enhancer documentation
---
source/documentation/extras/__index.md | 6 ++++--
source/documentation/query/__index.md | 5 ++---
source/download/maven.md | 5 +++++
3 files changed, 11 insertions(+), 5 deletions(-)
diff --git a/source/documentation/extras/__index.md b/source/documentation/extras/__index.md
index cbc7b1828..2b72d38a2 100644
--- a/source/documentation/extras/__index.md
+++ b/source/documentation/extras/__index.md
@@ -3,10 +3,12 @@ title: Jena Extras - Extra packages for Jena development.
slug: index
---
-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.
+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
+- [Bulk retrieval and caching with SERVICE clauses](../query/service_enhancer.html)
- [Query Builder](querybuilder/index.html)
diff --git a/source/documentation/query/__index.md b/source/documentation/query/__index.md
index 8dd381982..bdb3da82b 100644
--- a/source/documentation/query/__index.md
+++ b/source/documentation/query/__index.md
@@ -63,12 +63,11 @@ Features of ARQ that are legal SPARQL syntax
- [ARQ and the SPARQL algebra](algebra.html)
- [Extending ARQ query execution and accessing different storage implementations](arq-query-eval.html)
- [Custom aggregates](custom_aggregates.html)
+- [Caching and bulk-retrieval for SERVICE](service_enhancer.html)
## Extensions
-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 `Syntax.syntaxARQ`.
+Feature of ARQ that go beyond SPARQL syntax.
- [RDF-star](https://w3c.github.io/rdf-star/)
- Operators and functions
diff --git a/source/download/maven.md b/source/download/maven.md
index e910ab7d3..6e7ffd6bb 100644
--- a/source/download/maven.md
+++ b/source/download/maven.md
@@ -100,6 +100,11 @@ structuring Jena development.
<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>
[jena-site] 02/04: Documentation for arq:httpServiceSendMode
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main-next
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit ffd0f2064e0612ce7e5347ee703b609f1a9e20d3
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sat Aug 20 12:05:43 2022 +0100
Documentation for arq:httpServiceSendMode
---
source/documentation/query/service.md | 42 ++++++++++++++++++++++++++++-
source/documentation/sparql-apis/__index.md | 6 ++---
2 files changed, 43 insertions(+), 5 deletions(-)
diff --git a/source/documentation/query/service.md b/source/documentation/query/service.md
index 49eed5fca..72b69f943 100644
--- a/source/documentation/query/service.md
+++ b/source/documentation/query/service.md
@@ -56,11 +56,51 @@ the title already bound from earlier in the query.
## Controlling `SERVICE` requests.
-The `SERVICE` operation in a SPARQL query may be configured via the Context. The values for configuration can be set in the global context (accessed via
+The `SERVICE` operation in a SPARQL query may be configured via the Context.
+The values for configuration can be set in the global context (accessed via
`ARQ.getContext()`) or in the per-query execution context.
+The prefix `arq:` is `<http://jena.apache.org/ARQ#>`.
+
+Symbol | Java Constant | Default
+------ | ------------- | -------
+`arq:httpServiceAllowed` | `ARQ.httpServiceAllowed` | true
+`arq:httpQueryClient` | `ARQ.httpQueryClient` | System default.
+`arq:httpServiceSendMode` | `ARQ.httpServiceSendMode | unset
+
+#### `arq:httpServiceAllowed`
+
+This setting can be used to disable execution of any SERVICE request in query.
+Set to "false" to prohibit SERVICE requests.
+
+#### `arq:httpQueryClient`
+
+The java.net.http HttpClient object to use for SERVICE execution.
+
+#### `arq:httpServiceSendMode`
+
+The HTTP operation to use. The value is a string or a `QuerySendMode` object.
+
+String settings are:
+
+Setting | Effect
+------- | ------
+"POST" | Use HTTP POST. Same as "asPost".
+"GET" | Use HTTP GET unconditionally. Same as "asGetAlways".
+"asGetAlways" | Use HTTP GET.
+"asGetWithLimitBody" | Use HTTP GET upto a size limit (usually 2kbytes).
+"asGetWithLimitForm" | Use HTTP GET upto a size limit (usually 2kbytes), and use a HTML form for the query.
+"asPostForm" | Use HTTP POST and use an HTML form for the query.
+"asPost" | Use HTTP POST.
+
+
+## Old Context setting
+
+Old settings are honored where possible but should not be used:
+
The prefix `srv:` is the IRI `<http://jena.hpl.hp.com/Service#>`.
+
Symbol | Usage | Default
------ | ----- | -------
`srv:queryTimeout` | Set timeouts | none
diff --git a/source/documentation/sparql-apis/__index.md b/source/documentation/sparql-apis/__index.md
index f0192c148..47f0ed657 100644
--- a/source/documentation/sparql-apis/__index.md
+++ b/source/documentation/sparql-apis/__index.md
@@ -262,15 +262,13 @@ authentication, has changed.
See below for more on HTTP authentication with `SERVICE`.
The configuration of `SERVICE` operations has changed in Jena 4.3.0 and the
-paramter names have changed.
+parameter names have changed.
| Symbol | Java Constant | Usage |
| ------ | ------------- | --- |
| `arq:httpServiceAllowed` | `ARQ.httpServiceAllowed` | False to disable |
-| `arq:serviceParams` | `ARQ.serviceParams` | Map |
-| `arq:httpQueryTimeout` | `ARQ.httpQueryTimeout` | Request timeout (time to completion) |
| `arq:httpQueryClient` | `ARQ.httpQueryCient` | An `java.net.http.HttpClient` object |
-| `arq:httpQueryCompression` | | no-op |
+| `arq:httpServiceSendMode` | `ARQ.httpServiceSendMode` | See [Service documentation](../query/service.html) |
where `arq:` is prefix for `<http://jena.apache.org/ARQ#>`.