Release version 5.3.1

Author: namedgraph

CHANGELOG.md

@@ -1,3 +1,19 @@
+## [5.3.1] - 2026-03-29
+### Added
+- Namespace endpoint handles queries with relative URIs, resolved against the endpoint URL (#276 related)
+- GRDDL filters loaded using `ServiceLoader` for better extensibility
+- HTTP tests for namespace endpoint relative URI queries
+- HTTP test for package stylesheet deduplication
+
+### Changed
+- `XSLTMasterUpdater` refactored: `regenerateMasterStylesheet()` replaced with `addPackageImport()`/`removePackageImport()` methods that preserve existing stylesheet content (#275)
+- Resolving relative URLs in XHTML literals against the document's base URI (#276)
+- Removed unused XSLT params
+- `make tests` command added to Makefile
+
+### Fixed
+- Fixed `XSLTMasterUpdater` to avoid duplicate `xsl:import` statements when installing packages (#275)
+
 ## [5.3.0] - 2026-03-05
 ### Added
 - Class-based navigation (#270)

Makefile

@@ -1,4 +1,4 @@
-.PHONY: sef drop cert release
+.PHONY: sef drop cert release tests
 
 # Generate Saxon-JS SEF files for client-side XSLT transformations
 sef:
@@ -10,8 +10,12 @@ drop:
 
 # Generate server SSL certificate using the .env config
 cert:
-	./bin/server-cert-gen.sh .env nginx ssl
+	server-cert-gen.sh .env nginx ssl
 
 # Run the full Maven release process (prepare, deploy to Sonatype, merge to master/develop)
 release:
 	./release.sh
+
+# Run HTTP tests using owner and secretary certificates with passwords from secrets/
+tests:
+	cd http-tests && ./run.sh ../ssl/owner/cert.pem $$(cat ../secrets/owner_cert_password.txt) ../ssl/secretary/cert.pem $$(cat ../secrets/secretary_cert_password.txt)

http-tests/admin/packages/install-package-422.sh

@@ -13,6 +13,6 @@ curl -k -w "%{http_code}\n" -o /dev/null -s \
   -E "$OWNER_CERT_FILE":"$OWNER_CERT_PWD" \
   -X POST \
   -H "Content-Type: application/x-www-form-urlencoded" \
-  --data-urlencode "package-uri=https://packages.linkeddatahub.com/nonexistent/#package" \
+  --data-urlencode "package-uri=${END_USER_BASE_URL}static/nonexistent/#package" \
   "${ADMIN_BASE_URL}packages/install" \
 | grep -q "$STATUS_UNPROCESSABLE_ENTITY"

http-tests/admin/packages/install-package-stylesheet-no-duplicate.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+initialize_dataset "$END_USER_BASE_URL" "$TMP_END_USER_DATASET" "$END_USER_ENDPOINT_URL"
+initialize_dataset "$ADMIN_BASE_URL" "$TMP_ADMIN_DATASET" "$ADMIN_ENDPOINT_URL"
+purge_cache "$END_USER_VARNISH_SERVICE"
+purge_cache "$ADMIN_VARNISH_SERVICE"
+purge_cache "$FRONTEND_VARNISH_SERVICE"
+
+# Clean up any leftover package stylesheet files from previous test runs
+docker compose exec -T linkeddatahub rm -rf /usr/local/tomcat/webapps/ROOT/static/com/linkeddatahub/packages/skos 2>/dev/null || true
+docker compose exec -T linkeddatahub sed -i '/linkeddatahub\/packages\/skos\/layout.xsl/d' /usr/local/tomcat/webapps/ROOT/static/xsl/layout.xsl 2>/dev/null || true
+
+# Tomcat caches static files with default cacheTtl=5000ms (5 seconds)
+# See: https://tomcat.apache.org/tomcat-10.1-doc/config/resources.html#Attributes
+default_ttl=5
+
+# test package URI (SKOS package)
+package_uri="https://packages.linkeddatahub.com/skos/#this"
+
+# first install
+install-package.sh \
+  -b "$END_USER_BASE_URL" \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  --package "$package_uri"
+
+# Wait for Tomcat's static resource cache to expire
+sleep $default_ttl
+
+# verify exactly one import after first install
+import_count=$(curl -k -s "${END_USER_BASE_URL}static/xsl/layout.xsl" \
+  | grep -c "com/linkeddatahub/packages/skos/layout.xsl" || true)
+if [ "$import_count" -ne 1 ]; then
+  exit 1
+fi
+
+# second install (same package)
+install-package.sh \
+  -b "$END_USER_BASE_URL" \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  --package "$package_uri"
+
+# Wait for Tomcat's static resource cache to expire
+sleep $default_ttl
+
+# verify still exactly one import after second install (deduplication guard)
+import_count=$(curl -k -s "${END_USER_BASE_URL}static/xsl/layout.xsl" \
+  | grep -c "com/linkeddatahub/packages/skos/layout.xsl" || true)
+if [ "$import_count" -ne 1 ]; then
+  exit 1
+fi
+
+# cleanup
+uninstall-package.sh \
+  -b "$END_USER_BASE_URL" \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  --package "$package_uri"

http-tests/run.sh

@@ -7,9 +7,9 @@ if [ "$#" -ne 4 ]; then
   exit 1
 fi
 
-export OWNER_CERT_FILE="$1"
+export OWNER_CERT_FILE="$(realpath "$1")"
 export OWNER_CERT_PWD="$2"
-export SECRETARY_CERT_FILE="$3"
+export SECRETARY_CERT_FILE="$(realpath "$3")"
 export SECRETARY_CERT_PWD="$4"
 
 export STATUS_OK=200

http-tests/sparql-protocol/query/GET-ns-relative-uri.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+initialize_dataset "$END_USER_BASE_URL" "$TMP_END_USER_DATASET" "$END_USER_ENDPOINT_URL"
+initialize_dataset "$ADMIN_BASE_URL" "$TMP_ADMIN_DATASET" "$ADMIN_ENDPOINT_URL"
+purge_cache "$END_USER_VARNISH_SERVICE"
+purge_cache "$ADMIN_VARNISH_SERVICE"
+purge_cache "$FRONTEND_VARNISH_SERVICE"
+
+# create class in the namespace ontology
+
+namespace_doc="${END_USER_BASE_URL}ns"
+namespace="${namespace_doc}#"
+ontology_doc="${ADMIN_BASE_URL}ontologies/namespace/"
+class="${namespace}NewClass"
+
+add-class.sh \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  -b "$ADMIN_BASE_URL" \
+  --uri "$class" \
+  --label "New class" \
+  "$ontology_doc"
+
+# clear ontology from memory
+
+clear-ontology.sh \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  -b "$ADMIN_BASE_URL" \
+  --ontology "$namespace"
+
+# query using relative URI - <#NewClass> should resolve to ${namespace}NewClass
+
+curl -k -s -G \
+  -E "$OWNER_CERT_FILE":"$OWNER_CERT_PWD" \
+  -H "Accept: application/sparql-results+xml" \
+  "${namespace_doc}" \
+  --data-urlencode "query=SELECT * { <#NewClass> ?p ?o }" \
+| grep '<literal>New class</literal>' > /dev/null

http-tests/sparql-protocol/query/POST-ns-relative-uri.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+initialize_dataset "$END_USER_BASE_URL" "$TMP_END_USER_DATASET" "$END_USER_ENDPOINT_URL"
+initialize_dataset "$ADMIN_BASE_URL" "$TMP_ADMIN_DATASET" "$ADMIN_ENDPOINT_URL"
+purge_cache "$END_USER_VARNISH_SERVICE"
+purge_cache "$ADMIN_VARNISH_SERVICE"
+purge_cache "$FRONTEND_VARNISH_SERVICE"
+
+# create class in the namespace ontology
+
+namespace_doc="${END_USER_BASE_URL}ns"
+namespace="${namespace_doc}#"
+ontology_doc="${ADMIN_BASE_URL}ontologies/namespace/"
+class="${namespace}NewClass"
+
+add-class.sh \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  -b "$ADMIN_BASE_URL" \
+  --uri "$class" \
+  --label "New class" \
+  "$ontology_doc"
+
+# clear ontology from memory
+
+clear-ontology.sh \
+  -f "$OWNER_CERT_FILE" \
+  -p "$OWNER_CERT_PWD" \
+  -b "$ADMIN_BASE_URL" \
+  --ontology "$namespace"
+
+# query using relative URI - <#NewClass> should resolve to ${namespace}NewClass
+
+curl -k -s -X POST \
+  -E "$OWNER_CERT_FILE":"$OWNER_CERT_PWD" \
+  -H "Accept: application/sparql-results+xml" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  "${namespace_doc}" \
+  --data-urlencode "query=SELECT * { <#NewClass> ?p ?o }" \
+| grep '<literal>New class</literal>' > /dev/null

pom.xml

@@ -3,7 +3,7 @@
 
     <groupId>com.atomgraph</groupId>
     <artifactId>linkeddatahub</artifactId>
-    <version>5.3.0</version>
+    <version>5.3.1</version>
     <packaging>${packaging.type}</packaging>
 
     <name>AtomGraph LinkedDataHub</name>
@@ -46,7 +46,7 @@
         <url>https://github.com/AtomGraph/LinkedDataHub</url>
         <connection>scm:git:git://github.com/AtomGraph/LinkedDataHub.git</connection>
         <developerConnection>scm:git:git@github.com:AtomGraph/LinkedDataHub.git</developerConnection>
-        <tag>linkeddatahub-5.3.0</tag>
+        <tag>linkeddatahub-5.3.1</tag>
     </scm>
 
     <repositories>

src/main/java/com/atomgraph/linkeddatahub/Application.java

@@ -70,7 +70,8 @@
 import com.atomgraph.client.util.XsltResolver;
 import com.atomgraph.linkeddatahub.client.GraphStoreClient;
 import com.atomgraph.linkeddatahub.client.filter.ClientUriRewriteFilter;
-import com.atomgraph.linkeddatahub.client.filter.grddl.YouTubeGRDDLFilter;
+import com.atomgraph.linkeddatahub.client.filter.JSONGRDDLFilter;
+import com.atomgraph.linkeddatahub.client.filter.JSONGRDDLFilterProvider;
 import com.atomgraph.linkeddatahub.imports.ImportExecutor;
 import com.atomgraph.linkeddatahub.io.HtmlJsonLDReaderFactory;
 import com.atomgraph.linkeddatahub.io.JsonLDReader;
@@ -153,6 +154,7 @@
 import java.security.cert.CertificateException;
 import java.security.cert.X509Certificate;
 import java.util.HashMap;
+import java.util.ServiceLoader;
 import java.util.Map;
 import java.util.Properties;
 import jakarta.mail.Authenticator;
@@ -1168,17 +1170,19 @@ protected void registerExceptionMappers()
      */
     protected void registerClientFilters()
     {
-        try
-        {
-            // Register YouTube GRDDL filter
-            YouTubeGRDDLFilter youtubeFilter = new YouTubeGRDDLFilter(xsltComp);
-            client.register(youtubeFilter);
-            externalClient.register(youtubeFilter);
-        }
-        catch (SaxonApiException ex)
+        ServiceLoader.load(JSONGRDDLFilterProvider.class).forEach(provider ->
         {
-            if (log.isErrorEnabled()) log.error("Failed to initialize GRDDL client filter");
-        }
+            try
+            {
+                JSONGRDDLFilter filter = provider.getFilter(xsltComp);
+                client.register(filter);
+                externalClient.register(filter);
+            }
+            catch (SaxonApiException ex)
+            {
+                if (log.isErrorEnabled()) log.error("Failed to initialize GRDDL client filter for {}", provider.getClass().getSimpleName());
+            }
+        });
     }
 
     /**

src/main/java/com/atomgraph/linkeddatahub/client/filter/JSONGRDDLFilterProvider.java

@@ -0,0 +1,31 @@
+/**
+ *  Copyright 2025 Martynas Jusevičius <martynas@atomgraph.com>
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ */
+package com.atomgraph.linkeddatahub.client.filter;
+
+import net.sf.saxon.s9api.SaxonApiException;
+import net.sf.saxon.s9api.XsltCompiler;
+
+/**
+ * SPI interface for providing {@link JSONGRDDLFilter} instances.
+ * Implementations are discovered via {@link java.util.ServiceLoader}.
+ */
+public interface JSONGRDDLFilterProvider
+{
+
+    JSONGRDDLFilter getFilter(XsltCompiler xsltCompiler) throws SaxonApiException;
+
+}