commit | ec720f4382cfb862bd2fb2e9284db3669f4550a5 | [log] [tgz] |
---|---|---|
author | Radu Cotescu <radu@apache.org> | Tue Jul 07 18:43:04 2020 +0200 |
committer | Radu Cotescu <radu@apache.org> | Tue Jul 07 18:43:04 2020 +0200 |
tree | ef88a7339feed838fc3a519036dc65a3575b6c29 | |
parent | 06da008d06e46a0601e1c976ba268cebc85afce1 [diff] |
[maven-release-plugin] prepare for next development iteration
This module is part of the Apache Sling project.
Bundle implementing the Sling API ServletResolver.
Version 2.7.0 of this bundle has added support for executing bundled scripts (precompiled or not), through the org.apache.sling.servlets.resolver.bundle.tracker
API.
Although traditionally scripts are deployed as content stored in the search paths of a Sling instance, this leaves very little room for script evolution in a backwards compatible way. Furthermore, versioning scripts is a difficult process if the only mechanism to do this is the sling:resourceType
property, since consumers (content nodes or other resource types) have then to explicitly mention the version expected to be executed.
Scripts should not be considered content, since their only purpose is to actually generate the rendering for a certain content structure. They are not consumed by users, but rather by the Sling Engine itself and have very little meaning outside this context. As such, scripts should be handled like code:
Being built around a BundleTrackerCustomizer
[2], the org.apache.sling.servlets.resolver.bundle.tracker.internal.BundledScriptTracker
monitors the instance's bundles wired to the org.apache.sling.servlets.resolver
bundle and scans the ones providing a sling.servlet
capability [3]. The wiring is created by placing a Require-Capability
header in the bundles that provide the sling.servlet
capability:
osgi.extender;filter:="(&(osgi.extender=sling.scripting)(version>=1.0.0)(!(version>=2.0.0)))"
A sling.servlet
capability has almost the same attributes as the properties required to register a servlet on the Sling platform [4]:
sling.servlet.resourceTypes:List
- mandatory; defines the provided resource type; its value is a list of resource typessling.servlet.selectors:List
- optional; defines the list of selectors that this resource type can handle;sling.servlet.extensions:List
- optional; defines the list of extensions that this resource type can handle;sling.servlet.methods:List
- optional; defines the list of HTTP methods that this resource type can handle;version:Version
- optional; defines the version of the provided resourceType
;extends:String
- optional; defines which resource type it extends; the version range of the extended resource type is defined in a Require-Capability
.The BundledScriptTracker
will register a Sling Servlet with the appropriate properties for each sling.servlet
capability. The servlets will be registered using the bundle context of the bundle providing the sling.servlet
capability, making sure to expose the different versions of a resource type as part of the registered servlet's properties. On top of this, a plain resource type bound servlet will also be registered, which will be automatically wired to the highest version of the resourceType
. All the mentioned service registrations are managed automatically by the BundledScriptTracker
.
Short answer: exactly like you deploy your code, preferably right next to it. Pack your scripts using the following conventions:
src/main/resources/javax.script
folder in your bundle (if you want to embed the scripts as they are) or just put the scripts in src/main/scripts
if you want to precompiled them (e.g. JSP and HTL);resourceType
;resourceType
folder you can optionally create a Version
folder; this has to follow the Semantic Versioning constraints described at [1];scriptingbundle-maven-plugin
to your build section and add its required properties in the maven-bundle-plugin
's instructions (check [these examples](https://github.com/apache/sling-org-apache-sling-scripting -bundle-tracker-it/tree/master/examples/));mvn clean sling:install
.The integration tests for bundled scripts are provided by the [org.apache.sling.scripting.bundle.tracker.it
](https://github.com/apache /sling-org-apache-sling-scripting-bundle-tracker-it) project.
[1] - https://semver.org/
[2] - https://osgi.org/javadoc/r6/core/org/osgi/util/tracker/BundleTrackerCustomizer.html
[3] - https://osgi.org/download/r6/osgi.core-6.0.0.pdf, Page 41, section 3.3.3 “Bundle Capabilities”
[4] - https://sling.apache.org/documentation/the-sling-engine/servlets.html#servlet-registration-1
[5] - https://sling.apache.org/documentation/the-sling-engine/url-to-script-resolution.html