#1866: PropFindRequestHandlerTest.kt

Тестирует PropFindRequestHandler.generatePropFindResponse() — основной генератор ответов WebDAV PROPFIND. Проверяет корректные XML-ответы multistatus для двух сценариев: запросы типа ресурса/отображаемого имени и запросы участника/привилегий. Использует моки Mockito для HTTP-сервлетных объектов и реальную сущность PFUserDO.

PropFindRequestHandler — это серверный обработчик, отвечающий на запросы CardDAV PROPFIND в соответствии с RFC 4918 (WebDAV). PROPFIND — основной механизм, с помощью которого CardDAV-клиенты обнаруживают возможности сервера, типы ресурсов и информацию об участнике.

Импорты

• jakarta.servlet.http.HttpServletRequest / HttpServletResponse — Servlet API для мокирования запроса/ответа
• org.junit.jupiter.api.Assertions — фреймворк утверждений JUnit 5
• org.junit.jupiter.api.Test — аннотация теста JUnit 5
• org.mockito.Mockito — фреймворк мокирования Mockito
• org.projectforge.framework.persistence.user.entities.PFUserDO — сущность пользователя с именем "kai"
• org.projectforge.carddav.Prop, PropType, RequestWrapper, WriterContext, PropFindRequestHandler — внутренние классы CardDAV

Сценарии тестирования

Сценарий 1: RESOURCETYPE + DISPLAYNAME

Когда клиент отправляет PROPFIND для свойств resourcetype и displayname на /carddav/users/kai/, обработчик должен ответить:

• d:resourcetype → <d:collection /> (указывает, что это ресурс-коллекция/контейнер)
• d:displayname → kai (имя пользователя)

Ответ представляет собой полный XML-документ multistatus с объявлениями пространств имён DAV, CardDAV, CalDAV и пользовательского.

Сценарий 2: CURRENT_USER_PRINCIPAL + PRIVILEGE_SET + PRINCIPAL_URL

Когда клиент запрашивает свойства идентификации пользователя:

• d:current-user-principal → <d:href>/carddav/principals/users/kai/</d:href>
• d:current-user-privilege-set → четыре привилегии: read, write, write-properties, write-content
• d:principal-URL → <d:href>/carddav/principals/users/kai/</d:href>

Граф зависимостей

Класс	Роль
Prop	Представляет одно запрошенное свойство DAV со значением перечисления PropType
PropType	Перечисление известных свойств DAV: RESOURCETYPE, DISPLAYNAME, CURRENT_USER_PRINCIPAL, CURRENT_USER_PRIVILEGE_SET, PRINCIPAL_URL, GETETAG, GETCTAG, SYNCTOKEN
RequestWrapper	Оборачивает HttpServletRequest, извлекает URI запроса для генерации href в ответе
WriterContext	Объединяет обёртку запроса, ответ, пользователя и запрошенные свойства — полный контекст, необходимый обработчику
PropFindRequestHandler	Статический метод generatePropFindResponse(WriterContext): String — чистая функция, генерирующая XML-строку

Стратегия мокирования

• HttpServletRequest: Мокирован для возврата /carddav/users/kai/ в качестве requestURI
• HttpServletResponse: Мокирован, но не используется (обработчик возвращает строку, не записывая напрямую в ответ в тесте)
• PFUserDO: Реальный объект с username = "kai" — мокирование не требуется
• WriterContext: Реальный объект, созданный из моков и реального пользователя

Объявления пространств имён XML

Все ответы включают следующие объявления пространств имён XML:

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

Они соответствуют: ядру DAV, CardDAV, расширениям Apple CalendarServer и пользовательскому пространству имён.