Feature/2.7.5

CHANGES.md

@@ -1,6 +1,6 @@
 ## 📅 CHANGES
 
-## Version 2.7.5 (2026-11-24)
+## Version 2.7.5 (2026-11-01)
 
 - ServiceError.ref is now sanitized to null if it is blank or empty, preventing the inclusion of empty or whitespace-only strings in error responses. This change enhances the clarity and consistency
   of error reporting by ensuring that only meaningful references are included in the ServiceError object.

README_中文.md

@@ -1,9 +1,9 @@
-- **[Apache Central Repository][1]**
-- **[Maven Central Repository][2]**
+- **[Maven Central Repository][1]**
+- **[Apache Central Repository][2]**
 - **[mvnrepository.com][3]**
 
-[1]: https://repo.maven.apache.org/maven2/org/summerboot/jexpress/2.7.5
-[2]: https://central.sonatype.com/artifact/org.summerboot/jexpress/2.7.5
+[1]: https://central.sonatype.com/artifact/org.summerboot/jexpress/2.7.5
+[2]: https://repo.maven.apache.org/maven2/org/summerboot/jexpress/2.7.5
 [3]: https://mvnrepository.com/artifact/org.summerboot/jexpress/2.7.5
 
 [View Changelog (CHANGES)](CHANGES.md)

pom.xml

@@ -22,7 +22,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.summerboot</groupId>
     <artifactId>jexpress</artifactId>
-    <version>2.7.5-SNAPSHOT</version>
+    <version>2.7.5</version>
     <packaging>jar</packaging>
     <name>jExpress ${project.version}</name>
     <description>jExpress focuses on addressing non-functional and operational maintainability needs, some of which Spring Boot may not yet provide.</description>

src/main/java/org/summerboot/jexpress/integration/pdf/PdfBuilder.java

@@ -132,6 +132,10 @@ public boolean removeListener(SinglePageHeightCalculationListener listener) {
         return listeners.remove(listener);
     }
 
+    public List<SinglePageHeightCalculationListener> getListeners() {
+        return List.copyOf(listeners);
+    }
+
     public boolean isDumpEnabled() {
         return BootConstants.isDebugMode() && dumpDir.exists();
     }
@@ -151,7 +155,22 @@ public byte[] htmlToPdf(String requesterTxId, String htmlContent, PdfBuilderConf
     }
 
     /**
-     * Build a single page PDF
+     * Build a single page PDF with added listeners
+     *
+     * @param requesterTxId
+     * @param htmlContent
+     * @param cfg
+     * @param extraSpace
+     * @param context
+     * @return
+     * @throws IOException
+     */
+    public byte[] htmlToPdf(String requesterTxId, String htmlContent, PdfBuilderConfig cfg, int extraSpace, SessionContext context) throws IOException {
+        return htmlToPdf(requesterTxId, htmlContent, cfg, true, extraSpace, null, context);
+    }
+
+    /**
+     * Build a single page PDF with onetime listener to override added listeners
      *
      * @param requesterTxId
      * @param htmlContent
@@ -170,7 +189,7 @@ protected byte[] htmlToPdf(String requesterTxId, String htmlContent, PdfBuilderC
         context.poi(BootPoi.PDF_BEGIN);
         PdfBuilderConfig.Agent agent = cfg.getAgent();
         if (extraSpace < 1) {
-            extraSpace = 5;
+            extraSpace = 1;
         }
         final String sessionName = requesterTxId + "[" + agent + "]" + (isSinglePage ? ("SP+" + extraSpace + "mm") : "MP");
         byte[] pdf = null;