#1864: CardDavXmlUtilsTest.kt

Suite de pruebas exhaustiva para las funciones de utilidad XML en CardDavXmlUtils: extracción del elemento raíz, análisis de ID de contacto desde solicitudes multiget, extracción de nombre/valor de elementos XML con soporte de espacios de nombres y escape de entidades XML. Estas utilidades forman la columna vertebral del análisis XML del manejador del protocolo CardDAV.

CardDavXmlUtils proporciona un análisis XML ligero sin un analizador DOM/SAX completo — utilizando extracción basada en expresiones regulares para cargas útiles XML específicas de CardDAV. Este enfoque se elige porque las cargas útiles XML de CardDAV son estructuralmente predecibles (definidas por los RFC 4918, 6352) y críticas para el rendimiento.

Importaciones

• org.junit.jupiter.api.Assertions — Aserciones de JUnit 5
• org.junit.jupiter.api.Test — Anotación de prueba de JUnit 5

Métodos probados

1. getRootElement(xml) — Extracción del elemento raíz

Extrae el nombre del elemento raíz XML de una cadena, manejando la declaración XML opcional (<?xml ... ?>) y elementos con prefijo de espacio de nombres (d:multistatus). Las pruebas cubren:

• XML con prefijo de espacio de nombres: <d:multistatus xmlns:d="DAV:"> → multistatus
• XML con declaración + espacio de nombres: elimina <?xml version="1.0"?>, devuelve multistatus

Esto es crítico para que el manejador de respuesta PROPFIND/REPORT envíe al constructor de respuesta correcto según el tipo de elemento raíz.

2. extractContactIds(xml) — Extracción de ID de contacto Multiget

Analiza el cuerpo de una solicitud REPORT addressbook-multiget de CardDAV para extraer los ID de contacto de ProjectForge de los elementos <d:href>. Las pruebas analizan una carga útil XML realista con tres entradas <d:href>{ruta}/ProjectForge-{id}.vcf</d:href> y verifican la extracción correcta de los ID 7833476, 7858940, 7859171.

El método utiliza coincidencia de expresiones regulares en el patrón de nombre de archivo ProjectForge-{id}.vcf dentro de los elementos href. El resultado es un Sequence<Int> (evaluación perezosa vía .toList()).

3. getElementName(xml, name) — Resolución de nombre de elemento con espacio de nombres

Encuentra un elemento nombrado en XML y devuelve su nombre calificado incluyendo el prefijo del espacio de nombres:

• Búsqueda de "prop" en XML sin prefijo → devuelve prop
• Búsqueda de "prop" en XML con prefijo de espacio de nombres → devuelve d:prop

Esto se utiliza cuando el servidor necesita conocer el nombre calificado exacto para la generación del elemento de respuesta.

4. extractElementValue(xml, name) — Extracción de contenido de elemento

Extrae el contenido de texto de un elemento nombrado desde XML, manejando:

• Elementos con contenido de texto: <etag> </etag> → " " (preserva espacios en blanco)
• Elementos anidados: extraer "prop" devuelve el XML interno incluyendo elementos hijos
• Elementos autocerrados: <etag /> → null (sin contenido de texto)
• Autocerrado con prefijo de espacio de nombres: <d:etag /> → null
• Nombres de elemento con guión: <d:sync-token>123456</d:sync-token> → 123456

5. escapeXml(xml) — Escape de entidades XML

Escapa cinco caracteres especiales XML según la especificación XML 1.0:

• < → <
• > → > (manejado; la entrada de prueba contiene >)
• " → "
• & → &
• ' → '

La entrada de prueba <hurzel test="dkfsld"> & ' se escapa a <hurzel test="dkfsld"> & '.

Patrón de datos de prueba

Todas las pruebas utilizan la función de ámbito let de Kotlin con literales de cadena sin procesar ("""...""") para los datos de prueba XML. Se utilizan trimIndent() y trimMargin() para limpiar los fixtures de prueba multilínea mientras se preserva la estructura XML.

868d6abb7 2025 -> 2026
63081666f Encabezados de archivos fuente: 2024-> 2025.
5167dab99 WIP: Carddav
6c1daac93 WIP: Carddav
0d7a81f91 WIP: Carddav
dc3936193 WIP: Carddav (Thunderbird funciona, solo lectura, incluyendo imágenes etc.)
caee35750 WIP: Carddav
2ad0cfe66 WIP: Carddav