Staging ground for the Sling 10 release notes
The Sling 10 release is focused on adding improved support for newer Java versions, but we managed to sneak in a couple of improvements as well. Please see the full details below.
Java 9 and 10 support
Sling now fully supports Java 9, with the integration tests running on Java 8 and Java 9 side-by-side. Java 10 has received the same attention in terms of testing, but since it is not officially released we can not declare it as fully supported.
Change of artifactId for the main Sling artifact
To better reflect its role, the old Sling launchpad has been renamed to the Sling starter. The name reflects that it's been used to quickly start working with Sling and also that it's aimed to start your appetite of working with Sling.
The Maven coordinates have changed from org.apache.sling:org.apache.sling.launchpad to org.apache.sling:org.apache.sling.starter .
Migrated from tika-bundle to tika-parsers
In order to keep the Slingstart artifact size under control, we no longer embed the tika-bundle uber-artifact. Instead, we include tika-parsers and explicitly support parsing of PDF documents via PDFBox. Consumers that desire to parse other document types can include other dependencies as OSGi bundle as needed.
Discovering parsers that do not work can be done by starting Sling with the additional -Dorg.apache.tika.service.error.warn=true argument. See also Troubleshooting Tika .
The default Slingstart now is 32% smaller, dropping from 98MB to 67MB.
Direct access to a DataStore binary when the repository allows it
Sling is now able to directly redirect clients to secure URLs of DataStore binaries when the underlying repository allows it. This feature is intended to allow quick serving of content from remote services such as S3 without having to stream the binaries from Sling.
For more details see OAK-6575 - Provide a secure external URL to a DataStore binary. Closed , SLING-7140 - Support redirects to URLs provided by the underlying datastore. Resolved and Ian Boston's quick configuration notes.
Exception stack traces now contain the originating bundle
When an exception is logged, the Bundle-SymbolicName and the version of the bundle containing each stack trace element are shown. The intent is to simplify debugging and support when logs are available but bundle versions are not known.
See the logging documentation page for more details.
Update to Oak 1.6.8
We use the latest stable Oak version from the 1.6 stream, bringing in over 140 fixes and improvements. See the full list of resolved issues for more details.
Service user console added
Working with service users is now made simpler by a new Web Console addition which allows inspecting and managing Service Users.
This console page is available as a standalone artifact at the org.apache.sling:org.apache.sling.serviceuser.webconsole Maven coordinates.
Service user privilege declaration based on principal names
Service users may now be declared as having a list of principal names which exhaustively map the privileges they contain. This style of declaration is preferred since it reduces redundancy and adds clarity to the privileges used by a certain service user. Pre-authentication can also lead to performance improvements.
The OSGi configuration differs from the standard model by using an array to hold the principal names, as opposed to a single value. An example can be seen below
See the Oak documentation on pre-authentication for more details.
Enhancements to the repoinit language
We have added several improvements to repoinit, including
- mixins in "create path" statements
- repository-level permissions
- disabling service users
- specifying oak restrictions
See the Repository Initialization documentation for more details.
Support for mounting JSON files in the bundle resource provider
The bundle resource provider now allows adding JSON files which hold properties for various nodes.
The feature can be enabled by adding a directive to the header entry:
propsJSON=json. All files having the configured extension will be treat as JSON files containing properties for the resources.
It is possible to have a file and a JSON file for the same resource, like
The json file will then contain properties (value map) for the resource, this includes defining the resource type. Such a json file can also contain a deep tree of objects like:
|SLING-7368||Add Service User OSGi Console||Jan 09, 2018||Jan 19, 2018||Dan Klco||Dan Klco||Closed||Fixed|
|SLING-7365||Some JSP tests fail under Java 10 - parameterized types are only available if source level is 1.5 or greater||Jan 08, 2018||Jan 19, 2018||Konrad Windszus||Konrad Windszus||Closed||Fixed|
|SLING-7140||Support redirects to URLs provided by the underlying datastore.||Sep 19, 2017||Feb 03, 2018||Ian Boston||Ian Boston||Resolved||Fixed|
|SLING-7068||Upgrade to Oak 1.6.4||Aug 21, 2017||Aug 21, 2017||Robert Munteanu||Robert Munteanu||Resolved||Fixed|
|SLING-7066||Support mixins in repoinit "create path" statements||Aug 21, 2017||Feb 03, 2018||Timothee Maret||Bertrand Delacretaz||Closed||Fixed|
|SLING-7061||Access control setup of repository-level permissions (i.e. null path)||Aug 18, 2017||Feb 03, 2018||Timothee Maret||angela||Closed||Fixed|
|SLING-6984||Allow to disable service user||Jun 26, 2017||Feb 03, 2018||Timothee Maret||Timothee Maret||Closed||Fixed|
|SLING-6963||Service user declaration based on principal names||Jun 15, 2017||Aug 14, 2017||Karl Pauls||angela||Closed||Fixed|
|SLING-6878||Bundle resource provider: support mounting of JSON files||May 24, 2017||Feb 05, 2018||Carsten Ziegeler||Carsten Ziegeler||Closed||Fixed|
|SLING-6422||Allow for specifying oak restrictions with repoinit||Dec 21, 2016||Feb 03, 2018||Bertrand Delacretaz||Nitin Nizhawan||Closed||Fixed|
|SLING-3049||Make Logback Stacktrace Packaging data support OSGi aware||Sep 10, 2013||Feb 03, 2018||Chetan Mehrotra||Chetan Mehrotra||Closed||Fixed|