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/05/04 21:08:16 UTC
[jena-site] branch main updated (aaa59acc2 -> f452cd46f)
This is an automated email from the ASF dual-hosted git repository.
andy pushed a change to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
from aaa59acc2 Add link to privacy policy
new 1435ccb54 Update for GSP and quads
new a8eec3a5f Split GSP and DSP
new 8d5598db8 geosparql:GeosparqlDataset
new d917f662c JENA-2298, JENA-2299: Updates for RDFParser and RDFWriter
new 95cf81c9f Use RDFWriter.source()
new f452cd46f Download links for 4.5.0
The 6 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:
.../fuseki2/fuseki-config-endpoint.md | 8 ++--
source/documentation/fuseki2/fuseki-embedded.md | 43 +++++++++++-----------
.../documentation/geosparql/geosparql-assembler.md | 2 +-
source/documentation/io/rdf-input.md | 14 ++++---
source/documentation/io/rdf-output.md | 3 +-
source/documentation/io/streaming-io.md | 2 +-
source/documentation/sparql-apis/__index.md | 22 +++++++++--
source/download/__index.md | 12 +++---
8 files changed, 60 insertions(+), 46 deletions(-)
[jena-site] 06/06: Download links for 4.5.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
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit f452cd46f8a7f9bdb66cc34166e242acd5e40869
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sun May 1 16:21:01 2022 +0100
Download links for 4.5.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 875269586..ce9116618 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.4.0-source-release.zip">jena-4.4.0-source-release.zip</a> | [SHA512](https://downloads.apache.org/jena/source/jena-4.4.0-source-release.zip.sha512) | [PGP](https://downloads.apache.org/jena/source/jena-4.4.0-source-release.zip.asc) |
+|<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) |
### 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.4.0.tar.gz">apache-jena-fuseki-4.4.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.4.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.4.0.tar.gz.asc) |
-| <a href="[preferred]jena/binaries/apache-jena-fuseki-4.4.0.zip">apache-jena-fuseki-4.4.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.4.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.4.0.zip.asc) |
+| <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) |
<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.4.0.tar.gz">apache-jena-4.4.0.tar.gz</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.4.0.tar.gz.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.4.0.tar.gz.asc) |
-| <a href="[preferred]jena/binaries/apache-jena-4.4.0.zip">apache-jena-4.4.0.zip</a> | [SHA512](https://downloads.apache.org/jena/binaries/apache-jena-4.4.0.zip.sha512) | [PGP](https://downloads.apache.org/jena/binaries/apache-jena-4.4.0.zip.asc)
+|<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)
<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.4.0.war">jena-fuseki-war-4.4.0.war</a> | [SHA512](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.4.0.war.sha512) | [PGP](https://downloads.apache.org/jena/binaries/jena-fuseki-war-4.4.0.war.asc) |
+| <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) |
### Individual Modules
[jena-site] 03/06: geosparql:GeosparqlDataset
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit 8d5598db86dbe7a4246f515ca6887d6f16966b92
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sun Feb 6 18:03:15 2022 +0000
geosparql:GeosparqlDataset
---
source/documentation/geosparql/geosparql-assembler.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/documentation/geosparql/geosparql-assembler.md b/source/documentation/geosparql/geosparql-assembler.md
index 09929aa88..a96da877d 100644
--- a/source/documentation/geosparql/geosparql-assembler.md
+++ b/source/documentation/geosparql/geosparql-assembler.md
@@ -71,7 +71,7 @@ PREFIX geosparql: <http://jena.apache.org/geosparql#>
The full assembler properties with the default settings is:
```
-<#geo_ds> rdf:type geosparql:geosparqlDataset ;
+<#geo_ds> rdf:type geosparql:GeosparqlDataset ;
# Build in-memory is absent.
geosparql:spatialIndexFile "spatial.index";
[jena-site] 05/06: Use RDFWriter.source()
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit 95cf81c9fd9eca4d2c2c092384acd770bc1e0611
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Thu Mar 24 12:53:53 2022 +0000
Use RDFWriter.source()
---
source/documentation/io/rdf-output.md | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/source/documentation/io/rdf-output.md b/source/documentation/io/rdf-output.md
index fe1d11a53..fe2791c8d 100644
--- a/source/documentation/io/rdf-output.md
+++ b/source/documentation/io/rdf-output.md
@@ -270,10 +270,9 @@ otherwise noted, the setting applies to both Turtle and TriG.
```
and in code:
```
- RDFWriter.create()
+ RDFWriter.source(model)
.set(RIOT.symTurtleDirectiveStyle, "sparql")
.lang(Lang.TTL)
- .source(model)
.output(System.out);
```
##### _Base URI_
[jena-site] 04/06: JENA-2298, JENA-2299: Updates for RDFParser and RDFWriter
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit d917f662ca059597864b2aff91dee0f26ddc73fa
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Wed Mar 2 23:34:42 2022 +0000
JENA-2298, JENA-2299: Updates for RDFParser and RDFWriter
---
source/documentation/io/rdf-input.md | 14 ++++++++------
source/documentation/io/streaming-io.md | 2 +-
2 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/source/documentation/io/rdf-input.md b/source/documentation/io/rdf-input.md
index c6bec4cf2..dfe184527 100644
--- a/source/documentation/io/rdf-input.md
+++ b/source/documentation/io/rdf-input.md
@@ -118,14 +118,16 @@ Detailed control over the setup of the parsing process is provided by
For example, to read Trig data, and set the error handler specially,
+ Dataset dataset;
// The parsers will do the necessary character set conversion.
try (InputStream in = new FileInputStream("data.some.unusual.extension")) {
- RDFParser.create()
- .source(in)
- .lang(RDFLanguages.TRIG)
- .errorHandler(ErrorHandlerFactory.errorHandlerStrict)
- .base("http://example/base")
- .parse(noWhere);
+ dataset =
+ RDFParser.create()
+ .source(in)
+ .lang(RDFLanguages.TRIG)
+ .errorHandler(ErrorHandlerFactory.errorHandlerStrict)
+ .base("http://example/base")
+ .toDataset(noWhere);
}
## Logging
diff --git a/source/documentation/io/streaming-io.md b/source/documentation/io/streaming-io.md
index df6a9f4ea..dc93bbed3 100644
--- a/source/documentation/io/streaming-io.md
+++ b/source/documentation/io/streaming-io.md
@@ -22,7 +22,7 @@ into your project and passing an appropriate `InputStream`/`OutputStream`
implementation to Jena code e.g.
InputStream input = new ZstdCompressorInputStream(....);
- RDFParser.source(input).lang(Lang.NQ).parse(graph);
+ Graph graph = RDFParser.source(input).lang(Lang.NQ).toGraph();
## StreamRDF
[jena-site] 01/06: Update for GSP and quads
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit 1435ccb54511138bc3283d09a10dbf754b23d8ee
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sun Feb 6 18:02:11 2022 +0000
Update for GSP and quads
---
.../fuseki2/fuseki-config-endpoint.md | 8 ++--
source/documentation/fuseki2/fuseki-embedded.md | 43 +++++++++++-----------
2 files changed, 25 insertions(+), 26 deletions(-)
diff --git a/source/documentation/fuseki2/fuseki-config-endpoint.md b/source/documentation/fuseki2/fuseki-config-endpoint.md
index 3813a6c82..42996def2 100644
--- a/source/documentation/fuseki2/fuseki-config-endpoint.md
+++ b/source/documentation/fuseki2/fuseki-config-endpoint.md
@@ -172,7 +172,7 @@ form with field "update=".
A GSP operation has `?default` or `?graph=`.
-Quads operations have no query string and a have a `Content-Type` for a data in
+Quads operations are also provided by GSP endpoints when there is no query string and a have a `Content-Type` for a data in
a RDF triples or quads syntax.
So, for example "GET /dataset" is a request to get all the triples and quads in the
@@ -257,10 +257,10 @@ GET, POST, PUT (not DELETE, that would be the dataset itself),
and the request or response is one of the syntaxes for datasets
(TriG, N-Quads, JSON-LD, TriX).
-Fuseki also provides [/documentation/io/rdf-binary.html](RDF Binary) for triples and quads.
+The DSP ("Dataset Store Protocol") operations provide operations similar to GSP
+but operating on the dataset, not a speciifc graph.
-The quads extension applies when there is no `?default` or `?graph`.
-`GET` fetches the dataset in quads format, and `PUT` and `POST` take quads format data (N-Quads and Trig).
+Fuseki also provides [/documentation/io/rdf-binary.html](RDF Binary) for triples and quads.
## Context
diff --git a/source/documentation/fuseki2/fuseki-embedded.md b/source/documentation/fuseki2/fuseki-embedded.md
index a74ed42df..c39b44875 100644
--- a/source/documentation/fuseki2/fuseki-embedded.md
+++ b/source/documentation/fuseki2/fuseki-embedded.md
@@ -91,7 +91,7 @@ To silence logging from Java, try:
## Building a server {#build}
-A ``FusekiServer`` is built by creating a configuration,
+A `FusekiServer` is built by creating a configuration,
building the server, then running it. The application needs to start
the server.
@@ -112,16 +112,17 @@ dataset that can be updated via HTTP.
...
server.stop() ;
+The services are avilable on a named endpoint and also on the dataset URL itself.
+
URLs:
-| Service | Endpoint |
-|---------|----------|
-| SPARQL Query | ``http://host:3330/ds/query`` |
-| SPARQL Query | ``http://host:3330/ds/sparql`` |
-| SPARQL Update | ``http://host:3330/ds/update`` |
-| File upload | ``http://host:3330/ds/update`` |
-| GSP read-write | ``http://host:3330/ds/data`` |
-| Read-write quads | ``http://host:3330/ds`` |
+| Service | Endpoint1 | Endpoint2 |
+|---------|----------|------------|
+| SPARQL Query | `http://host:3330/ds/query` | `http://host:3330/ds` |
+| SPARQL Query | `http://host:3330/ds/sparql` | `http://host:3330/ds` |
+| SPARQL Update | `http://host:3330/ds/update` | `http://host:3330/ds` |
+| GSP read-write | `http://host:3330/ds/data` | `http://host:3330/ds` |
+
"GSP" = SPARQL Graph Store Protocol
@@ -132,16 +133,15 @@ set that is read-only over HTTP. The application can still update the dataset.
Dataset ds = ... ;
FusekiServer server = FusekiServer.create()
.port(3332)
- .add("/ds", ds, true)
+ .add("/ds", ds, false)
.build() ;
server.start() ;
-| Service | Endpoint |
-|---------|----------|
-| SPARQL Query | ``http://host:3332/ds/query`` |
-| SPARQL Query | ``http://host:3332/ds/sparql`` |
-| GSP read-only | ``http://host:3332/ds/data`` |
-| GET quads | ``http://host:3332/ds`` |
+| Service | Endpoint | Endpoint2 |
+|---------|----------|-----------|
+| SPARQL Query | `http://host:3332/ds/query` | `http://host:3332/ds` |
+| SPARQL Query | `http://host:3332/ds/sparql` | `http://host:3332/ds` |
+| GSP read-only | `http://host:3332/ds/data` | `http://host:3332/ds` |
### Example 3
@@ -149,7 +149,7 @@ Different combinations of services and endpoint names can be given using a `Data
DatasetGraph dsg = ... ;
DataService dataService = new DataService(dsg) ;
- dataService.addEndpoint(OperationName.Quads_RW, "");
+ dataService.addEndpoint(OperationName.GSP_RW, "");
dataService.addEndpoint(OperationName.Query, "");
dataService.addEndpoint(OperationName.Update, "");
@@ -159,15 +159,14 @@ Different combinations of services and endpoint names can be given using a `Data
.build() ;
server.start() ;
-This setup puts all the operation on the dataset URL. The ``Content-type`` and any query
+This setup puts all the operation on the dataset URL. The `Content-type` and any query
string is used to determine the operation.
| Service | Endpoint |
|---------|----------|
-| SPARQL Query | ``http://host:3332/ds`` |
-| SPARQL Update | ``http://host:3332/ds`` |
-| GSP read-only | ``http://host:3332/ds`` |
-| GET/POST quads | ``http://host:3332/ds`` |
+| SPARQL Query | `http://host:3332/ds` |
+| SPARQL Update | `http://host:3332/ds` |
+| GSP read-write | `http://host:3332/ds` |
### Example 4
[jena-site] 02/06: Split GSP and DSP
Posted by an...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
andy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit a8eec3a5f3ae2fb40b3c43d63f12406c58ecb12f
Author: Andy Seaborne <an...@apache.org>
AuthorDate: Sun Feb 6 18:02:48 2022 +0000
Split GSP and DSP
---
source/documentation/sparql-apis/__index.md | 22 ++++++++++++++++++----
1 file changed, 18 insertions(+), 4 deletions(-)
diff --git a/source/documentation/sparql-apis/__index.md b/source/documentation/sparql-apis/__index.md
index d137820a0..f0192c148 100644
--- a/source/documentation/sparql-apis/__index.md
+++ b/source/documentation/sparql-apis/__index.md
@@ -11,6 +11,7 @@ The SPARQL specifications provide
[query](https://www.w3.org/TR/sparql11-query/),
[update](https://www.w3.org/TR/sparql11-update/) and the
[graph store protocol](https://www.w3.org/TR/sparql11-http-rdf-update/) (GSP).
+In addition, Jena provided store operations for named graph formats.
For working with RDF data:
@@ -33,6 +34,7 @@ and for SPARQL,
| `UpdateExecution` | `UpdateExec` |
| `ResultSet` | `RowSet` |
| `ModelStore` | `GSP` |
+| `ModelStore` | `DSP` |
Jena provides a single interface, [`RDFConnection`](../rdfconnection) for
working with local and remote RDF data using these protocols in a unified way.
@@ -57,8 +59,9 @@ classes.
`UpdateProcessor` is a legacy name for `UpdateExecution`
-`GSP` provides the SPARQL Graph Store Protocol, including extensions for sending
-and receiving datasets, rather than individual graphs.
+`GSP` provides the SPARQL Graph Store Protocol, and 'DSP' (Dataset Store
+Protocol) provides for sending and receiving datasets, rather than individual
+graphs.
Both API and GPI provide builders for detailed setup, particularly for remote
usage over HTTP and HTTPS where detailed control of the HTTP requests is
@@ -69,7 +72,9 @@ common usage patterns are retained in `QueryExecutionFactory`,
`UpdateExecutionFactory`. Note that any methods that involved Apache HttpClient
objects have been removed.
-## Changes from Jena 4.2.0 to Jena 4.3.0 {#changes}
+## Changes from Jena 4.2.0 {#changes}
+
+### Changes at Jena 4.3.0 {#changes430}
* Execution objects have a companion builder. This is especially important of
HTTP as there many configuration options that may be needed. Local use is
@@ -79,7 +84,7 @@ objects have been removed.
* HTTP usage provided by the JDK `java.net.http` package, with challenge-based
authentication provided on top by Jena. [See the authentiucation documentation](./http-auth.html).
-* Authentication support is uniformly applied to query, update, GSP and `SERVICE`.
+* Authentication support is uniformly applied to query, update, GSP, DSP and `SERVICE`.
* HTTP/2 support
@@ -107,6 +112,15 @@ objects have been removed.
`ModelStore` are the replacement for remote operations. `RDFConnection` and
`RDFLink` provide APIs.
+### Changes at Jena 4.5.0 {#changes450}
+
+Separate the dataset operations from the graph operations.
+
+* GSP - SPARQL Graph Store Protocol
+
+* DSP - Dataset Store Protocol: HTTP GET, POST, PUT operations on the datatse,
+e.g. quad formats like TriG.
+
## Substitution
All query and update builders provide operations to use a query and substitute