Add comprehensive Guice upgrade analysis for Java 21+ compatibility

Analysis of Guice 5.1.0 sun.misc.Unsafe warnings on Java 21+ and
evaluation of upgrade options:
- Guice config flag (RECOMMENDED)
- M2E/Maven upgrades
- Guice 6.0/7.0 migration assessment

Recommendation: Use -Dguice_custom_class_loading=CHILD flag
as official Maven fix (PR #10992)

Author: claude

GUICE_UPGRADE_ANALYSIS.md

@@ -0,0 +1,189 @@
+# Guice Upgrade Analyse für eclipse.jdt.ls - Java 21+ Kompatibilität
+
+## Zusammenfassung
+
+eclipse.jdt.ls nutzt **Guice 5.1.0** transitiv über **M2E 2.9.1 → Maven 3.9.11**. Guice 5.1.0 verwendet `sun.misc.Unsafe`, was in Java 21+ Warnungen erzeugt und in zukünftigen Java-Versionen entfernt wird.
+
+## Aktueller Dependency-Pfad
+
+```
+eclipse.jdt.ls
+  └── org.eclipse.m2e.maven.runtime (optional dependency)
+      └── M2E 2.9.1 (von https://download.eclipse.org/technology/m2e/releases/2.9.1)
+          └── Apache Maven 3.9.11
+              └── Guice 5.1.0 (transitiv)
+```
+
+**Definiert in:** `org.eclipse.jdt.ls.target/org.eclipse.jdt.ls.tp.target:15`
+
+## Wichtige Erkenntnisse
+
+### 1. jdt.ls verwendet kein Guice direkt
+
+✅ **Keine direkten Guice/javax.inject Imports in jdt.ls Code gefunden**
+- Guice wird nur intern von M2E verwendet
+- jdt.ls nutzt nur M2E's öffentliche API
+- **Vorteil:** Ein Guice-Upgrade würde keinen jdt.ls Code betreffen
+
+### 2. Das Problem: sun.misc.Unsafe Warnungen
+
+```
+WARNING: A terminally deprecated method in sun.misc.Unsafe has been called
+WARNING: sun.misc.Unsafe::staticFieldBase has been called by
+         com.google.inject.internal.aop.HiddenClassDefiner
+WARNING: Please consider reporting this to the maintainers of
+         com.google.inject.internal.aop.HiddenClassDefiner
+WARNING: sun.misc.Unsafe::staticFieldBase will be removed in a future release
+```
+
+**Betrifft:** Java 21+ (besonders Java 25)
+**Quelle:** Maven Issue [#10312](https://github.com/apache/maven/issues/10312), [#11387](https://github.com/apache/maven/issues/11387)
+
+## Upgrade-Optionen Analyse
+
+### Option 1: Guice Configuration Flag (EMPFOHLEN) ✅
+
+**Lösung:** `-Dguice_custom_class_loading=CHILD`
+
+**Implementierung:**
+Maven hat diesen Fix in PR #10992 implementiert. Die Lösung ist bereits in Maven 3.9.12 (geplant) enthalten.
+
+**Vorteile:**
+- ✅ Keine Code-Änderungen nötig
+- ✅ Keine Dependency-Upgrades
+- ✅ Kompatibel mit bestehendem Setup
+- ✅ Bereits von Maven getestet und als offizieller Fix akzeptiert
+
+**Nachteile:**
+- ⚠️ System-Property muss gesetzt werden
+- ⚠️ Guice bleibt auf Version 5.1.0
+
+**Umsetzung für jdt.ls:**
+- JVM-Argument in Launch-Konfigurationen hinzufügen
+- In `launch/*.ini` Dateien einfügen
+- In Test-Konfigurationen (`org.eclipse.jdt.ls.tests/pom.xml`) einfügen
+
+---
+
+### Option 2: M2E Upgrade auf neuere Version
+
+**Status:** M2E 2.9.1 ist aktuell die neueste stabile Version (September 2025)
+
+**Maven-Versionen:**
+- M2E 2.9.1 → Maven 3.9.11 → Guice 5.1.0
+- M2E 2.9.2 (in Entwicklung) → Maven ? → Guice ?
+
+**Vorteile:**
+- ✅ Erhält auch andere M2E-Bugfixes und Verbesserungen
+
+**Nachteile:**
+- ❌ Keine neuere M2E-Version verfügbar, die das Problem löst
+- ❌ Maven 3.9.12 noch nicht released
+- ⚠️ Wartepfad unsicher
+
+**Empfehlung:** Monitoring fortsetzen, wenn M2E auf Maven 3.9.12+ upgradet
+
+---
+
+### Option 3: Guice 6.0 Upgrade
+
+**Guice 6.0 Features:**
+- ✅ Behält `javax.inject` Support
+- ✅ Fügt `jakarta.inject` Support hinzu
+- ✅ Java 21+ kompatibel (nutzt ASM 9.5)
+- ✅ Entfernt sun.misc.Unsafe Nutzung
+
+**Status in Maven:**
+❌ Maven hat KEIN Guice 6.0 Upgrade geplant
+- Maven Issue [MNG-8027](https://issues.apache.org/jira/browse/MNG-8027) dokumentiert, dass Maven nicht auf jakarta migriert
+- Maven downgraded Guice sogar auf 5.1.0 in PR #2472
+- Maven 4.0.0-rc-4 verwendet auch noch Guice 5.1.0
+
+**Nachteile:**
+- ❌ Erfordert eigenes M2E maven.runtime Bundle zu bauen
+- ❌ Hoher Wartungsaufwand
+- ❌ Maven upstream nicht aligned
+
+**Empfehlung:** ⚠️ NICHT EMPFOHLEN wegen Wartungsaufwand
+
+---
+
+### Option 4: Guice 7.0 Upgrade
+
+**Guice 7.0 Changes:**
+- ❌ Entfernt `javax.inject` Support
+- ✅ Nur `jakarta.inject` Support
+- ⚠️ Breaking Changes für alle Consumers
+
+**Status:**
+- ❌ Maven migriert nicht zu jakarta (MNG-8027)
+- ❌ Würde M2E und alle Plugins brechen
+- ❌ Massive Breaking Changes im gesamten Ecosystem
+
+**Empfehlung:** ❌ NICHT PRAKTIKABEL
+
+---
+
+## Empfohlene Lösung
+
+### Kurzfristig (SOFORT): Guice Configuration Flag
+
+**1. System-Property in JVM-Argumenten setzen:**
+
+```bash
+-Dguice_custom_class_loading=CHILD
+```
+
+**2. Wo einbauen:**
+- `launch/jdt-ls.sh` und `launch/jdt-ls.bat`
+- Test-Konfiguration in `org.eclipse.jdt.ls.tests/pom.xml`
+- CI/CD Pipelines (.github/workflows/)
+
+**3. Dokumentation in README.md hinzufügen**
+
+### Mittelfristig (3-6 Monate): M2E 2.10+ Upgrade
+
+- ⏱️ Warten auf M2E mit Maven 3.9.12+ Support
+- 📊 Monitoring: https://download.eclipse.org/technology/m2e/releases/
+- ✅ Dann Target Platform auf neue M2E-Version updaten
+
+## Implementierung
+
+### Dateien zum Ändern:
+
+1. **launch/jdt-ls.sh** - Füge JVM-Argument hinzu
+2. **launch/jdt-ls.bat** - Füge JVM-Argument hinzu
+3. **org.eclipse.jdt.ls.tests/pom.xml** - Füge zu `tycho.testArgLine` hinzu
+4. **README.md** - Dokumentiere Java 21+ Kompatibilität
+5. **.github/workflows/** - Prüfe CI/CD Konfigurationen
+
+### Testing:
+
+```bash
+# Mit Java 21
+export JAVA_HOME=/path/to/java-21
+mvn clean verify -Dguice_custom_class_loading=CHILD
+
+# Mit Java 25
+export JAVA_HOME=/path/to/java-25
+mvn clean verify -Dguice_custom_class_loading=CHILD
+```
+
+## Referenzen
+
+- Maven Issue #10312: https://github.com/apache/maven/issues/10312
+- Maven Issue #11387: https://github.com/apache/maven/issues/11387
+- Maven PR #10992: https://github.com/apache/maven/pull/10992
+- Guice 6.0 Docs: https://github.com/google/guice/wiki/Guice600
+- M2E Releases: https://download.eclipse.org/technology/m2e/releases/
+
+## Zusammenfassung
+
+| Lösung | Aufwand | Effektivität | Empfehlung |
+|--------|---------|--------------|------------|
+| Guice Config Flag | Niedrig | Hoch | ✅ **EMPFOHLEN** |
+| M2E Upgrade | Niedrig | Mittel | ⏱️ Später |
+| Guice 6.0 | Hoch | Mittel | ⚠️ Nicht empfohlen |
+| Guice 7.0 | Sehr Hoch | N/A | ❌ Nicht praktikabel |
+
+**Fazit:** Die `-Dguice_custom_class_loading=CHILD` Konfiguration ist die beste Lösung: einfach, effektiv, und von Maven offiziell als Fix übernommen.