mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: update Exposed 1.0.0 migration guide with troubleshooting and fixes

Browse Source 
Refined migration steps to address compatibility issues with `JdbcTransaction` and `PreparedStatementApi`. Added detailed troubleshooting for `exec` and `executeUpdate` usage. Updated formatting and clarified best practices for transitioning to Exposed 1.0.0.
This commit is contained in:
Stefan Mogeritsch
2026-02-02 12:37:48 +01:00
parent 55e5302e13
commit 86d8d780f5
1 changed files with 23 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/01_Architecture/Reference/Architektonische-Evolution-Migrationsleitfaden_Exposed-1-0-0-rc-4_zu_1-0-0_01-2026.md
+23 -17
View File
@@ -2,7 +2,7 @@
type: Reference type: Reference
status: ACTIVE status: ACTIVE
owner: Lead Architect owner: Lead Architect
date: 2026-01-31 date: 2026-02-02
--- ---
# Architektonische Evolution – Migrationsleitfaden: Exposed 1.0.0-rc-4 → 1.0.0 # Architektonische Evolution – Migrationsleitfaden: Exposed 1.0.0-rc-4 → 1.0.0
@@ -82,19 +82,19 @@ Das Handling von JSONB-Spalten in SQLite wurde vereinheitlicht.
## 2. Migrationsschritte (How-To) ## 2. Migrationsschritte (How-To)
1. Zentralversion heben: 1. Zentralversion heben:
- `gradle/libs.versions.toml`: `exposed = "1.0.0"` setzen. - `gradle/libs.versions.toml`: `exposed = "1.0.0"` setzen.
- Platform-BOM importieren; keine Direktversionen in Modul-Builds. - Platform-BOM importieren; keine Direktversionen in Modul-Builds.
2. UUID-Pfade prüfen: 2. UUID-Pfade prüfen:
- Nutzung von `Table.uuid()` evaluieren; falls `java.util.UUID` benötigt, auf `Table.javaUUID()` wechseln. - Nutzung von `Table.uuid()` evaluieren; falls `java.util.UUID` benötigt, auf `Table.javaUUID()` wechseln.
- Etwaige Referenzen auf verschobene `.UUID*`-Typen auf das neue `.java`-Subpaket anpassen. - Etwaige Referenzen auf verschobene `.UUID*`-Typen auf das neue `.java`-Subpaket anpassen.
3. TransactionManager-Aufrufe: 3. TransactionManager-Aufrufe:
- Verwendungen von `TransactionManagerApi.currentOrNull()` entfernen. - Verwendungen von `TransactionManagerApi.currentOrNull()` entfernen.
- Stattdessen `JdbcTransactionManager.currentOrNull()` bzw. `TransactionManager.currentOrNull()` einsetzen. - Stattdessen `JdbcTransactionManager.currentOrNull()` bzw. `TransactionManager.currentOrNull()` einsetzen.
4. R2DBC (falls verwendet): 4. R2DBC (falls verwendet):
- Entfernte Methoden (`closeIfPossible`, `cancel`) nicht mehr aufrufen. - Entfernte Methoden (`closeIfPossible`, `cancel`) nicht mehr aufrufen.
- Umbenennung auf `.clearExecutedStatements()` berücksichtigen (non-suspending). - Umbenennung auf `.clearExecutedStatements()` berücksichtigen (non-suspending).
5. JSON/SQLite: 5. JSON/SQLite:
- Verhalten von `jsonb()` mit `castToJsonFormat` prüfen und ggf. deaktivieren. - Verhalten von `jsonb()` mit `castToJsonFormat` prüfen und ggf. deaktivieren.
## 3. Troubleshooting & Lessons Learned (Update 2026-02-02) ## 3. Troubleshooting & Lessons Learned (Update 2026-02-02)
@@ -102,17 +102,23 @@ Das Handling von JSONB-Spalten in SQLite wurde vereinheitlicht.
Bei der Migration von `DatabaseUtils.kt` traten Probleme mit der Auflösung von `exec` und `executeUpdate` auf. Bei der Migration von `DatabaseUtils.kt` traten Probleme mit der Auflösung von `exec` und `executeUpdate` auf.
* **Problem:** Die generische `Transaction` Klasse bietet in Exposed 1.0.0 keinen direkten Zugriff mehr auf `exec` mit `ResultSet`-Verarbeitung oder `executeUpdate`. Diese Methoden sind nun spezifischer in `JdbcTransaction` oder `PreparedStatementApi` verortet. * **Problem:** Die generische `Transaction` Klasse bietet in Exposed 1.0.0 keinen direkten Zugriff mehr auf `exec` mit
* **Lösung:** `ResultSet`-Verarbeitung oder `executeUpdate`. Diese Methoden sind nun spezifischer in `JdbcTransaction` oder
* **Explizite `JdbcTransaction`:** Unsere Transaction-Wrapper (`transactionResult`) wurden angepasst, um `JdbcTransaction` als Receiver (`this`) zu erzwingen. `PreparedStatementApi` verortet.
* **`exec` mit `StatementType`:** Aufrufe von `exec` müssen nun den `explicitStatementType` Parameter (z.B. `StatementType.SELECT`) nutzen, damit der Compiler die korrekte Überladung wählt. * **Lösung:**
* **`executeUpdate` Workaround:** Da `PreparedStatementApi` in Exposed 1.0.0 nicht `AutoCloseable` ist und `executeUpdate` teilweise schwer aufzulösen war, nutzen wir `try-finally` mit `closeIfPossible()` und greifen bei Bedarf auf die native JDBC Connection zu. * **Explizite `JdbcTransaction`:** Unsere Transaction-Wrapper (`transactionResult`) wurden angepasst, um
`JdbcTransaction` als Receiver (`this`) zu erzwingen.
* **`exec` mit `StatementType`:** Aufrufe von `exec` müssen nun den `explicitStatementType` Parameter (z.B.
`StatementType.SELECT`) nutzen, damit der Compiler die korrekte Überladung wählt.
* **`executeUpdate` Workaround:** Da `PreparedStatementApi` in Exposed 1.0.0 nicht `AutoCloseable` ist und
`executeUpdate` teilweise schwer aufzulösen war, nutzen wir `try-finally` mit `closeIfPossible()` und greifen bei
Bedarf auf die native JDBC Connection zu.
```kotlin ```kotlin
// Beispiel für korrekten Low-Level Zugriff in Exposed 1.0.0 // Beispiel für korrekten Low-Level Zugriff in Exposed 1.0.0
transactionResult(database) { transactionResult(database) {
// 'this' ist JdbcTransaction // 'this' ist JdbcTransaction
this.exec("SELECT ...", explicitStatementType = StatementType.SELECT) { rs -> ... } this.exec("SELECT ...", explicitStatementType = StatementType.SELECT) { rs -> ... }
} }
``` ```