#1865: CarddavTestClient.kt

Esta es una herramienta de depuración de desarrollo, no una prueba unitaria. Tiene un punto de entrada main() y actúa como un cliente CardDAV independiente para probar la implementación del servidor. El archivo contiene código extensamente comentado que muestra la evolución de las pruebas del protocolo CardDAV.

Importaciones y dependencias

Estructura de la clase: CardDavTestClient

Parámetros del constructor

• baseUrl: String — URL base del servidor (predeterminado: http://localhost:8080/carddav)
• username: String — Nombre de usuario CardDAV para autenticación básica
• password: String — Contraseña CardDAV (token DAV)
• lastSyncToken: String? — Token de sincronización opcional para pruebas de sincronización incremental

Clase interna: ResponseData

Clase de datos simple que contiene content: String, status: Int y headers: String de las respuestas HTTP.

Autenticación

Utiliza Autenticación Básica HTTP con el encabezado Authorization: Basic {base64(usuario:contraseña)}, construido una vez al inicializar.

Manejador de respuestas

Un HttpClientResponseHandler funcional que lee la entidad de respuesta como texto UTF-8 y extrae el código de estado y los encabezados.

Métodos clave

run() — Secuencia de prueba predeterminada

Ejecuta un flujo de protocolo CardDAV: OPTIONS → GET (VCard) → GET (foto). La mayor parte del código de prueba original (PROPFIND, REPORT, sync-collection) está comentado, con ejemplos del cuerpo de la solicitud XML conservados como referencia.

fetchAllVCards() — Exportación por lotes de VCard

Obtiene todas las VCard del servidor utilizando una solicitud REPORT de addressbook-query de CardDAV, guarda cada VCard en /tmp/carddav-vcards/ y analiza las entradas PHOTO. Reporta estadísticas sobre:

• Referencias URL JPEG/PNG/GIF vs imágenes base64 incrustadas
• Contactos sin foto
• Conteo de errores

Este método fue fundamental para depurar el manejo de fotos CardDAV (modos URL vs incrustado).

sendRequest() — Solicitud HTTP genérica

Construye y ejecuta solicitudes HTTP con método, ruta, cuerpo, autenticación y registro configurables. Utiliza ClassicRequestBuilder de Apache HttpClient 5.

analyzePhoto(vcard) — Analizador de propiedad PHOTO

Analiza datos VCard para determinar el modo de codificación de la foto:

• Modo URL: PHOTO;VALUE=URI:https://... — foto servida a través de URL
• Modo incrustado: PHOTO;ENCODING=b;TYPE=JPEG:datosbase64... o data:image/jpeg;base64,...

Función principal — Interfaz de línea de comandos

Uso: CardDavTestClient <usuario> <token-dav> [--fetch-all]
  --fetch-all: Obtener todas las VCard del servidor y guardarlas en /tmp/carddav-vcards/

Argumentos posicionales: usuario, token DAV, URL base opcional, token de sincronización opcional.

Solicitud con method=OPTIONS para Milton (uri=/users/usuario/, session-id=null)
Autenticación básica fallida, encabezado 'authorization' no encontrado.
Llamada PROPFIND detectada: /users/usuario/
PROPFIND para Milton (uri=/users/usuario/addressBooks/default/
REPORT para Milton (uri=/users/usuario/addressBooks/default/