#1863 : CardDavUtilsTest.kt

Teste les utilitaires de manipulation d'URL dans CardDavUtils : génération d'URL principale, normalisation d'URI (suppression des préfixes CardDAV) et extraction d'ID de contact à partir de chemins de fichiers VCF et photo. Ce sont des aides de routage essentielles pour l'implémentation du serveur CardDAV.

CardDavUtils est une classe utilitaire fournissant des méthodes statiques d'aide pour l'implémentation du protocole CardDAV. Ce test couvre trois fonctions clés de manipulation d'URL/chemin indispensables pour l'adressage des ressources CardDAV.

Importations

• org.junit.jupiter.api.Assertions — assertions JUnit 5
• org.junit.jupiter.api.Test — annotation de test JUnit 5
• org.projectforge.framework.persistence.user.entities.PFUserDO — entité utilisateur ProjectForge (mock construit en ligne avec PFUserDO().also { it.username = "joe" })

Méthodes testées

1. getPrincipalsUsersUrl(uri, user)

Convertit un chemin d'URL de ressource en l'URL principale correspondante. Dans WebDAV/CardDAV, chaque utilisateur possède une ressource principale représentant son identité. Cette méthode mappe les URL de collection d'utilisateurs vers les URL principales :

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

La méthode supprime les suffixes d'URL (le ... représente les segments de chemin suivants) et réécrit users en principals/users/{username}. Ceci est défini dans la RFC 3744 (Contrôle d'accès WebDAV) et la RFC 6352 (CardDAV).

2. normalizedUri(uri)

Supprime le préfixe CardDAV des URI, en les normalisant vers leur type de ressource de base :

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

Cette méthode est utilisée en interne par le répartiteur CardDAV pour déterminer quel gestionnaire doit traiter une demande après que le filtre a décidé qu'il s'agit de trafic CardDAV.

3. extractContactId(path)

Extrait l'ID numérique du contact ProjectForge à partir de différents modèles de chemin de fichier :

• Fichiers VCF : /carddav/users/joe/ProjectForge-123.vcf → 123
• Photos JPEG : /carddav/photos/contact-123.jpg → 123
• Photos PNG : /carddav/photos/contact-123.png → 123

La méthode utilise une correspondance regex sur les modèles ProjectForge-{id} et contact-{id}, permettant au serveur de mapper les URL de ressources CardDAV vers les ID de base de données ProjectForge.

Modèle de construction d'objet utilisateur

Le test utilise le modèle de fonction de portée apply de Kotlin : PFUserDO().also { it.username = "joe" }. Cela crée un PFUserDO partiellement initialisé avec seulement le nom d'utilisateur défini — suffisant pour les méthodes de génération d'URL qui n'ont besoin que de la propriété du nom d'utilisateur.

868d6abb7 2025 -> 2026
63081666f En-têtes de fichiers source : 2024 -> 2025.
cc9abacea Serveur CardDAV : WIP : gestion des images.
c4062ed97 WIP : Carddav
40e554cbe WIP : Carddav