#1863: CardDavUtilsTest.kt

CardDavUtils — это утилитный класс, предоставляющий статические вспомогательные методы для реализации протокола CardDAV. Данный тест покрывает три ключевые функции манипуляции URL/путями, необходимые для адресации ресурсов CardDAV.

Импорты

• org.junit.jupiter.api.Assertions — утверждения JUnit 5
• org.junit.jupiter.api.Test — аннотация теста JUnit 5
• org.projectforge.framework.persistence.user.entities.PFUserDO — сущность пользователя ProjectForge (макет создан встроенно с помощью PFUserDO().also { it.username = "joe" })

Тестируемые методы

1. getPrincipalsUsersUrl(uri, user)

Преобразует путь URL ресурса в соответствующий principal URL. В WebDAV/CardDAV каждый пользователь имеет principal ресурс, представляющий его личность. Этот метод сопоставляет URL коллекций пользователей с principal URL:

• /carddav/users/... → /carddav/principals/users/joe/
• /users/... → /principals/users/joe/

Метод удаляет суффиксы URL (символы ... обозначают конечные сегменты пути) и перезаписывает users на principals/users/{username}. Это определено в RFC 3744 (Управление доступом WebDAV) и RFC 6352 (CardDAV).

2. normalizedUri(uri)

Удаляет префикс CardDAV из URI, нормализуя их до базового типа ресурса:

• /carddav/users/ → users
• /users/ → users
• /principals/ → principals

Этот метод используется внутри диспетчера CardDAV для определения того, какой обработчик должен обработать запрос после того, как фильтр определит его как CardDAV-трафик.

3. extractContactId(path)

Извлекает числовой ID контакта ProjectForge из различных шаблонов путей к файлам:

• VCF-файлы: /carddav/users/joe/ProjectForge-123.vcf → 123
• JPEG-фото: /carddav/photos/contact-123.jpg → 123
• PNG-фото: /carddav/photos/contact-123.png → 123

Метод использует регулярные выражения для сопоставления с шаблонами ProjectForge-{id} и contact-{id}, что позволяет серверу сопоставлять URL ресурсов CardDAV с ID базы данных ProjectForge.

Шаблон создания объекта пользователя

В тесте используется функция области видимости Kotlin apply: PFUserDO().also { it.username = "joe" }. Это создает частично инициализированный PFUserDO только с установленным именем пользователя — достаточно для методов генерации URL, которым требуется только свойство username.