This is an automated email from the ASF dual-hosted git repository.
cziegeler pushed a commit to branch master
in repository
https://gitbox.apache.org/repos/asf/sling-org-apache-sling-servlets-post.git
The following commit(s) were added to refs/heads/master by this push:
new 8eddf56 docs: update README with build details and notes (#40)
8eddf56 is described below
commit 8eddf567180fa014877b549f3f79ed092fa40b39
Author: Carsten Ziegeler <[email protected]>
AuthorDate: Thu Jul 16 14:16:45 2026 +0200
docs: update README with build details and notes (#40)
Co-authored-by: Maia <maia@noreply>
---
README.md | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index a6b157f..6287b80 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,9 @@ Java 17 is required.
- Integration tests (Failsafe, including `ModifyOperationIT`): `mvn verify`
- Single unit test class: `mvn test -Dtest=HtmlResponseTest`
- Single integration test class: `mvn verify -Dit.test=ModifyOperationIT`
-- Inspect generated bundle metadata: `jar tf
target/org.apache.sling.servlets.post-*.jar | grep -E
'META-INF/MANIFEST.MF|SLING-INF/nodetypes/chunk.cnd'`
+- Inspect generated bundle metadata and embedded resources:
+ - `jar tf target/org.apache.sling.servlets.post-*.jar | grep -E
'META-INF/MANIFEST.MF|SLING-INF/nodetypes/chunk.cnd'`
+ - `unzip -p target/org.apache.sling.servlets.post-*.jar META-INF/MANIFEST.MF`
## Manual upload smoke tests
@@ -65,6 +67,7 @@ src/
*.java Public Jakarta-first API/SPI (+ legacy
compatibility APIs)
exceptions/ Persistence-related exceptions
impl/ Internal servlet and operation implementations
+ SlingPostServlet.java Core POST servlet
PostOperationProxyProvider.java Legacy service proxy registration
operations/ Built-in POST operations
helper/ Internal helpers (upload, property handling,
naming, chunking)
@@ -80,7 +83,8 @@ developer-tests/ Manual developer test scripts
## Notes
- OSGi metadata is generated with bnd (`bnd-maven-plugin`), with API baseline
checks via `bnd-baseline-maven-plugin`.
-- The build shades selected classes from `jackrabbit-jcr-commons` and
`sling-jcr-contentparser` into internal `impl` packages.
+- The build shades and relocates selected classes from
`jackrabbit-jcr-commons` and `sling-jcr-contentparser` into internal `impl`
packages.
- JCR (`javax.jcr.*`) and `org.apache.sling.jcr.contentloader` imports are
configured as dynamic for runtime flexibility.
- The bundle uses `jakarta.servlet-api` as the primary servlet API while
keeping `javax.servlet-api` and `org.apache.felix.http.wrappers` for
compatibility adapters.
- JSON support is split between Jakarta JSON APIs for Jakarta responses and
legacy JSON support for backwards-compatible APIs.
+- The project security posture follows the Apache Sling threat model:
https://github.com/apache/sling/blob/master/docs/threat-model.md .
