#1866: PropFindRequestHandlerTest.kt

Tests PropFindRequestHandler.generatePropFindResponse() — the core WebDAV PROPFIND response generator. Verifies correct XML multistatus responses for two scenarios: resource type/displayname queries and principal/privilege queries. Uses Mockito mocks for HTTP servlet objects and a real PFUserDO entity.

PropFindRequestHandler is the server-side handler that responds to CardDAV PROPFIND requests per RFC 4918 (WebDAV). PROPFIND is the primary mechanism by which CardDAV clients discover server capabilities, resource types, and user principal information.

Imports

• jakarta.servlet.http.HttpServletRequest / HttpServletResponse — Servlet API for mock request/response
• 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 — User entity with username "kai"
• org.projectforge.carddav.Prop, PropType, RequestWrapper, WriterContext, PropFindRequestHandler — CardDAV internal classes

Test Scenarios

Scenario 1: RESOURCETYPE + DISPLAYNAME

When a client PROPFINDs for resourcetype and displayname properties on /carddav/users/kai/, the handler must respond with:

• d:resourcetype → <d:collection /> (indicating this is a collection/container resource)
• d:displayname → kai (the username)

The response is a full XML multistatus document with DAV, CardDAV, CalDAV, and custom namespace declarations.

Scenario 2: CURRENT_USER_PRINCIPAL + PRIVILEGE_SET + PRINCIPAL_URL

When a client queries user identity properties:

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

Dependency Graph

Class	Role
Prop	Represents a single requested DAV property with a PropType enum value
PropType	Enum of known DAV properties: RESOURCETYPE, DISPLAYNAME, CURRENT_USER_PRINCIPAL, CURRENT_USER_PRIVILEGE_SET, PRINCIPAL_URL, GETETAG, GETCTAG, SYNCTOKEN
RequestWrapper	Wraps HttpServletRequest, extracts the request URI for response href generation
WriterContext	Bundles request wrapper, response, user, and requested props — the complete context needed by the handler
PropFindRequestHandler	Static method generatePropFindResponse(WriterContext): String — pure function generating XML string

Mocking Strategy

• HttpServletRequest: Mocked to return /carddav/users/kai/ as requestURI
• HttpServletResponse: Mocked but unused (the handler returns a String, doesn't write to response directly in test)
• PFUserDO: Real object with username = "kai" — no mocking needed
• WriterContext: Real object constructed from mocks and real user

XML Namespace Declarations

All responses include these XML namespace declarations:

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

These correspond to: DAV core, CardDAV, Apple CalendarServer extensions, and a custom namespace.