Add getSnapshotAsJson() for uncompressed JSON access to order book snapshots

Scripts can now export snapshots as JSON files instead of SQLite BLOBs.

Author: kreinhard

projectforge-business/src/main/kotlin/org/projectforge/business/fibu/orderbooksnapshots/OrderbookSnapshotScriptingService.kt

@@ -73,4 +73,14 @@ class OrderbookSnapshotScriptingService(private val __service: OrderbookSnapshot
     fun getSerializedOrderBook(date: LocalDate): ByteArray? {
         return __service.getSerializedOrderBook(date)
     }
+
+    /**
+     * Returns the order book snapshot as uncompressed JSON string for a given date.
+     *
+     * @param date The date of the snapshot.
+     * @return The JSON string containing all orders, or null if not found.
+     */
+    fun getSnapshotAsJson(date: LocalDate): String? {
+        return __service.getSnapshotAsJson(date)
+    }
 }

projectforge-business/src/main/kotlin/org/projectforge/business/fibu/orderbooksnapshots/OrderbookSnapshotsService.kt

@@ -290,6 +290,18 @@ class OrderbookSnapshotsService {
         return findEntry(date)?.serializedOrderBook
     }
 
+    /**
+     * Returns the order book snapshot as uncompressed JSON string for a given date.
+     * @param date The date of the snapshot.
+     * @return The JSON string, or null if not found or empty.
+     */
+    fun getSnapshotAsJson(date: LocalDate): String? {
+        val entry = findEntry(date) ?: return null
+        val serialized = entry.serializedOrderBook ?: return null
+        if (serialized.isEmpty()) return null
+        return gunzip(serialized)
+    }
+
     private fun findEntry(date: LocalDate): OrderbookSnapshotDO? {
         return persistenceService.find(OrderbookSnapshotDO::class.java, date)
     }