#1866: PropFindRequestHandlerTest.kt

Testet PropFindRequestHandler.generatePropFindResponse() — den zentralen WebDAV-PROPFIND-Antwortgenerator. Überprüft korrekte XML-multistatus-Antworten für zwei Szenarien: Ressourcentyp/Anzeigename-Abfragen und Principal/Privileg-Abfragen. Verwendet Mockito-Mocks für HTTP-Servlet-Objekte und eine echte PFUserDO-Entität.

PropFindRequestHandler ist der serverseitige Handler, der auf CardDAV-PROPFIND-Anfragen gemäß RFC 4918 (WebDAV) antwortet. PROPFIND ist der primäre Mechanismus, mit dem CardDAV-Clients Serverfähigkeiten, Ressourcentypen und Benutzer-Prinzipal-Informationen ermitteln.

Importe

• jakarta.servlet.http.HttpServletRequest / HttpServletResponse — Servlet-API für Mock-Anfrage/-Antwort
• org.junit.jupiter.api.Assertions — JUnit 5 Assertion-Framework
• org.junit.jupiter.api.Test — JUnit 5 Test-Annotation
• org.mockito.Mockito — Mockito Mocking-Framework
• org.projectforge.framework.persistence.user.entities.PFUserDO — Benutzerentität mit Benutzername "kai"
• org.projectforge.carddav.Prop, PropType, RequestWrapper, WriterContext, PropFindRequestHandler — CardDAV-interne Klassen

Testszenarien

Szenario 1: RESOURCETYPE + DISPLAYNAME

Wenn ein Client PROPFIND für die Eigenschaften resourcetype und displayname unter /carddav/users/kai/ durchführt, muss der Handler antworten mit:

• d:resourcetype → <d:collection /> (zeigt an, dass es sich um eine Sammlungs-/Container-Ressource handelt)
• d:displayname → kai (der Benutzername)

Die Antwort ist ein vollständiges XML-multistatus-Dokument mit DAV-, CardDAV-, CalDAV- und benutzerdefinierten Namespace-Deklarationen.

Szenario 2: CURRENT_USER_PRINCIPAL + PRIVILEGE_SET + PRINCIPAL_URL

Wenn ein Client Benutzeridentitätseigenschaften abfragt:

• d:current-user-principal → <d:href>/carddav/principals/users/kai/</d:href>
• d:current-user-privilege-set → vier Privilegien: read, write, write-properties, write-content
• d:principal-URL → <d:href>/carddav/principals/users/kai/</d:href>

Abhängigkeitsgraph

Klasse	Rolle
Prop	Repräsentiert eine einzelne angeforderte DAV-Eigenschaft mit einem PropType-Enum-Wert
PropType	Enum der bekannten DAV-Eigenschaften: RESOURCETYPE, DISPLAYNAME, CURRENT_USER_PRINCIPAL, CURRENT_USER_PRIVILEGE_SET, PRINCIPAL_URL, GETETAG, GETCTAG, SYNCTOKEN
RequestWrapper	Umschließt HttpServletRequest, extrahiert die Anfrage-URI zur Generierung der Antwort-Href
WriterContext	Bündelt Request-Wrapper, Antwort, Benutzer und angeforderte Eigenschaften — den vollständigen Kontext, den der Handler benötigt
PropFindRequestHandler	Statische Methode generatePropFindResponse(WriterContext): String — reine Funktion, die einen XML-String erzeugt

Mocking-Strategie

• HttpServletRequest: Gemockt, um /carddav/users/kai/ als requestURI zurückzugeben
• HttpServletResponse: Gemockt, aber ungenutzt (der Handler gibt einen String zurück, schreibt im Test nicht direkt in die Antwort)
• PFUserDO: Echtes Objekt mit username = "kai" — kein Mocking erforderlich
• WriterContext: Echtes Objekt, konstruiert aus Mocks und echtem Benutzer

XML-Namespace-Deklarationen

Alle Antworten enthalten diese XML-Namespace-Deklarationen:

xmlns:d="DAV:"
xmlns:card="urn:ietf:params:xml:ns:carddav"
xmlns:cs="http://calendarserver.org/ns/"
xmlns:me="http://me.com/_namespace/"

Diese entsprechen: DAV-Kern, CardDAV, Apple CalendarServer-Erweiterungen und einem benutzerdefinierten Namespace.