#1864: CardDavXmlUtilsTest.kt

CardDavXmlUtils bietet leichtgewichtiges XML-Parsing ohne vollständigen DOM/SAX-Parser – mittels regex-basierter Extraktion für CardDAV-spezifische XML-Nutzlasten. Dieser Ansatz wurde gewählt, weil CardDAV-XML-Nutzlasten strukturell vorhersagbar (definiert durch RFCs 4918, 6352) und leistungskritisch sind.

Importe

• org.junit.jupiter.api.Assertions — JUnit 5 Assertions
• org.junit.jupiter.api.Test — JUnit 5 Test-Annotation

Getestete Methoden

1. getRootElement(xml) — Wurzelelement-Extraktion

Extrahiert den XML-Wurzelelementnamen aus einem String und behandelt dabei optionale XML-Deklaration (<?xml ... ?>) und Namespace-präfixierte Elemente (d:multistatus). Die Tests decken ab:

• XML mit Namespace-Präfix: <d:multistatus xmlns:d="DAV:"> → multistatus
• XML mit Deklaration + Namespace: entfernt <?xml version="1.0"?>, gibt multistatus zurück

Dies ist entscheidend für den PROPFIND/REPORT-Antwort-Handler, um basierend auf dem Wurzelelementtyp an den richtigen Antwort-Builder weiterzuleiten.

2. extractContactIds(xml) — Multiget-Kontakt-ID-Extraktion

Parst einen CardDAV addressbook-multiget REPORT-Anfragekörper, um ProjectForge-Kontakt-IDs aus <d:href>-Elementen zu extrahieren. Tests parsen eine realistische XML-Nutzlast mit drei <d:href>{Pfad}/ProjectForge-{ID}.vcf</d:href>-Einträgen und verifizieren die korrekte Extraktion der IDs 7833476, 7858940, 7859171.

Die Methode verwendet Regex-Abgleich auf das ProjectForge-{ID}.vcf-Dateinamenmuster innerhalb von href-Elementen. Das Ergebnis ist eine Sequence<Int> (faule Auswertung via .toList()).

3. getElementName(xml, name) — Namespace-bewusste Elementnamen-Auflösung

Findet ein benanntes Element in XML und gibt dessen qualifizierten Namen inklusive Namespace-Präfix zurück:

• Suche nach "prop" in nicht-präfixiertem XML → gibt prop zurück
• Suche nach "prop" in Namespace-präfixiertem XML → gibt d:prop zurück

4. extractElementValue(xml, name) — Element-Inhalt-Extraktion

Extrahiert den Textinhalt eines benannten Elements aus XML und behandelt:

• Elemente mit Textinhalt: <etag> </etag> → " " (Leerzeichen bleiben erhalten)
• Verschachtelte Elemente: Extraktion von "prop" gibt inneres XML inklusive Kindelemente zurück
• Selbstschließende Elemente: <etag /> → null (kein Textinhalt)
• Namespace-präfixierte selbstschließende: <d:etag /> → null
• Elementnamen mit Bindestrich: <d:sync-token>123456</d:sync-token> → 123456

5. escapeXml(xml) — XML-Entity-Escaping

Escaped fünf XML-Sonderzeichen gemäß XML-1.0-Spezifikation:

• < → <
• > → > (behandelt; Testeingabe enthält >)
• " → "
• & → &
• ' → '

Testdaten-Muster

Alle Tests verwenden Koltins let-Scope-Funktion mit rohen String-Literalen ("""...""") für XML-Testdaten. trimIndent() und trimMargin() werden verwendet, um mehrzeilige Testvorlagen zu bereinigen, während die XML-Struktur erhalten bleibt.