Skip to content
This repository has been archived by the owner on Aug 26, 2020. It is now read-only.

eclipse/rdf4j#2235 first draft of release notes for 3.3.0 #161

Merged
merged 14 commits into from
Jul 24, 2020
Merged
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
2 changes: 1 addition & 1 deletion site/content/documentation/programming/repository.md
Original file line number Diff line number Diff line change
Expand Up @@ -1094,7 +1094,7 @@ public class QueryExplainExample {
" BIND(<http://example.com/peter> as ?person)",
" ?person a foaf:Person .",
" {",
" BIND(<http://example.com/peter> as ?person)",
" BIND(<http://example.com/peter> as ?person)",
" ?person (foaf:knows | ^foaf:knows)* ?friend.",
" } UNION {",
" ?friend foaf:age ?age",
Expand Down
18 changes: 18 additions & 0 deletions site/content/documentation/programming/shacl.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,14 @@ As of writing this documentation the following features are supported.
- `sh:maxInclusive`
- `sh:in`
- `sh:deactivated`
- `sh:hasValue`
- `dash:hasValueIn`
- `sh:target` for use with DASH targets
- `rsx:targetShape`

DASH and RSX features need to be explicitly enabled, for instance with `setDashDataShapes(true)` and
`setEclipseRdf4jShaclExtensions(true)`. These are currently experimental features. For more information
about the RSX features, see the RSX section of this document.

Implicit `sh:targetClass` is supported for nodes that are `rdfs:Class` and either of `sh:PropertyShape` or `sh:NodeShape`. Validation for all nodes,
equivalent to `owl:Thing` or `rdfs:Resource` in an environment with a reasoner, can be enabled by setting `setUndefinedTargetValidatesAllSubjects(true)`.
Expand Down Expand Up @@ -303,6 +311,16 @@ sailRepository.shutDown();
By default the ShaclSail supports the simple rdfs:subClassOf reasoning required by the W3C recommendation. There is no
support for `sh:entailment`, however the entire reasoner can be disabled with `setRdfsSubClassReasoning(false)`.

# RSX - Eclipse RDF4J SHACL Extensions
RDF4J has seen a need to develop its own extension the W3C SHACL Recommendation in order to support new
and innovative features. We always strive to collaborate with the community when developing these features.

RSX currently contains `rsx:targetShape` which will allow a Shape to be the target for your constraints. This means
that it will be possible to model more complex use-cases like "all norwegian companies with 10 or more employees,
a revenue greater than or equal to 6 million NOK or valued at 23 million or above are required to have a registered
accountant". This also allows for considerably faster implementations than what is currently possible with SPARQL Targets.

The RSX specification will be published soon together with the limited support for `rsx:targetShape` in 3.3.0 (`sh:or`, `sh:and`, `sh:hasValue`, `dash:hasValueIn`, `sh:path`, `sh:property`).

# Logging and debugging

Expand Down
29 changes: 12 additions & 17 deletions site/content/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,29 +5,18 @@ toc: true

You can either retrieve RDF4J via Apache Maven, or download the SDK or onejar directly.

# RDF4J 3.2.3 (latest)
# RDF4J 3.3.0 (latest)

RDF4J 3.2.3 is our latest stable release. It requires Java 8. For details on what’s new and how to upgrade, see the [release and upgrade notes](/release-notes/3.2.3).
RDF4J 3.3.0 is our latest stable release. It requires Java 8. For details on what’s new and how to upgrade, see the [release and upgrade notes](/release-notes/#3-3-0).

- [RDF4J 3.2.3 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-sdk.zip)<br/>
- [RDF4J 3.3.0 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-sdk.zip)<br/>
Full Eclipse RDF4J SDK, containing all libraries, RDF4J Server, Workbench, and Console applications, and Javadoc API.

- [RDF4J 3.2.3 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-onejar.jar)<br/>
- [RDF4J 3.3.0 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-onejar.jar)<br/>
Single jar file for easy inclusion of the full RDF4J toolkit in your Java project.

- [RDF4J artifacts](https://search.maven.org/search?q=org.eclipse.rdf4j) on the [Maven Central Repository](http://search.maven.org/)

# RDF4J 3.3.0 Milestone 1

RDF4J 3.3.0-M1 is the first milestone build for the upcoming 3.3.0 release. It requires Java 8.

- [RDF4J 3.3.0-M2 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-M2-sdk.zip)<br/>
Full Eclipse RDF4J SDK, containing all libraries, RDF4J Server, Workbench, and Console applications, and Javadoc API.

- [RDF4J 3.3.0-M2 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-M2-onejar.jar)<br/>
Single jar file for easy inclusion of the full RDF4J toolkit in your Java project.


# Apache Maven

You can include RDF4J as a Maven dependency in your Java project by including the following BOM (Bill-of-Materials):
Expand All @@ -37,7 +26,7 @@ You can include RDF4J as a Maven dependency in your Java project by including th
<dependency>
<groupId>org.eclipse.RDF4J</groupId>
<artifactId>rdf4j-bom</artifactId>
<version>3.2.3</version>
<version>3.3.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
Expand All @@ -58,6 +47,12 @@ which artifacts RDF4J provides.

# Older releases

## RDF4J 3.2

- [RDF4J 3.2.3 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-sdk.zip)
- [RDF4J 3.2.3 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-onejar.jar)


## RDF4J 3.1

- [RDF4J 3.1.4 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.1.4-sdk.zip)
Expand Down Expand Up @@ -92,7 +87,7 @@ To include nightly snapshot builds in your project, add this repository to your
</repository>
</repositories>

Then use RDF4J dependencies as normal, using 3.2.3-SNAPSHOT as the version number.
Then use RDF4J dependencies as normal, using 3.3.1-SNAPSHOT or 3.4.0-SNAPSHOT as the version number.

# Archives

Expand Down
24 changes: 24 additions & 0 deletions site/content/news/rdf4j-330.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: "RDF4J 3.3.0 released"
date: 2020-07-24
layout: "single"
categories: ["news"]
---
We are very pleased to announce that RDF4J 3.3.0 is now available. RDF4J 3.3.0 is a minor release with over 30 issues fixed, including several major new features and improvements. Some of the highlights:

- Per-transaction configuration settings
- More powerful SPARQL functions
- Many new SHACL features
- RDF Containers support
- Java 13 and 14 support
- Many more features, bug fixes and performance improvements

A shout out to

For more details, have a look at the [release notes](/release-notes/3.3.0).
<!--more-->
### Links

- [Download RDF4J](/download/)
- [release notes](/release-notes/3.3.0).

31 changes: 31 additions & 0 deletions site/content/release-notes/3.3.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: "3.3.0"
---
RDF4J 3.3.0 is a minor release [TODO]

It is backward compatible with previous RDF4J releases.

Highlights:

- A new mechanism for providing per-transaction configuration settings is now available in the Repository and SAIL APIs. Currently used by the [ShaclSail](https://rdf4j.org/documentation/programming/shacl/#performance).
- The ShaclSail now supports sh:inversePath (limited to single predicates) and sh:hasValue.
- [Custom SPARQL functions](https://rdf4j.org/javadoc/3.3.0/org/eclipse/rdf4j/query/algebra/evaluation/function/TupleFunction.html) now allow inspection of the triplestore state during evaluation.
- Improved query plan rendering.
- Utility functions for working with [RDF Containers](https://rdf4j.org/javadoc/3.3.0/org/eclipse/rdf4j/model/util/RDFContainers.html) (Alt, Bag, Seq) added.
- Experimental support for various new SHACL features ([DASH and RSX](https://rdf4j.org/documentation/programming/shacl/#supported-shacl-features))
- Elasticsearch, Lucene and Solr upgrades
- Support for Java 13 and 14
- Performance improvements and bug fixes

For a complete overview, see [all issues fixed in 3.3.0](https://github.com/eclipse/rdf4j/milestone/51?closed=1).

## Upgrade notes

This release is binary compatible with previous releases.

RDF4J 3.1.x and 3.2.x implicitly included the jackson-core, jackson-databind and jackson-annotations dependencies when using the `rdf4j-rio-api` maven artifact. In version 3.3.0, these dependencies are explicitly excluded.
Projects relying on this unintended behavior should check if they need to add these jackson dependencies to their build files.

## Acknowledgements

This release was made possible by contributions from Andreas Schwarte, Bart Hanssens, Elad Shaked, Gaurav Aggarwal, Gauri Bhatanagar, Håvard M. Ottestad, Jeen Broekstra, Navdha Agarwal, Pavel Mihailov, Prince Sachdeva, Raghav Rathi, Reeshabh Kumar Ranjan, Sakshi Saini, and Shubhi Jain.
Loading